Admin

List a user's monthly statements

The same statements the account reads at GET /v1/users/me/statements, for an operator to bill from. Needs the admin role.

get/v1/admin/users/{user_id}/statements

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/admin/users/{user_id}/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)

Path parameters

user_idstring required

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

cursorstring

The next_cursor of the previous page.

Response

A page of statements.

next_cursorstring nullable required

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.