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

# Introduction

> The FMDB API provides access to a comprehensive film music database, covering releases, productions, artists, and recordings.

<Note>
  The API is currently in **beta** and subject to change. FMDB is a non-commercial,
  privacy-first platform.
</Note>

## Base URL

All endpoints are served from the production host:

```
https://www.fmdb.net
```

## Authentication

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

### Obtaining an access token

<Steps>
  <Step title="Register an account">
    Sign up at [www.fmdb.net](https://www.fmdb.net). API access uses the same
    account as the website.
  </Step>

  <Step title="Open your settings">
    Once signed in, go to your account settings and find the
    **API Access Tokens** section.
  </Step>

  <Step title="Create a token">
    Generate a token there and store it somewhere safe — treat it like a
    password.
  </Step>
</Steps>

### Using the token

Send the token in the `Authorization` header on every request:

```http theme={null}
Authorization: Bearer <token>
```

## Content type

The API follows the [JSON:API](https://jsonapi.org) conventions. Requests and
responses use the `application/vnd.api+json` media type.

```bash theme={null}
curl https://www.fmdb.net/api/artists \
  -H "Authorization: Bearer <token>" \
  -H "Accept: application/vnd.api+json"
```

## What you can access

<CardGroup cols={2}>
  <Card title="Catalog" icon="compact-disc">
    Releases, release formats, tracks, recordings, and packaging types.
  </Card>

  <Card title="Productions" icon="film">
    Films and other productions, their entries and recordings.
  </Card>

  <Card title="People and companies" icon="users">
    Artists, aliases, group memberships, roles, labels, and organizations.
  </Card>

  <Card title="Your account" icon="bookmark">
    Personal collection and wishlist items.
  </Card>
</CardGroup>

Use the **Endpoints** section in the sidebar to browse the full reference and try
requests directly from the playground.