> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get brand billing contract

> The brand's billing contract, or null when none is configured.

### Path parameters

<ParamField path="brand_id" type="string (uuid)" required />

### Response

`object`

<ResponseField name="id" type="string (uuid)" required />

<ResponseField name="brand_id" type="string (uuid)" required />

<ResponseField name="tenant_id" type="string (uuid)" required />

<ResponseField name="billing_profile_id" type="string (uuid)" />

<ResponseField name="provider" type="string" required />

<ResponseField name="contract_type" type="string" required />

<ResponseField name="status" type="string" required />

<ResponseField name="currency" type="string" required />

<ResponseField name="period" type="string" required />

<ResponseField name="display_name" type="string" required />

<ResponseField name="commitment_label" type="string" required />

<ResponseField name="commitment_fee_minor" type="integer" required />

<ResponseField name="default_unit_amount_minor" type="integer" required />

<ResponseField name="included_quantity" type="integer" required />

<ResponseField name="starts_at" type="string (date-time)" />

<ResponseField name="ends_at" type="string (date-time)" />

<ResponseField name="metadata" type="object" required />

<ResponseField name="rates" type="object[]" required>
  <Expandable title="rates">
    <ResponseField name="id" type="string (uuid)" required />

    <ResponseField name="contract_id" type="string (uuid)" required />

    <ResponseField name="outcome_type" type="string" required />

    <ResponseField name="display_name" type="string" />

    <ResponseField name="unit_amount_minor" type="integer" required />

    <ResponseField name="included_quantity" type="integer" required />

    <ResponseField name="committed_unit_amount_minor" type="integer" />

    <ResponseField name="metadata" type="object" required />

    <ResponseField name="created_at" type="string (date-time)" required />

    <ResponseField name="updated_at" type="string (date-time)" required />
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string (date-time)" required />

<ResponseField name="updated_at" type="string (date-time)" required />

### Status codes

| Code  | Meaning                                                          |
| ----- | ---------------------------------------------------------------- |
| `200` | The brand's billing contract, or `null` when none is configured. |
| `400` | Validation error                                                 |
| `401` | Unauthorized                                                     |
| `404` | Not found                                                        |
| `429` | Rate limited                                                     |
| `500` | Internal error                                                   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}/billing/contract' \
    --header "x-api-key: $STATESET_TEMPORAL_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "billing_profile_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "provider": "string",
    "contract_type": "string",
    "status": "pending",
    "currency": "USD",
    "period": "string",
    "display_name": "Ada Lovelace",
    "commitment_label": "string",
    "commitment_fee_minor": 4900,
    "default_unit_amount_minor": 4900,
    "included_quantity": 1,
    "starts_at": "2026-08-31T14:22:05Z",
    "ends_at": "2026-08-31T14:22:05Z",
    "metadata": {},
    "rates": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "contract_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "outcome_type": "string",
        "display_name": "Ada Lovelace",
        "unit_amount_minor": 4900,
        "included_quantity": 1,
        "committed_unit_amount_minor": 4900,
        "metadata": {},
        "created_at": "2026-08-31T14:22:05Z",
        "updated_at": "2026-08-31T14:22:05Z"
      }
    ],
    "created_at": "2026-08-31T14:22:05Z",
    "updated_at": "2026-08-31T14:22:05Z"
  }
  ```
</ResponseExample>