Admin APIs

Get Brand By ID

GET /brands/{brandId}
Api key auth

Get a single brand by ID

Path parameters

  • brandId string(guid) Required

    Unique ID of the brand

Responses

  • 200 application/json

    A single brand

    Hide response attributes Show response attributes object
    • id string(guid)

      System generated unique identifier. Don't include this in POST request body.

    • handle string
    • title string
    • description string | null
    • created_at string(date-time)
    • updated_at string(date-time)
  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • error string

      401: Invalid Credentials

      404: Resource not found

      422: Unprocessable Entity

    • details string

      404: empty

      401: The credentials presented are not valid to access this resource
  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • error string

      401: Invalid Credentials

      404: Resource not found

      422: Unprocessable Entity

    • details string

      404: empty

      401: The credentials presented are not valid to access this resource
GET /brands/{brandId} 
curl \
 --request GET 'https://app.getfoundation.com/api/external/v1/brands/{brandId}' \
 --header "X-API-Key: $API_KEY"
Response examples (200) 
{
  "id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
  "handle": "acme-corp",
  "title": "Acme Corp",
  "description": "string",
  "logo": "https://acme-corp.com/logo.png",
  "created_at": "2025-05-04T09:42:00Z",
  "updated_at": "2025-05-04T09:42:00Z"
}
Response examples (401) 
{
  "error": "string",
  "details": "string"
}
Response examples (404) 
{
  "error": "string",
  "details": "string"
}