Skip to main content
GET
/
v1
/
usage
Get usage statistics
curl --request GET \
  --url 'https://api.debounce.io/v1/usage/?api='
{
  "debounce": {
    "api": "YOUR API KEY",
    "start": "24-01-01",
    "end": "24-12-31",
    "calls": "100"
  },
  "success": "1"
}

Documentation Index

Fetch the complete documentation index at: https://developers.debounce.com/llms.txt

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

The Usage History endpoint returns your validation activity for a specified date range.
This allows you to track how many credits were consumed on each day.

​
Date Requirements

When specifying dates for this endpoint:
  • Use the YY-MM-DD format (two digits for year, month, and day).
  • The earliest allowed start date is 20-08-14.
  • The end date cannot be later than today’s date.
Requests that do not follow these rules will return an error.

​
Usage

Provide a start and end date in the query parameters to retrieve daily usage within that range. Example: 
/v1/usage/?start=24-01-01&end=24-01-31&api=YOUR_API_KEY
This returns the number of validations performed on each day of the selected period.

Authorizations

​
api
string
query
required

API key for authentication

Query Parameters

​
api
string
required

Your DeBounce API key

​
start
string
required

Start date. Must be after 20-08-14 (YY-MM-DD)

Pattern: ^\d{2}-\d{2}-\d{2}$
Example:

"24-01-01"

​
end
string
required

End date. Equal or less than today's date (YY-MM-DD)

Pattern: ^\d{2}-\d{2}-\d{2}$
Example:

"24-12-31"

Response

200 - application/json

Usage history retrieved successfully

​
success
enum<string>
required

Whether the request was successful

Available options:
0,
1
​
debounce
object