Documentation menu

Account

API reference

GET /usage

Retrieve usage

Parameters

query

daysinteger
How far back to look.

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
    }
  ]
}

The rest of usage.

Next

GET /credit

Retrieve credit balance