Get brand by ID

GET/v2/brands/{id}

Retrieves a single brand by its Featurebase ID.

Path Parameters

id - The Featurebase internal ID of the brand (MongoDB ObjectId)

Response

Returns a brand object with:

id - Featurebase internal ID
name - Brand display name
isDefault - Whether this is the default brand
createdAt - Creation timestamp
updatedAt - Last update timestamp
helpCenterId - Associated help center ID
senderEmailAddressId - Default sender email address ID

Example Response

{
  "object": "brand",
  "id": "507f1f77bcf86cd799439011",
  "name": "Default Brand",
  "isDefault": true,
  "createdAt": "2025-01-01T12:00:00.000Z",
  "updatedAt": "2025-01-10T15:30:00.000Z",
  "helpCenterId": "11",
  "senderEmailAddressId": "507f1f77bcf86cd799439012"
}

Error Responses

404 Not Found - Brand with the specified ID does not exist

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Path ParametersExpand Collapse

id: string

The Featurebase internal ID of the brand (MongoDB ObjectId)

Header ParametersExpand Collapse

"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"

One of the following:

"2026-01-01.nova"

"2025-12-12.clover"

ReturnsExpand Collapse

Brand object { id, createdAt, helpCenterId, 5 more }

id: string

Featurebase internal ID

createdAt: string

ISO date when brand was created

helpCenterId: string

The ID of the help center associated with this brand

isDefault: boolean

Whether this is the default brand

name: string

Brand display name

object: "brand"

Object type identifier

senderEmailAddressId: string

The ID of the default sending email address for this brand

updatedAt: string

ISO date when brand was last updated

Get brand by ID

curl https://do.featurebase.app/v2/brands/$ID \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"

{
  "id": "507f1f77bcf86cd799439011",
  "createdAt": "2025-01-01T12:00:00.000Z",
  "helpCenterId": "11",
  "isDefault": true,
  "name": "Default Brand",
  "object": "brand",
  "senderEmailAddressId": "507f1f77bcf86cd799439012",
  "updatedAt": "2025-01-10T15:30:00.000Z"
}

Returns Examples

{
  "id": "507f1f77bcf86cd799439011",
  "createdAt": "2025-01-01T12:00:00.000Z",
  "helpCenterId": "11",
  "isDefault": true,
  "name": "Default Brand",
  "object": "brand",
  "senderEmailAddressId": "507f1f77bcf86cd799439012",
  "updatedAt": "2025-01-10T15:30:00.000Z"
}