---
title: List Audience Profiles
protocol: rest
method: GET
endpoint: /v1/projects/{projectId}/audiences
description: "List all audience profiles for a project"
---

# List Audience Profiles

Retrieve all audience profiles configured for a project.

<Endpoint method="GET" path="/v1/projects/{projectId}/audiences" />

## Path Parameters

<ParamField path="projectId" type="string" required>
  The project ID.
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer" default="20">
  Maximum number of profiles to return (1-100).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of profiles to skip for pagination.
</ParamField>

## Response

Returns an array of audience profile objects.

### Profile Object

<ResponseField name="id" type="string">
  Unique profile identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the profile.
</ResponseField>

<ResponseField name="slug" type="string">
  URL-safe identifier. Immutable after creation.
</ResponseField>

<ResponseField name="description" type="string">
  Optional description of the profile.
</ResponseField>

<ResponseField name="audiences" type="string[]">
  Array of audience tags this profile grants access to.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp when the profile was created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp when the profile was last updated.
</ResponseField>

## Example

<CodeGroup>
```bash cURL
curl https://api.syntext.dev/v1/projects/proj_abc123/audiences \
  -H "Authorization: Bearer stx_abc12345_..."
```

```typescript SDK
import { Syntext } from '@syntext/sdk'

const client = new Syntext('stx_abc12345_...')

const profiles = await client.audiences.list('proj_abc123')
```

```python Python
from syntext import Syntext

client = Syntext("stx_abc12345_...")

profiles = client.audiences.list("proj_abc123")
```
</CodeGroup>

### Response

```json
{
  "data": [
    {
      "id": "aud_xyz789",
      "name": "Acme Corporation",
      "slug": "acme-corp",
      "description": "Enterprise partner with full access",
      "audiences": ["otc", "virtual-accounts", "transfers"],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-02-20T14:45:00Z"
    },
    {
      "id": "aud_def456",
      "name": "Beta Testers",
      "slug": "beta-testers",
      "description": "Early access program participants",
      "audiences": ["beta"],
      "createdAt": "2024-01-10T08:00:00Z",
      "updatedAt": "2024-01-10T08:00:00Z"
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 20,
    "offset": 0
  }
}
```