---
title: "Get a single audience"
method: GET
path: "/dealerships/{dealershipId}/audiences/{id}"
tags: ["audiences"]
---

# Get a single audience

`GET /dealerships/{dealershipId}/audiences/{id}`

## Request

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

Retrieves an audience by `id`.

Additional fields can be included in the response using the `embed` parameter. Available embed options:
- `shoppers_count`: Include the count of shoppers in the audience

## Path parameters

- `dealershipId` integer, required
- `id` integer, required

## Query parameters

- `embed` string

## Response `200`

The requested audience

- Audience: Represents an audience (saved shopper filter). Additional fields are available via the embed parameter.
  - `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.

## Other responses

- `401`: Unauthorized
- `404`: Audience not found
- `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)