---
title: "Get audience details"
method: GET
path: "/v1/ads/audiences/{audienceId}"
tags: ["Ad Audiences"]
---

# Get audience details

`GET /v1/ads/audiences/{audienceId}`

Returns the local audience record and fresh data from Meta (if available).

## Path parameters

- `audienceId` string, required

## Response `200`

Audience details

- object
  - `audience` object
  - `platformData` object, nullable — Fresh data from the platform API

## Other responses

- `401` — Unauthorized
- `403` — Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
- `404` — Resource not found

## Changes

- **2026-09-09** `222e3a38a382` — 1 warning, 1 info
  - removed the optional property `metaData` from the response with the `200` status
  - added the optional property `platformData` to the response with the `200` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/audiences/:audienceId/get.md)

---

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