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

# List fleet billing profiles

> Billing profile summary per visible brand.

### Query parameters

<ParamField query="limit" type="integer">
  Max items (capped at 1000).
</ParamField>

<ParamField query="offset" type="integer" />

<ParamField query="status" type="string">
  Filter by status.
</ParamField>

### Response

`object`

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

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

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

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

    <ResponseField name="profile" type="object">
      Billing profile

      <Expandable title="profile">
        <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="provider" type="string" required />

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

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

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

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

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

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

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

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

        <ResponseField name="enabled" type="boolean" required />

        <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="model" type="string" />

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

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

    <ResponseField name="enabled" type="boolean" required />

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

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

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

    <ResponseField name="pending_billable_outcomes" type="integer" required />
  </Expandable>
</ResponseField>

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

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

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

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

### Status codes

| Code  | Meaning                                    |
| ----- | ------------------------------------------ |
| `200` | Billing profile summary per visible brand. |
| `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/fleet/billing' \
    --header "x-api-key: $STATESET_TEMPORAL_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "brand_slug": "acme-outdoors",
        "brand_display_name": "string",
        "profile": {
          "id": null,
          "brand_id": null,
          "tenant_id": null,
          "provider": null,
          "billing_org_id": null,
          "stripe_customer_id": null,
          "stripe_subscription_id": null,
          "billing_email": null,
          "pricing_model": null,
          "default_currency": null,
          "meter_event_namespace": null,
          "meter_event_overrides": null,
          "enabled": null,
          "metadata": null,
          "created_at": null,
          "updated_at": null
        },
        "model": "string",
        "rate_minor": 8,
        "currency": "USD",
        "enabled": true,
        "meter_pending_events": 1,
        "meter_failed_events": 1,
        "meter_sent_events": 1,
        "pending_billable_outcomes": 1
      }
    ],
    "total": 102,
    "limit": 20,
    "offset": 1,
    "count": 2
  }
  ```
</ResponseExample>