API Overview and Quickstart

Updated July 2026.

Yes — LabelGrid offers a public REST API for programmatic distribution. It lets developers read your catalog, create and update releases, upload assets, and submit releases for distribution, and it powers white-label services built on top of LabelGrid. This guide is the quickstart; full endpoint reference lives at api.labelgrid.com/docs/api.

Quickstart at a glance

Step	What you do
1. Activate an API plan	API and sandbox access require an active, paid API plan (billed annually).
2. Generate an API token	Open the avatar menu (top-right) and click API Tokens to create a Bearer token.
3. (Optional) Whitelist IPs	Restrict token use to known IPs under the same API Tokens area.
4. Read the reference	Explore endpoints and “try it” tooling at api.labelgrid.com/docs/api.
5. Build against sandbox	Request a sandbox from support, then test without touching production.
6. Go to production	Point your integration at api.labelgrid.com and create your first release.

What the API offers

The public API is mounted under /api/public/... on api.labelgrid.com and provides programmatic access to:

• Releases — list, create, update, delete; upload artwork; validate; submit for distribution
• Tracks — list, create, update; upload audio files; manage track licenses
• Labels — list and manage your label profiles
• Artists — list and manage artist profiles
• Writers and Contributors — list and manage writer/contributor profiles
• Publishers — list and manage publisher profiles
• Webhooks — register webhook endpoints for asynchronous notifications
• Reference data — genres, languages, contributor roles, instruments, distribution territories, distro outlets

Common use cases

• Automate release creation from your existing systems
• Sync catalogue data with your database
• Build custom dashboards and reporting tools
• Integrate with your existing workflow tools
• Power white-label distribution services on top of LabelGrid

---

Getting API access

To use the LabelGrid API, you need:

1. An active, paid API plan — API and sandbox access require a paid API plan. The 7-day free trial that comes with standard plans does not include API or sandbox access, and API plans are billed immediately (no trial period).
2. An API token generated from your account settings: open the avatar menu in the top-right and click API Tokens (only visible if API access is enabled)
3. (Optional) IP whitelisting for additional security — configure under the same area

If you do not see the API Tokens option in your account, contact support to discuss enabling API access on your plan.

---

Authentication

All API requests must include a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

---

API Documentation

For complete endpoint reference, request/response schemas, and live “try it” tooling, see the auto-generated documentation:

• Production: https://api.labelgrid.com/docs/api
• Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

The documentation includes:

• Authentication guide
• Every available endpoint with request and response examples
• Rate-limiting information
• Webhook configuration

---

Sandbox

LabelGrid offers a sandbox environment so you can build and test against the API without affecting your production catalogue. Sandbox access requires an active API plan and is provisioned by us on request — once your API plan is active, contact support to set one up. We configure sandbox IP whitelisting for you; production IP whitelisting is self-serve under API Tokens.

---

Webhooks

The public API supports webhooks for asynchronous event notification (review status changes, delivery updates, etc.). See Webhooks for setup and the available event types.

---

FAQ

”Does LabelGrid have a public API?”

Yes — LabelGrid offers a public REST API for programmatic distribution, mounted under /api/public/... on api.labelgrid.com. You can read your catalog, create and update releases, upload audio and artwork, manage artists and contributors, register webhooks, and submit releases for distribution. Full documentation is at api.labelgrid.com/docs/api.

”How do I get API access?”

API and sandbox access require an active, paid API plan. Once your API plan is active, generate an API token from your account settings under API Tokens (in the top-right avatar menu). If you do not see that option, contact support to enable API access. The 7-day free trial on standard plans does not include API access.

”How do I authenticate API requests?”

Include a Bearer token in the Authorization header of every request: Authorization: Bearer YOUR_API_TOKEN. Generate the token under API Tokens in your account settings, and optionally restrict it by IP whitelisting.

”Is there a sandbox environment for testing?”

Yes. LabelGrid provides a sandbox so you can build and test against the API without affecting your production catalog. Sandbox access requires an active API plan and is provisioned on request — contact support once your API plan is active. Sandbox docs are at api-sandbox.stg.labelgrid.com/docs/api.

”What does the LabelGrid API cost?”

The API is available on LabelGrid’s API plans, which are billed annually. The Starter API plan is $1,428 USD per year, billed annually, with higher tiers for larger catalogs and higher royalty-processing limits. See the pricing page for current details.

---

Related

Building on the LabelGrid API? See the developer hub for an overview of what’s possible. If you’re powering a white-label distribution service on top of LabelGrid, the infrastructure for distributors page covers the bigger picture. See also the White-Label Distribution Setup guide.

---

Need Help?

If you need API assistance, contact our support team with technical details about your integration.