Usage Endpoint
Retrieve current API usage statistics for your API key
The Usage endpoint returns real-time usage statistics for your authenticated API key, including daily and monthly request counts, rate limits, and your current subscription plan.
https://api.allnewsapi.com/usageQuery Parameters
Name | Type | Default Value | Description |
|---|---|---|---|
apikeyRequired | string | — | Your API key for authentication. Get your API key from the dashboard |
Response
The API returns a JSON object containing your current usage statistics.
Name | Type | Default Value | Description |
|---|---|---|---|
workspaceId | string | — | The identifier of the workspace the API key belongs to |
workspaceName | string | — | The display name of the workspace the API key belongs to |
plan | string | — | Your current subscription tier (free, starter, pro, business, enterprise) |
requestsUsed24Hours | integer | — | The number of API requests made in the current 24-hour window |
requestsLimit24Hours | integer | — | The maximum number of requests allowed per day on your current plan |
requestsRemaining24Hours | integer | — | The number of requests remaining before hitting the daily limit |
requestsUsed30Days | integer | — | The number of API requests made in the current calendar month. This counter resets on the 1st of each month (the JSON field name remains requestsUsed30Days for backward compatibility) |
overageEnabled | boolean | — | Whether overage billing is enabled for the workspace |
overageRequests24Hours | integer | — | The number of requests served via overage in the current 24-hour window (0 when overage is disabled) |
Example Response
Example Request
Errors
| Status | Condition |
|---|---|
401 | Invalid or unknown API key |
403 | The API key is disabled |
422 | The apikey parameter is missing from the request |