Skip to main content
The Musique API implements rate limiting to ensure fair usage and maintain service stability for all partners.

Default Limits

Higher limits are available for Enterprise partners. Contact support@musique.app to discuss your needs.

Rate Limit Headers

All API responses include rate limit information in the headers:

Exceeded Limits

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response:
The response also includes a Retry-After header indicating when you can retry.

Handling Rate Limits


Best Practices

Implement Backoff

Use exponential backoff when retrying failed requests. Start with 1 second and double each retry.

Monitor Usage

Track your rate limit consumption via the /api/integration/limits endpoint and headers.

Cache Responses

Cache GET responses where appropriate to reduce API calls. Audio metadata rarely changes.

Batch Operations

Use broadcast sends to multiple locations in a single request instead of individual calls.

Check Your Limits

Use the Rate Limits endpoint to check your current usage:
Response: