Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wavmaker.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Accessing the API

To use the WavMaker API, you’ll need to generate an API key in the account dashboard.
Screenshot showing how to generate an API key in the WavMaker dashboard
If you don’t see the API Keys tab on your account dashboard, it may be because you’re account has not yet been approved for API access. Please contact support@wavmaker.com to get your account approved.

​
Authentication

All API requests must be authenticated using a Bearer token. Include your API token in the Authorization header of every request: 
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://api.wavmaker.com/songs
If your token is missing or invalid, you’ll receive a 401 Unauthorized error.

​
Rate Limit

The WavMaker API has a rate limit of 25 requests per second. If you exceed the rate limit, you will receive a 429 error.

​
Pagination

For all endpoints that return a list of results, pagination is supported. Query Parameters:
  • page (integer): Which page of results to return (default: 1)
  • limit (integer): Number of results per page (default: 20, max: 100)
Response Fields: 
{
  "page": 1,
  "pages": 5,
  "page_size": 20,
  "total": 100,
  "hits": [ ... ]
}

​
Making Your First API Request

  1. Choose the API endpoint you want to use
  2. Generate your API Key in the dashboard
  3. Use your favorite HTTP client to make a request. Example:
curl -X GET "https://wavmaker.com/api/v1/songs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"