Skip to main content
The Get Brand endpoint retrieves a single brand by its unique identifier, returning the brand’s full public profile. Unlike the list endpoint, this response includes the brand’s description and social_handles object — useful for rendering brand detail pages or attribution cards alongside product results.

​
Endpoint

GET https://api.blackhairapi.com/v1/brands/{brand_id}

​
Required header

HeaderValueDescription
X-API-Keybha_...Your Black Hair API key. All requests must include this header.
Requests without a valid X-API-Key header return a 401 Unauthorized response. Keep your key secret and never expose it in client-side code.

​
Path parameters

​
brand_id
string (UUID)
required
The unique identifier of the brand to retrieve. Brand UUIDs are returned in the id field of the List Brands response or within the brand object on any product.

​
Response

A successful request returns HTTP 200 with a JSON object representing the brand’s full profile.
​
id
string (UUID)
The brand’s unique identifier.
​
name
string
The brand’s display name.
​
slug
string
A URL-safe identifier for the brand, derived from its name (e.g., "camille-rose").
​
origin_country
string
The country where the brand was founded or is headquartered (e.g., "US", "NG").
​
is_black_owned
boolean
Whether the brand is Black-owned.
​
website
string
The brand’s official website URL.
​
description
string
A text description of the brand, its mission, and its product philosophy.
​
social_handles
object
A JSON object containing the brand’s social media handles. Keys represent platform names and values are the handle or profile URL.
​
product_count
integer
The total number of products in the catalog associated with this brand.

​
Example

curl https://api.blackhairapi.com/v1/brands/c3d4e5f6-a7b8-9012-cdef-123456789012 \
  -H "X-API-Key: bha_your_api_key"
Example response 
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Camille Rose",
  "slug": "camille-rose",
  "origin_country": "US",
  "is_black_owned": true,
  "website": "https://camillerose.com",
  "description": "Camille Rose is a Black-owned hair and skin care brand founded by Janell Stephens in her kitchen in 2011. The brand uses natural, food-grade ingredients to create products specifically formulated for textured and natural hair.",
  "social_handles": {
    "instagram": "@camillerosenatural",
    "tiktok": "@camillerose",
    "youtube": "https://youtube.com/@CamilleRoseNaturals"
  },
  "product_count": 29
}

​
Error responses

StatusCodeDescription
401UnauthorizedThe X-API-Key header is missing or the key is invalid.
404Not FoundNo brand exists with the supplied brand_id.
429Too Many RequestsYou have exceeded your plan’s monthly request limit. Upgrade to continue.