---
title: "List flat entitlement add-on records for the current principal"
method: GET
path: "/v1/billing/entitlements"
tags: ["billing"]
---

# List flat entitlement add-on records for the current principal

`GET /v1/billing/entitlements`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/billing/entitlements`
- Auth: HTTP bearer

## Response `200`

Entitlement records.

- EntitlementListEnvelope
  - `status` 'success', required
  - `entitlements` object[], required

## Other responses

- `401`: Unauthorized.
- `503`: Entitlements are not configured.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)