# AMM Distro API

> Deliver releases and catalog transfers to AMM Distro from your own systems, and check where each release is.

- [Introduction](https://developer.ammdistro.com/index.md): Send releases and catalog transfers to AMM Distro from your own systems.
- [Getting access](https://developer.ammdistro.com/getting-access.md): API access is turned on per account. Your account's admins then create the keys.
- [Quickstart](https://developer.ammdistro.com/quickstart.md): Send, check and submit a first release with curl.
- [Authentication](https://developer.ammdistro.com/authentication.md): Send your API key as a bearer token on every request.
- [Accounts](https://developer.ammdistro.com/accounts.md): Which accounts a key can deliver to, and how to choose one.
- [Sending a release](https://developer.ammdistro.com/guides/sending-a-release.md): One PUT request describes the whole release.
- [Artists](https://developer.ammdistro.com/guides/artists.md): Primary and featured artists, store profiles and legal names.
- [Tracks](https://developer.ammdistro.com/guides/tracks.md): Order, identifiers, explicit content and lyrics for each track.
- [Credits](https://developer.ammdistro.com/guides/credits.md): Songwriters, performers and production credits, and songwriting shares.
- [Files](https://developer.ammdistro.com/guides/files.md): Send artwork and audio as URLs we download, or upload them yourself.
- [Validating and submitting](https://developer.ammdistro.com/guides/validating-and-submitting.md): Check what would block submission, then send the release to review.
- [Updating a release](https://developer.ammdistro.com/guides/updating-a-release.md): Send the release again with the same ID to change it.
- [Catalog transfers](https://developer.ammdistro.com/guides/catalog-transfers.md): Move releases that are already in stores from another distributor to AMM Distro.
- [Transfer checklist](https://developer.ammdistro.com/guides/transfer-checklist.md): What to gather and in what order, for a smooth catalog move.
- [Release status](https://developer.ammdistro.com/guides/release-status.md): Follow a release from draft to live.
- [Store links](https://developer.ammdistro.com/guides/store-links.md): Links to the release in each store, as it goes live.
- [Ingestion check](https://developer.ammdistro.com/guides/ingestion-check.md): Look up whether a UPC or ISRC is in AMM Distro, and how far along it is.
- [Statuses](https://developer.ammdistro.com/reference/statuses.md): Every status a release, file or transfer can have.
- [File requirements](https://developer.ammdistro.com/reference/file-requirements.md): What artwork and audio files must be.
- [Identifiers](https://developer.ammdistro.com/reference/identifiers.md): Your IDs, UPCs, ISRCs and the other codes the API accepts.
- [Errors](https://developer.ammdistro.com/reference/errors.md): Every error code the API returns, and what to do about it.
- [Rate limits](https://developer.ammdistro.com/reference/rate-limits.md): How many requests a key can make.
- [API reference](https://developer.ammdistro.com/api-reference/introduction.md): Every endpoint, with request and response shapes and a playground.
- [List accounts](https://developer.ammdistro.com/api-reference/accounts/list-accounts.md): The accounts this key can deliver to: those it covers that have API access turned on.
- [Create or update a release](https://developer.ammdistro.com/api-reference/releases/create-or-update-a-release.md): Send the whole release. The same `releaseId` updates the release instead of creating another; an identical body changes nothing (`changed: false`). Only drafts and releases with changes requested can be updated. Needs a key with `delivery:write`.
- [Get a release](https://developer.ammdistro.com/api-reference/releases/get-a-release.md): Status, identifiers, store links and each file's status.
- [List releases](https://developer.ammdistro.com/api-reference/releases/list-releases.md): Releases sent through the API, newest first.
- [Check readiness](https://developer.ammdistro.com/api-reference/releases/check-readiness.md): Everything that would stop the release from being submitted, plus warnings. Changes nothing; a read-only key is enough.
- [Submit for review](https://developer.ammdistro.com/api-reference/releases/submit-for-review.md): Sends the release to review. After this it can't be changed through the API unless review requests changes. Releases in a transfer are submitted with the transfer. Needs a key with `delivery:write`.
- [Get an upload URL](https://developer.ammdistro.com/api-reference/files/get-an-upload-url.md): For a file slot sent as `{ "upload": true }`. PUT the file to the returned URL with the returned headers, then call complete. Needs a key with `delivery:write`.
- [Complete an upload](https://developer.ammdistro.com/api-reference/files/complete-an-upload.md): Call after the PUT succeeds. The file is then checked like a downloaded one. Needs a key with `delivery:write`.
- [Create or update a transfer](https://developer.ammdistro.com/api-reference/catalog-transfers/create-or-update-a-transfer.md): Optional: a transfer is also created the first time a release names it in `transfer.batch`. Needs a key with `delivery:write`.
- [Get a transfer](https://developer.ammdistro.com/api-reference/catalog-transfers/get-a-transfer.md): The releases in the transfer and a count by status.
- [Submit a transfer](https://developer.ammdistro.com/api-reference/catalog-transfers/submit-a-transfer.md): Submits every release in the transfer at once. If any release isn't ready, nothing is submitted and `details` lists each release's problems. A submitted transfer is closed. Needs a key with `delivery:write`.
- [List genres](https://developer.ammdistro.com/api-reference/reference-data/list-genres.md)
- [List credit roles](https://developer.ammdistro.com/api-reference/reference-data/list-credit-roles.md): Roles by group. `songwriting: true` roles carry a share.
- [Look up UPCs and ISRCs](https://developer.ammdistro.com/api-reference/ingestion-check/look-up-upcs-and-isrcs.md): Whether releases (by UPC) or recordings (by ISRC) are in AMM Distro, and how far along. Needs `ingestion:read`. Up to 50 identifiers; unknown ones come back with `found: false`.
- [Look up UPCs and ISRCs (batch)](https://developer.ammdistro.com/api-reference/ingestion-check/look-up-upcs-and-isrcs-batch.md): Same as GET, with a JSON body.
- [Changelog](https://developer.ammdistro.com/changelog.md): Changes to the AMM Distro API.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


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