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

# List audiences

`GET /api/v1/audiences`

## Request

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

List the project's audiences: the default project audience first, then the named audiences by creation time.

## Response `200`

The project's audiences.

- AudienceList
  - `audiences` Audience[], required
    - `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.
- `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)