Skip to main content
The API is currently in beta and subject to change. FMDB is a non-commercial, privacy-first platform.

Base URL

All endpoints are served from the production host:

Authentication

Authentication is required for all endpoints unless stated otherwise. The API uses bearer tokens.

Obtaining an access token

1

Register an account

Sign up at www.fmdb.net. API access uses the same account as the website.
2

Open your settings

Once signed in, go to your account settings and find the API Access Tokens section.
3

Create a token

Generate a token there and store it somewhere safe — treat it like a password.

Using the token

Send the token in the Authorization header on every request:

Content type

The API follows the JSON:API conventions. Requests and responses use the application/vnd.api+json media type.

What you can access

Catalog

Releases, release formats, tracks, recordings, and packaging types.

Productions

Films and other productions, their entries and recordings.

People and companies

Artists, aliases, group memberships, roles, labels, and organizations.

Your account

Personal collection and wishlist items.
Use the Endpoints section in the sidebar to browse the full reference and try requests directly from the playground.