# User - X-Radius API

> Base URL: https://x-radius.com/api/v1
> Auth: Authorization: Bearer xrt_...  (a manager API token)
> Envelope: {"data": ...}; lists add {"meta":{page,page_size,total,has_next}}
> Errors: {"error":{"code","message","request_id"}} - branch on code, never on message
> Timestamps: yyyy-MM-dd HH:mm:ss, UTC
> Money: a bare JSON number in major units, with an ISO-4217 currency code beside it
> Idempotency: redeem and activate endpoints take a client-supplied request_id (UUID)
>
> This page: https://x-radius.com/docs/api/user
> Every group: https://x-radius.com/llms.txt

58 endpoints in 1 resource groups. 0 carry a hand-written reference entry with examples; the remaining 58 are generated from the running router and carry method, path, authentication, permission and rate-limit bucket, but no request or response example.

### PATCH /api/v1/user/account

`PATCH /api/v1/user/account`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/auto-renew

`POST /api/v1/user/auto-renew`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### PUT /api/v1/user/bucket-order

`PUT /api/v1/user/bucket-order`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/captcha

`GET /api/v1/user/captcha`

- Authentication: none
- Rate limit bucket: `portal_captcha`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/cards/redeem

`POST /api/v1/user/cards/redeem`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/change-profile

`POST /api/v1/user/change-profile`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/config

`GET /api/v1/user/config`

- Authentication: none

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/credentials

`GET /api/v1/user/credentials`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/deposit

`POST /api/v1/user/deposit`

- Authentication: subscriber portal session
- Rate limit bucket: `portal_deposit`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/exchange

`POST /api/v1/user/exchange`

- Authentication: none
- Rate limit bucket: `portal_exchange`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/extend

`POST /api/v1/user/extend`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/extensions

`GET /api/v1/user/extensions`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/extensions/{id}

`GET /api/v1/user/extensions/{id}`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/guest/context

`GET /api/v1/user/guest/context`

- Authentication: subscriber portal session
- Rate limit bucket: `portal_guest`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/guest/register

`POST /api/v1/user/guest/register`

- Authentication: subscriber portal session
- Rate limit bucket: `portal_guest`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/invoices

`GET /api/v1/user/invoices`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/invoices/{id}

`GET /api/v1/user/invoices/{id}`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/invoices/{id}/render-data

`GET /api/v1/user/invoices/{id}/render-data`

- Authentication: subscriber portal session
- Rate limit bucket: `t_heavy`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/join

`POST /api/v1/user/join`

- Authentication: none
- Rate limit bucket: `portal_join`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/join/context

`GET /api/v1/user/join/context`

- Authentication: none
- Rate limit bucket: `portal_join`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/ledger

`GET /api/v1/user/ledger`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/login

`POST /api/v1/user/login`

- Authentication: none
- Rate limit bucket: `portal_login`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/me

`GET /api/v1/user/me`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/parental

`GET /api/v1/user/parental`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/parental/pause

`POST /api/v1/user/parental/pause`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/parental/pin

`POST /api/v1/user/parental/pin`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### PUT /api/v1/user/parental/rules

`PUT /api/v1/user/parental/rules`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/parental/unlock

`POST /api/v1/user/parental/unlock`

- Authentication: none
- Rate limit bucket: `portal_parental_unlock`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/password

`POST /api/v1/user/password`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/payments/gateways

`GET /api/v1/user/payments/gateways`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/payments/transactions

`GET /api/v1/user/payments/transactions`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/profiles

`GET /api/v1/user/profiles`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/purchase

`POST /api/v1/user/purchase`

- Authentication: subscriber portal session
- Rate limit bucket: `portal_deposit`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### DELETE /api/v1/user/push-tokens

`DELETE /api/v1/user/push-tokens`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/push-tokens

`POST /api/v1/user/push-tokens`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/quota-buckets

`GET /api/v1/user/quota-buckets`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/quote

`POST /api/v1/user/quote`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/refresh

`POST /api/v1/user/refresh`

- Authentication: none
- Rate limit bucket: `portal_refresh`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/renew

`POST /api/v1/user/renew`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/sessions

`GET /api/v1/user/sessions`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/signup

`POST /api/v1/user/signup`

- Authentication: none
- Rate limit bucket: `portal_signup`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/signup/schema

`GET /api/v1/user/signup/schema`

- Authentication: none

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### DELETE /api/v1/user/speed

`DELETE /api/v1/user/speed`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/speed

`GET /api/v1/user/speed`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### PUT /api/v1/user/speed

`PUT /api/v1/user/speed`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/telegram-exchange

`POST /api/v1/user/telegram-exchange`

- Authentication: none
- Rate limit bucket: `portal_telegram_exchange`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/telegram/link

`GET /api/v1/user/telegram/link`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/tickets

`GET /api/v1/user/tickets`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/tickets

`POST /api/v1/user/tickets`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/tickets/form

`GET /api/v1/user/tickets/form`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/tickets/{id}

`GET /api/v1/user/tickets/{id}`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/tickets/{id}/attach

`POST /api/v1/user/tickets/{id}/attach`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### DELETE /api/v1/user/tickets/{id}/attachments/{attId}

`DELETE /api/v1/user/tickets/{id}/attachments/{attId}`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/tickets/{id}/attachments/{attId}

`GET /api/v1/user/tickets/{id}/attachments/{attId}`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/tickets/{id}/messages

`POST /api/v1/user/tickets/{id}/messages`

- Authentication: subscriber portal session
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/tunnel-identify

`POST /api/v1/user/tunnel-identify`

- Authentication: none
- Rate limit bucket: `portal_tunnel_identify`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### POST /api/v1/user/tunnel-tenant

`POST /api/v1/user/tunnel-tenant`

- Authentication: none
- Rate limit bucket: `portal_tunnel_tenant`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### GET /api/v1/user/usage

`GET /api/v1/user/usage`

- Authentication: subscriber portal session

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


