# Get brand by 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

json
{
  "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.

Endpoint: GET /v2/brands/{id}
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    The Featurebase internal ID of the brand (MongoDB ObjectId)
    Example: "507f1f77bcf86cd799439011"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "brand"

  - `id` (string, required)
    Featurebase internal ID
    Example: "507f1f77bcf86cd799439011"

  - `name` (string, required)
    Brand display name
    Example: "Default Brand"

  - `isDefault` (boolean, required)
    Whether this is the default brand
    Example: true

  - `createdAt` (string,null, required)
    ISO date when brand was created
    Example: "2025-01-01T12:00:00.000Z"

  - `updatedAt` (string,null, required)
    ISO date when brand was last updated
    Example: "2025-01-10T15:30:00.000Z"

  - `helpCenterId` (string,null, required)
    The ID of the help center associated with this brand
    Example: "11"

  - `senderEmailAddressId` (string,null, required)
    The ID of the default sending email address for this brand
    Example: "507f1f77bcf86cd799439012"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "brand_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404