# WasaWasa Distribution API

> Partner API for aggregators and distributors: deliver a release (DDEX ERN 3.8.2 or JSON), then read catalog, listening stats, and money. Documentation is public. Keys are created in the distribution portal. Do not call the documentation host as an API.

This file follows the llms.txt convention. Fetch the full integration brief and the OpenAPI spec before writing code.

## Agent instructions

- Read https://developer.wasawasamusic.com/llms-full.txt and https://developer.wasawasamusic.com/distribution-openapi.yaml.
- API gateway: https://gateway.wasawasamusic.com/v1
- Auth: headers x-api-key and x-api-secret together. Never Authorization Bearer.
- Secrets stay in environment variables. Never invent endpoints.
- Start here: https://developer.wasawasamusic.com/developers/guides/ai-onboarding

## Machine-readable

- [Full integration brief](https://developer.wasawasamusic.com/llms-full.txt): rules, auth, DDEX vs JSON, artist matching, identifiers
- [OpenAPI 3](https://developer.wasawasamusic.com/distribution-openapi.yaml): paths, schemas, error codes
- [Create API keys](https://distribution.wasawasamusic.com): distribution portal

## Start here

- [Introduction](https://developer.wasawasamusic.com/developers): How delivery, catalog, and auth work
- [Integrate with AI](https://developer.wasawasamusic.com/developers/guides/ai-onboarding): Claude Code, ChatGPT, Cursor
- [DDEX ingest](https://developer.wasawasamusic.com/developers/publish/ddex-ingest): Send an ERN 3.8.2 message
- [Publish JSON](https://developer.wasawasamusic.com/developers/publish/album): JSON publish for a full release
- [Authentication](https://developer.wasawasamusic.com/developers/guides/authentication)

## First send

- [Quick start](https://developer.wasawasamusic.com/developers/guides/quick-start)
- [Upload files](https://developer.wasawasamusic.com/developers/publish/upload): Cover and audio for REST publish
- [Publish a single or EP](https://developer.wasawasamusic.com/developers/publish/single)
- [Release status](https://developer.wasawasamusic.com/developers/publish/status)

## Setup

- [Partner onboarding](https://developer.wasawasamusic.com/developers/guides/partner-onboarding)
- [Request API access](https://developer.wasawasamusic.com/developers/guides/request-access)
- [Distributor labels](https://developer.wasawasamusic.com/developers/guides/distributor-labels)
- [Best practices](https://developer.wasawasamusic.com/developers/guides/best-practices)
- [Integration examples](https://developer.wasawasamusic.com/developers/guides/integration)

## Identity

- [Find an artist](https://developer.wasawasamusic.com/developers/identity/resolve)
- [ISNI](https://developer.wasawasamusic.com/developers/identity/isni)

## Catalog

- [Partner catalog](https://developer.wasawasamusic.com/developers/publish/releases)
- [Albums, titles, and labels](https://developer.wasawasamusic.com/developers/publish/albums)
- [Artist search](https://developer.wasawasamusic.com/developers/publish/artist-search)
- [Artist lookup](https://developer.wasawasamusic.com/developers/publish/artist-lookup)
- [Check email](https://developer.wasawasamusic.com/developers/publish/check-email)
- [Countries](https://developer.wasawasamusic.com/developers/publish/countries)
- [ISRC lookup](https://developer.wasawasamusic.com/developers/publish/isrc)
- [Rights holders](https://developer.wasawasamusic.com/developers/publish/rights)
- [Licenses](https://developer.wasawasamusic.com/developers/publish/licenses)

## Analytics

- [Overview](https://developer.wasawasamusic.com/developers/analytics/overview)
- [Album metrics](https://developer.wasawasamusic.com/developers/analytics/album)
- [Title metrics](https://developer.wasawasamusic.com/developers/analytics/track)
- [Listeners](https://developer.wasawasamusic.com/developers/analytics/listeners)
- [Countries and devices](https://developer.wasawasamusic.com/developers/analytics/geo)

## Revenue

- [Revenue](https://developer.wasawasamusic.com/developers/revenue)
- [Reports](https://developer.wasawasamusic.com/developers/reports)
- [Royalties](https://developer.wasawasamusic.com/developers/royalties)

## Reference

- [Rate limits](https://developer.wasawasamusic.com/developers/reference/rate-limits)
- [Error codes](https://developer.wasawasamusic.com/developers/reference/errors)
- [SDKs and tools](https://developer.wasawasamusic.com/developers/reference/sdks)

## Automation

- [Webhooks](https://developer.wasawasamusic.com/developers/webhooks)
- [Scheduled tasks](https://developer.wasawasamusic.com/developers/cron-jobs)