List the account's monthly statements
What the account owes for each closed billing month, newest first: the subscription fee, prorated by the share of the month each plan was held, and runs past the allowance at the plan's overage rate, less what was paid at an upgrade. Overage is measured against the highest plan held that month.
A statement is written within an hour of the month closing, once, and never changes; payment_status follows its charge on the saved card. It is not a tax invoice. Months on the Free plan alone, contract plans and storage are not stated.
Request
- Base URL: https://api.naturali.ai
- URL: https://api.naturali.ai/v1/users/me/statements
- 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)
Query parameters
Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.
The next_cursor of the previous page.
Response
A page of statements.
Example response
{
"data": [
{
"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.