# Brands

Brands represent distinct brand identities within your organization. Each brand can have its own help center and email sending address. Use this endpoint to list and retrieve brand information.

## List all brands

 - [GET /v2/brands](https://docs.featurebase.app/rest-api/brands/listbrands.md): Returns all brands in your organization with cursor-based pagination.

### Query Parameters

- limit - Number of brands to return (1-100, default: 10)
- cursor - Opaque cursor from a previous response for pagination

### Response Structure

The response includes:
- object - Always "list"
- data - Array of brand objects
- nextCursor - Cursor for the next page (null if no more results)

### Brand Object

Each brand includes:
- id - Featurebase internal ID (MongoDB ObjectId)
- 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": "list",
  "data": [
    {
      "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"
    }
  ],
  "nextCursor": null
}


### Version Availability

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

## Get brand by ID

 - [GET /v2/brands/{id}](https://docs.featurebase.app/rest-api/brands/getbrandbyid.md): 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.