# Public - 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/public
> Every group: https://x-radius.com/llms.txt

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

### POST /api/v1/public/auth/resolve-host

`POST /api/v1/public/auth/resolve-host`

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

_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/public/backup/oauth/{provider}/callback

`GET /api/v1/public/backup/oauth/{provider}/callback`

- 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/public/csat/{token}

`GET /api/v1/public/csat/{token}`

- 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._


### POST /api/v1/public/csat/{token}

`POST /api/v1/public/csat/{token}`

- 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._


### POST /api/v1/public/csp-report

`POST /api/v1/public/csp-report`

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

_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/public/pay/gateways

`GET /api/v1/public/pay/gateways`

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

_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/public/pay/guest-checkout

`POST /api/v1/public/pay/guest-checkout`

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

_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/public/pay/lookup

`POST /api/v1/public/pay/lookup`

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

_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/public/pay/recover

`POST /api/v1/public/pay/recover`

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

_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/public/pay/status/{state}

`GET /api/v1/public/pay/status/{state}`

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

_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/public/pay/{gateway}/redirect/{tenant_id}/{token}/{outcome}

`GET /api/v1/public/pay/{gateway}/redirect/{tenant_id}/{token}/{outcome}`

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

_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/public/pay/{gateway}/return/{state}

`GET /api/v1/public/pay/{gateway}/return/{state}`

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

_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/public/pay/{gateway}/webhook/{tenant_id}/{secret}

`POST /api/v1/public/pay/{gateway}/webhook/{tenant_id}/{secret}`

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

_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/public/register/captcha

`GET /api/v1/public/register/captcha`

- Authentication: none
- Rate limit bucket: `register_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._


### GET /api/v1/public/register/policy

`GET /api/v1/public/register/policy`

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

_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/public/register/slug-available

`GET /api/v1/public/register/slug-available`

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

_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/public/site/captcha

`GET /api/v1/public/site/captcha`

- Authentication: none
- Rate limit bucket: `site_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/public/site/leads

`POST /api/v1/public/site/leads`

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

_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._


### CONNECT /api/v1/public/sysbackup/{name}

`CONNECT /api/v1/public/sysbackup/{name}`

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

_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/public/sysbackup/{name}

`DELETE /api/v1/public/sysbackup/{name}`

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

_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/public/sysbackup/{name}

`GET /api/v1/public/sysbackup/{name}`

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

_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._


### HEAD /api/v1/public/sysbackup/{name}

`HEAD /api/v1/public/sysbackup/{name}`

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

_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._


### OPTIONS /api/v1/public/sysbackup/{name}

`OPTIONS /api/v1/public/sysbackup/{name}`

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

_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._


### PATCH /api/v1/public/sysbackup/{name}

`PATCH /api/v1/public/sysbackup/{name}`

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

_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/public/sysbackup/{name}

`POST /api/v1/public/sysbackup/{name}`

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

_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/public/sysbackup/{name}

`PUT /api/v1/public/sysbackup/{name}`

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

_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._


### QUERY /api/v1/public/sysbackup/{name}

`QUERY /api/v1/public/sysbackup/{name}`

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

_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._


### TRACE /api/v1/public/sysbackup/{name}

`TRACE /api/v1/public/sysbackup/{name}`

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

_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/public/telegram/{bot_kind}/webhook/{license_id}/{secret}

`POST /api/v1/public/telegram/{bot_kind}/webhook/{license_id}/{secret}`

- 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._