---
title: "List all audiences"
method: GET
path: "/api/v1/audiences"
tags: ["Taxonomy"]
---

# List all audiences

`GET /api/v1/audiences`

## Request

- Base URL: `https://peerpush.com`
- URL: `https://peerpush.com/api/v1/audiences`
- Auth: one of:
  - API key in header `X-PeerPush-Api-Key`
  - API key in query parameter `api_key`

## Response `200`

List all audiences

- object
  - `data` TaxonomyItem[], required
    - `slug` string
    - `name` string

## Other responses

- `400`: Invalid query parameters (code: VALIDATION_ERROR)
- `401`: Missing, unknown, or revoked API key (code: UNAUTHORIZED or INVALID_API_KEY)
- `404`: Resource not found (code: NOT_FOUND)
- `429`: Hourly per-key quota exhausted (code: RATE_LIMITED)
- `500`: Unexpected server error (code: INTERNAL_ERROR)

---

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