Users

Get a monthly statement

One of this account's monthly statements, with its lines and total. Another account's statement answers 404.

get/v1/users/me/statements/{statement_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/users/me/statements/{statement_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

statement_idstring required

The statement's ID (stm_ prefix).

Response

The statement.

idstring required
cyclestring required

The billing month, YYYY-MM in UTC.

period_fromstring date-time required
period_tostring date-time required

Exclusive.

total_usdnumber required

What is owed, after anything prepaid.

payment_status'unpaid' | 'processing' | 'paid' | 'failed' | 'nothing_due' required

Collection on the saved card. unpaid until a charge starts — within an hour of the statement, once a card is saved. failed moves the account to Free when the month ends.

created_atstring date-time required

Example response

{
  "id": "stm_V1StGXR8Z5jdHi6B",
  "cycle": "2026-10",
  "runs": {
    "used": 30000,
    "limit": 25000
  },
  "lines": [
    {
      "description": "Pro plan, 2026-10-01 to 2026-10-31",
      "quantity": 1,
      "unit_price_usd": 49,
      "amount_usd": 49
    }
  ],
  "total_usd": 59
}

Changes

No recorded changes to this operation across all 1 revision of this API.