Admin

Read a user's plan history

A cursor page of the account's plan history, newest first, and the rung it is on now. Needs the admin role. The history is append-only, so this is the record of who put the account where and why — nothing edits or removes a line. plan at the top level is the same value every entitlement check resolves, so one response answers both "what plan is this?" and "how did it get there?".

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

Request

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

plan'free' | 'pro' | 'business' | 'enterprise' required

The rung in effect: the highest held this month, or free when the account has no history.

next_plan'free' | 'pro' | 'business' | 'enterprise' required

The newest line: the rung the account moves to when the month turns.

next_cursorstring nullable required

Pass as cursor for the next page; null on the last page.

Example response

{
  "data": [
    {
      "id": "sev_V1StGXR8Z5jdHi6B",
      "plan": "business",
      "retention_days": 365,
      "reason": "annual contract",
      "recorded_by_user_id": "user_V1StGXR8Z5jdHi6B"
    }
  ],
  "plan": "pro",
  "next_plan": "pro"
}

Changes

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