curl -X GET "https://api.submagic.co/v1/brand-kits/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "x-api-key: sk-your-api-key-here"
const getBrandKit = async (brandKitId) => {
const response = await fetch(
`https://api.submagic.co/v1/brand-kits/${brandKitId}`,
{
headers: {
"x-api-key": "sk-your-api-key-here",
},
}
);
return response.json();
};
const brandKit = await getBrandKit("7c9e6679-7425-40de-944b-e07fc1f90ae7");
import requests
def get_brand_kit(brand_kit_id):
url = f'https://api.submagic.co/v1/brand-kits/{brand_kit_id}'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kit = get_brand_kit('7c9e6679-7425-40de-944b-e07fc1f90ae7')
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true,
"colors": [
{ "name": "Primary", "hex": "#FF3366" },
{ "name": "Ink", "hex": "#111111" }
],
"fonts": [
{ "family": "Montserrat", "weights": [400, 700] },
{ "family": "Inter", "weights": [400] }
],
"logos": [
{
"name": "Wordmark",
"url": "https://cdn.example.com/logo.png",
"width": 640,
"height": 160
}
]
}
{
"error": "NOT_FOUND",
"message": "Brand kit not found"
}
{
"error": "VALIDATION_ERROR",
"message": "id must be a valid UUID"
}
API Reference
Get Brand Kit
Retrieve a brand kit’s colors, fonts and logos
GET
/
v1
/
brand-kits
/
{id}
curl -X GET "https://api.submagic.co/v1/brand-kits/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "x-api-key: sk-your-api-key-here"
const getBrandKit = async (brandKitId) => {
const response = await fetch(
`https://api.submagic.co/v1/brand-kits/${brandKitId}`,
{
headers: {
"x-api-key": "sk-your-api-key-here",
},
}
);
return response.json();
};
const brandKit = await getBrandKit("7c9e6679-7425-40de-944b-e07fc1f90ae7");
import requests
def get_brand_kit(brand_kit_id):
url = f'https://api.submagic.co/v1/brand-kits/{brand_kit_id}'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kit = get_brand_kit('7c9e6679-7425-40de-944b-e07fc1f90ae7')
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true,
"colors": [
{ "name": "Primary", "hex": "#FF3366" },
{ "name": "Ink", "hex": "#111111" }
],
"fonts": [
{ "family": "Montserrat", "weights": [400, 700] },
{ "family": "Inter", "weights": [400] }
],
"logos": [
{
"name": "Wordmark",
"url": "https://cdn.example.com/logo.png",
"width": 640,
"height": 160
}
]
}
{
"error": "NOT_FOUND",
"message": "Brand kit not found"
}
{
"error": "VALIDATION_ERROR",
"message": "id must be a valid UUID"
}
Get Brand Kit
Retrieve one of your brand kits: its colors, font families and logo links. Get its ID from List Brand Kits.This endpoint requires authentication and has a rate limit of 1000 requests
per hour. It does not use API credits.
Authentication
Path Parameters
Response
curl -X GET "https://api.submagic.co/v1/brand-kits/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "x-api-key: sk-your-api-key-here"
const getBrandKit = async (brandKitId) => {
const response = await fetch(
`https://api.submagic.co/v1/brand-kits/${brandKitId}`,
{
headers: {
"x-api-key": "sk-your-api-key-here",
},
}
);
return response.json();
};
const brandKit = await getBrandKit("7c9e6679-7425-40de-944b-e07fc1f90ae7");
import requests
def get_brand_kit(brand_kit_id):
url = f'https://api.submagic.co/v1/brand-kits/{brand_kit_id}'
headers = {
'x-api-key': 'sk-your-api-key-here'
}
response = requests.get(url, headers=headers)
return response.json()
brand_kit = get_brand_kit('7c9e6679-7425-40de-944b-e07fc1f90ae7')
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Acme",
"isDefault": true,
"colors": [
{ "name": "Primary", "hex": "#FF3366" },
{ "name": "Ink", "hex": "#111111" }
],
"fonts": [
{ "family": "Montserrat", "weights": [400, 700] },
{ "family": "Inter", "weights": [400] }
],
"logos": [
{
"name": "Wordmark",
"url": "https://cdn.example.com/logo.png",
"width": 640,
"height": 160
}
]
}
{
"error": "NOT_FOUND",
"message": "Brand kit not found"
}
{
"error": "VALIDATION_ERROR",
"message": "id must be a valid UUID"
}
A brand kit that does not exist, belongs to another account, or is on a plan
without brand kits returns
404.
