---
title: "Get a single audience by ID"
method: GET
path: "/v2/audiences/{audience_id}"
tags: ["audiences-v2"]
---

# Get a single audience by ID

`GET /v2/audiences/{audience_id}`

## Request

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

## Response `200`

Success

- AudienceResponse
  - `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

## Other responses

- `401`: Authentication error
- `404`: Audience not found

---

[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)