---
title: "Get all audiences for the account"
method: GET
path: "/v2/audiences"
tags: ["audiences-v2"]
---

# Get all audiences for the account

`GET /v2/audiences`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/audiences`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `per_page` string
- `page` string
- `status` string

## Response `200`

Success

- AudiencesResponse
  - `audiences` AudienceResponse[]: Array of audiences
    - `cached_size` integer: Cached audience size
    - `cached_size_updated_at` string, date-time: When size was last calculated
    - `created_at` string, date-time: Creation timestamp
    - `description` string: Audience description
    - `filter` AudienceFilterGroup
      - `conditions` AudienceCondition[]: Conditions in this group
        - `condition_type` string, required: Type: time, count, custom_field, carrier, timezone, revenue
        - `field` string, required: Field to filter on
        - `operator` string, required: Comparison operator
        - `unit` string: Time unit: days, hours, minutes
        - `value` object: Value to compare
      - `groups` object[]: Nested groups for complex logic
      - `operator` string, required: Logical operator: AND or OR
    - `id` string: Audience ID
    - `name` string: Audience name
    - `source_lists` integer[]: Source list IDs (empty = all)
    - `status` string: Status: active, archived
  - `pagination` Pagination
    - `page` integer: Current page
    - `per_page` integer: Items per page
    - `total` integer: Total items
    - `total_pages` integer: Total pages

## Other responses

- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)