Usage and statements

List statements

GET/api/v1/statements

The monthly statements of the key's organization, newest first. A statement is a document: it is issued on the 1st for the month before, due 15 days later, and never changes; nothing is collected. A month is closed once it has ended. A test key sees test activity only: it is never priced, and a test key sees no statements.

Needs a key with read permission.

Request

Query parameters

Query parameters
Name	Type	Required	Description
limit	integer	optional	How many items to return, from 1 to 100. Default 25.At least 1.At most 100.
cursor	string	optional	The next_cursor of the previous page, to get the page after it. Opaque: pass it back unchanged.

Response

A page of statements. Status 200.

Response fields
Name	Type	Description
data	array of object
data[].id	string	An ID that starts with stm_.
data[].object	string	Always `statement`.
data[].number	string
data[].issue_date	string (date)
data[].due_date	string (date)	15 days after the issue date.
data[].month	string	Matches `^\d{4}-\d{2}$`.
data[].fees	string	Matches `^\d+\.\d{2}$`.
data[].adjustments_amount	string	Matches `^\d+\.\d{2}$`.
data[].amount_due	string	Matches `^\d+\.\d{2}$`.
next_cursor	value	Pass as cursor to get the next page; null when there is no next page.

Errors

Errors
HTTP status	Code	What it means
401	UNAUTHORIZED	A valid API key is required. Send it as "Authorization: Bearer <key>".
403	PERMISSION_DENIED	This API key is not allowed to do that.
422	INVALID_REQUEST	The request is not valid.
504	TIMEOUT	The request took too long to finish. It may still have taken effect: look it up before sending it again with a new Idempotency-Key. What it made is found with GET /api/v1/eligibility?request_id=<this request_id>, and the same filter on /api/v1/claims and /api/v1/attachments (a key with read permission).
500	INTERNAL	Something went wrong on our side. Quote the request ID if you contact us.

Example

Example request

Shell

curl "https://sandbox.myclaimhouse.com/api/v1/statements?limit=12" \
  -H "Authorization: Bearer $CLAIMHOUSE_KEY"

Example response: 200

JSON

{
  "data": [
    {
      "id": "stm_01JM000000E008000000000030",
      "object": "statement",
      "number": "ST-202609-0195000000A1",
      "issue_date": "2026-10-01",
      "due_date": "2026-10-16",
      "month": "2026-09",
      "fees": "1028.50",
      "adjustments_amount": "0.00",
      "amount_due": "1028.50"
    }
  ],
  "next_cursor": null
}