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

# List brands

> List brand entities with optional filters.

**Required permission:** `brands:read`

## Query parameters

<ParamField query="market" type="string">
  Filter by ISO 3166-1 alpha-2 country code.
</ParamField>

<ParamField query="status" type="string">
  Filter by brand status: `pending_verification`, `verified`, `rejected`, `suspended`.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

<ParamField query="page_size" type="integer" default="50">
  Results per page. Maximum 100.
</ParamField>

## Example

```bash theme={null}
curl "https://api.senderz.ai/v1/brands?market=AU&status=verified" \
  -H "Authorization: Bearer sz_live_xxxxxxxxxxxxx"
```

## Response

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "data": [
      {
        "id": "brand_f6g7h8i9",
        "name": "TrackFast Logistics Pty Ltd",
        "identifier_type": "ABN",
        "identifier_value": "12345678901",
        "market": "AU",
        "status": "verified",
        "created_at": "2026-07-17T14:30:00+10:00"
      },
      {
        "id": "brand_j1k2l3m4",
        "name": "SecurBank Australia Ltd",
        "identifier_type": "ABN",
        "identifier_value": "98765432100",
        "market": "AU",
        "status": "verified",
        "created_at": "2026-07-15T09:00:00+10:00"
      }
    ],
    "pagination": {
      "has_more": false,
      "next_cursor": null,
      "page_size": 50
    },
    "meta": {
      "request_id": "req_stu901",
      "timestamp": "2026-07-17T14:40:00+10:00"
    }
  }
  ```
</ResponseExample>