---
title: "Returns the audience information"
method: GET
path: "/api/v3/advertisers/{advertiserId}/audiences/{audienceId}"
tags: ["Audiences"]
---

# Returns the audience information

`GET /api/v3/advertisers/{advertiserId}/audiences/{audienceId}`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/audiences/{audienceId}`
- Auth: HTTP bearer

## Path parameters

- `advertiserId` string, required
- `audienceId` string, required

## Response `200`

The audience with the id specified in the URL

- union
  - object
    - `advertiser_id` string: The advertiser which owns the audience.
    - `audience_size` integer, nullable: The size of the audience.
    - `audience_type` 'ADDRESSES' | 'EMAILS' | 'EMAIL_AND_ADDRESSES' | 'POSTAL_CODES', nullable: The audience type.
    - `created_at` string, date-time: The creation timestamp
    - `description` string, nullable: The description of the audience.
    - `id` string: The id of the audience.
    - `name` string: The name of the audience.
    - `status` 'ACTIVE' | 'PENDING' | 'ARCHIVED' | 'FAILED' | 'PAUSED': The status of the custom audience.
    - `updated_at` string, date-time: The timestamp of the last update for this audience.
  - object
    - `advertiser_id` string: The advertiser which owns the audience.
    - `audience_size` integer, nullable: The size of the audience.
    - `audience_type` 'RETARGETING_PIXEL' | 'RETARGETING_ENGAGEMENT' | 'RETARGETING_CAPI', nullable: The audience type.
    - `created_at` string, date-time: The creation timestamp
    - `description` string, nullable: The description of the audience.
    - `id` string: The id of the audience.
    - `name` string: The name of the audience.
    - `retargeting_data` union: The retargeting data.
      - object
        - `capi_retargeting_data` object: Data required to create a capi retargeting audience.
          - `capi_actions` string[]: A list of conversion events tracked through the CAPI.
          - `entity_id` string: The id of the entity.
          - `entity_id_type` 'ADVERTISER_PROFILE' | 'CAMPAIGN' | 'AD_GROUP': The entity in which the conversion event was tracked.
        - `lookback_window_ms` integer: The lookback window for the audience in ms
      - object
        - `engagement_retargeting_data` object: Data required to create an engagement retargeting audience.
          - `engagement_actions` object[]: List of engagement actions to retarget. Each action has an associated entity in which that action is to be retargeted
            - `engagement_action` 'SEEN' | 'CLICKED' | 'VIEWED_25_PERCENT' | 'VIEWED_50_PERCENT' | 'VIEWED_75_PERCENT' | 'VIEWED_100_PERCENT' | 'VIEWED_2_SEC' | 'LEAD_GEN_CONFIRMATION_CTA' | 'LEAD_GEN_FORM_CLOSE' | 'LEAD_GEN_FORM_SUBMIT' | 'LEAD_GEN_CONFIRMATION_CLOSE': The engagement action to be retargeted.
            - `entity_id` string: The id of the retargeting ad entity. An engagement action is tracked at the ad level, but advertisers have the option to retarget users who have engaged with any ad across the specified ad entity (ad group, campaign, advertiser profile).
            - `entity_id_type` 'ADVERTISER_PROFILE' | 'CAMPAIGN' | 'AD_GROUP': The ad entity to be retargeted.
        - `lookback_window_ms` integer: The lookback window for the audience in ms
      - object
        - `lookback_window_ms` integer: The lookback window for the audience in ms
        - `pixel_retargeting_data` object: Data required to create a pixel retargeting audience.
          - `pixel_actions` string[]: A list of conversion events tracked by the pixel.
          - `pixel_id` string: The id of the pixel.
    - `status` 'ACTIVE' | 'PENDING' | 'ARCHIVED' | 'FAILED' | 'PAUSED': The status of the custom audience.
    - `updated_at` string, date-time: The timestamp of the last update for this audience.

## Other responses

- `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.
- `401`: Unauthorized. The API key is invalid and needs to be re-generated.
- `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.
- `500`: Internal server error.
- `503`: The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)