---
title: "List audiences"
method: GET
path: "/dealerships/{dealershipId}/audiences"
tags: ["audiences"]
---

# List audiences

`GET /dealerships/{dealershipId}/audiences`

## Request

- Base URL: `https://api.fullpath.com/consent-management`
- URL: `https://api.fullpath.com/consent-management/dealerships/{dealershipId}/audiences`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/docs/dealerships/:dealershipId/audiences/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of audiences

## Path parameters

- `dealershipId` integer, required

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string

## Response `200`

A paginated list of audiences

- AudiencesResponse: Response containing multiple audiences with pagination info
  - `data` Audience[], required
    - `id` integer, required: Unique identifier for the audience
    - `name` string, required: Name of the audience
    - `shopper_set` string, required: Base64-encoded JSON filter definition for the shopper set
    - `is_starred` 0 | 1, required: Whether the audience is starred (1) or not (0)
    - `is_subscribed` 0 | 1, required: Whether the audience is subscribed (1) or not (0)
    - `is_sales_enablement` 0 | 1, required: Whether the audience is used for sales enablement (1) or not (0)
    - `is_data_enrichment` 0 | 1, required: Whether the audience is used for data enrichment (1) or not (0)
    - `created_at` string, date-time, required: ISO 8601 timestamp when the audience was created
    - `updated_by` string, nullable: Name of the user who last updated the audience
    - `updated_at` string, date-time, nullable, required: ISO 8601 timestamp when the audience was last updated
    - `public_url` string, uri, required: Public URL for accessing the audience (contains authentication key)
    - `shoppers_count` integer: Number of shoppers in the audience. Only included when `embed=shoppers_count` is specified.
  - `pagination` Pagination, required: Pagination metadata
    - `page` integer, required: Current page number (1-based)
    - `per_page` integer, required: Number of items per page
    - `total` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages

## Other responses

- `204`: No audiences found
- `401`: Unauthorized
- `500`: Server error

---

[API](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0.md) - [All operations](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/revisions/4b73e1835a7e?raw)