Retrieve usage · API reference

Requests and credits for the window, day by day, by endpoint and by API key.

free_requests counts calls that cost nothing and were not errors, so requests and credits_spent do not move together.

Parameters

query

daysinteger: How many days back to include. Defaults to 30.

Responses

200: usage object; Successful Response
422: ProblemDetail; The request can't be answered as sent. The code says why.

Example request

curl -X GET 'https://api.placestack.com/usage' \
  -H 'Authorization: Bearer $PLACESTACK_API_KEY'

Example response

{
  "object": "usage_summary",
  "organization_id": "<Organization Id>",
  "since": "2026-09-13T12:00:00Z",
  "until": "2026-09-13T12:00:00Z",
  "requests": 1,
  "credits_spent": 1,
  "free_requests": 1,
  "credit_balance": 1,
  "included_credits": 1,
  "daily": [
    {
      "day": "2026-09-13T12:00:00Z",
      "requests": 1,
      "credits": 1
    }
  ],
  "by_endpoint": [
    {
      "name": "<Name>",
      "requests": 1,
      "credits": 1
    }
  ],
  "by_key": [
    {
      "name": "<Name>",
      "requests": 1,
      "credits": 1
    }
  ]
}