Brila API

The Brila API lets you manage your own Brila account programmatically — starting with discount codes, with more of the platform opening up over time.

Every endpoint acts on your own account only: you authenticate with a personal access token and can only read or write your own data, the same data you'd manage by hand in Settings.

What you can do today

• List, create, update, and delete your discount codes.

More resources will be added here as they're opened up on the public API.

Next steps

• Getting started — create a token and make your first request
• Authentication & scopes — how tokens and scopes work
• Errors — the error response format
• Rate limits — request limits per token
• API reference — every endpoint, generated from the OpenAPI spec

OpenAPI spec

The reference above is generated from a single OpenAPI document, which you can fetch yourself at https://brila.me/api/v1/openapi.json. It's public and needs no token, so you can import it straight into Postman, Insomnia, or a client generator. It's served by the API itself, so it always describes the version that's live.

Keeping your client in sync

Importing the spec copies it — your tool won't notice later changes. Postman, Insomnia and most generators fetch the URL once and keep a snapshot, so a newly added endpoint won't appear until you import again. Re-importing the same URL updates the existing collection rather than creating a second one.

A stale copy degrades gently: the /api/v1 prefix is the contract, so existing operations keep the shape you imported, and out of date mostly means missing what's new. If you'd rather not think about it, fetch the spec as part of your build instead of importing it by hand:

curl -s https://brila.me/api/v1/openapi.json -o openapi.json