> ## 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.

# Get an accord

> GET /v2/accords/{slug} returns an accord, how many fragrances have it, and the top ones.

```http theme={null}
GET /v2/accords/{slug}
```

The response is `{ "data": { "slug": "...", "name": "...", "fragranceCount": 0, "topFragrances": [ ... ] } }`.

| | |
| - | - |
| Price | $0.005 a call. A `304 Not Modified` costs $0.0025. |
| Cache for up to | Your plan's catalogue window: 24 hours on Free, 3 days on Pro and Pay as you go, 7 days on Starter, 14 days on Growth, 30 days on Scale, and by contract on Enterprise (30 days if the contract does not say) |
| Plans | All plans |

## Parameters

**slug** `string` *required*

Accord slug, for example `woody`.

**limit** `integer` (default: 10)

How many top fragrances to include, 1 to 20.

```bash theme={null}
curl "https://api.noteboxd.com/v2/accords/woody"   -H "Authorization: Bearer $NOTEBOXD_API_KEY"
```

Top fragrances in the response count toward your distinct-fragrance quota.


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