List requests · API reference

A page of requests to the /v1 routes, newest first, each with who made it, what it cost and how it was answered.

GET /v1/me is not listed, and neither is a request refused before its credential was accepted. The totals on GET /usage are sums of these.

Parameters

query

request_idstring | null: A request id, from the request-id response header. Only that request.
routestring[]: A route template, such as /v1/parcel. Repeatable.
keystring | null: An API key id. Only requests made with that key.
userstring | null: A user id. Only requests that user made, directly or through an OAuth client.
clientstring | null: An OAuth client id. Only requests that came through it.
actor_method"session" | "api_key" | "oauth" | "mcp"[]: How the request authenticated. One of session, api_key, oauth or mcp. Repeatable.
errorboolean | null: True for requests answered with a status of 400 or more, false for the rest.
min_occurredstring | null: Arrived at or after this instant, in ISO 8601.
max_occurredstring | null: Arrived before this instant, in ISO 8601.
cursorstring | null: The previous page's next_cursor.
sizeinteger | null: Default 25.

Responses

200: Collection_Request_; Successful Response
403: empty; api_key_not_accepted: sent with an API key. Requests are listed in the console and through the MCP server.
422: ProblemDetail; The request can't be answered as sent. The code says why.

Example request

curl -G 'https://api.placestack.com/usage/request' \
  --data-urlencode 'size=50' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "request",
      "request_id": "string",
      "occurred_at": "2026-09-13T12:00:00Z",
      "method": "<Method>",
      "route": "<Route>",
      "status": 1,
      "credits": 1,
      "free_reason": "cached",
      "duration_ms": 1,
      "actor": "<RequestActor>"
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "suppressed": 0,
  "total": {
    "value": 1,
    "relation": "eq"
  }
}