> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noteboxd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List a Brand's Full Fragrance Catalogue — Paginated

> GET /v1/brands/{slug}/fragrances — Browse the complete paginated fragrance catalogue for a specific brand, from flagship classics to limited editions. Costs 1¢ per call.

This endpoint returns the complete fragrance catalogue for a given brand, paginated for easy consumption. Unlike the `topFragrances` array on the brand profile, this listing is exhaustive — covering every fragrance Noteboxd has on record for that house, from flagship classics to limited editions. Use it to build brand catalogue pages, power autocomplete filters, or sync a brand's full inventory into your own database.

## Endpoint

```
GET /v1/brands/{slug}/fragrances
```

**Base URL:** `https://api.noteboxd.com`\
**Cost:** 1¢ per call\
**Authentication:** `Authorization: Bearer nb_live_YOUR_KEY`

## Path Parameters

<ParamField path="slug" type="string" required>
  The unique identifier for the brand. Obtain brand slugs from the universal search endpoint using `type=brand`. Example: `chanel`.
</ParamField>

## Query Parameters

<ParamField query="page" type="integer">
  The page of results to return. Defaults to `1`. Use in conjunction with `limit` to paginate through the full catalogue.
</ParamField>

<ParamField query="limit" type="integer">
  Number of fragrances to return per page. Defaults to `20`. Maximum `50`.
</ParamField>

## Example Request

```bash theme={null}
curl -G https://api.noteboxd.com/v1/brands/chanel/fragrances \
  -H "Authorization: Bearer nb_live_YOUR_KEY" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"
```

## Example Response

```json theme={null}
{
  "brand": "chanel",
  "data": [
    { "id": "chanel-no-5", "name": "No 5" },
    { "id": "chanel-chance", "name": "Chance" }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 148 }
}
```

<Tip>
  Check the `pagination.total` field in the response to calculate the number of pages you need to fetch. For example, a brand with 148 fragrances and a `limit` of 50 requires 3 pages (`ceil(148 / 50) = 3`).
</Tip>

## Rate Limiting

Every response includes the following headers to help you track your usage:

| Header | Description |
| - | - |
| `X-RateLimit-Limit` | Total requests allowed in the current window |
| `X-RateLimit-Remaining` | Requests remaining before you hit the limit |
| `X-RateLimit-Reset` | Unix timestamp when the window resets |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.