---
title: "Read one audience"
method: GET
path: "/api/v1/audiences/{slug}"
tags: ["audiences"]
---

# Read one audience

`GET /api/v1/audiences/{slug}`

## Request

- Base URL: `https://api.past.dev`
- URL: `https://api.past.dev/api/v1/audiences/{slug}`
- Auth: HTTP bearer

Return one audience by slug, with its member count, memory count and definition. The slug project returns the default audience.

## Path parameters

- `slug` string, required

## Response `200`

The requested audience.

- Audience
  - `slug` string, required
  - `name` string, required
  - `kind` 'fixed' | 'rule' | 'default', required
  - `memberCount` integer, required: The identities the audience reaches now.
  - `memoryCount` integer, required: The memories scoped to this audience.
  - `reachesNobody` boolean, required: True for a rule audience that matches no identity.
  - `recomputedAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `identities` string[], nullable, required: The ids of a fixed audience, sorted. Null for the other kinds.
  - `rule` AudienceRule, required
    - `match` 'all' | 'any', required
    - `conditions` AudienceCondition[], required
      - `trait` string, required
      - `operator` 'is' | 'is_not' | 'is_one_of' | 'is_not_one_of' | 'exists' | 'does_not_exist', required
      - `values` string[]: One value for is and is_not, 1 to 50 for is_one_of and is_not_one_of, none for exists and does_not_exist.

## Other responses

- `400`: The request is malformed or violates a field constraint. Match behavior on the response code field.
- `401`: missing-api-key: no bearer. malformed-api-key: the header or the key has the wrong shape, or an agent token was sent to a route that accepts keys only. unauthorized: the key is unknown, expired, revoked, or of the kind this route refuses, or the agent token is invalid or expired.
- `403`: project-archived: the project of the key, or the project an agent token names, is archived. Unarchive it in the console to resume. insufficient-scope: the agent token does not carry the scope of the route.
- `404`: No audience carries this slug in the selected project.
- `default`: Any other failure uses the same JSON error envelope.

---

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