Skip to main content

Usage

The /usage endpoint provides an easy way to track your API usage. It returns a summary of jobs posted and the total minutes of audio processed for your account over the last three months.

Example Request:

curl -X 'POST' \
'https://groovy.audioshake.ai/usage' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

Usage Response

The response contains your clientId and the last three months of usage records, including the number of jobs processed and the total duration of processed audio in minutes for each month.

Example Response:

{
"clientId": "<your_client_id>",
"usage": [
{
"month": "2025-02",
"totalJobs": 15,
"totalMinutes": 21.3115
},
{
"month": "2025-01",
"totalJobs": 81,
"totalMinutes": 91.6818
},
{
"month": "2024-12",
"totalJobs": 10,
"totalMinutes": 40.2578
}
]
}
ElementDescription
clientIdYour unique client identifier.
usageA list of monthly usage records.
monthThe month of usage (YYYY-MM).
totalJobsThe number of jobs processed in the given month.
totalMinutesThe total duration of processed audio in minutes.