---
title: "Returns a list of campaigns for the advertiser."
method: GET
path: "/api/v3/advertisers/{advertiserId}/campaigns"
tags: ["Campaign"]
---

# Returns a list of campaigns for the advertiser.

`GET /api/v3/advertisers/{advertiserId}/campaigns`

## Request

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

## Path parameters

- `advertiserId` string, required

## Query parameters

- `includeArchived` boolean
- `cursor` string
- `pageSize` integer, required

## Response `200`

A list of campaigns for the advertiser paginated

- object
  - `campaigns` object[]: The list of campaigns returned in this paginated call.
    - `cursor` string: The cursor of the campaign.
    - `data` object: The Campaign data.
      - `advertiser_id` string: The advertiser id this campaign is tied to.
      - `created_at` string, date-time: The creation time of the campaign.
      - `end_time` string, date-time, nullable: The end time of the campaign based on its last running ad group, null if there are no ad groups or if there are ad groups running indefinitely.
      - `id` string: The id of the campaign.
      - `name` string: The name of the campaign.
      - `objective` 'AWARENESS' | 'CONSIDERATION' | 'CONVERSION' | 'LEAD_GENERATION': The objective of the campaign.
      - `start_time` string, date-time, nullable: The start time of the campaign based on the earliest running ad group, null if there are no ad groups.
      - `status` 'DRAFT' | 'ACTIVE' | 'NO_ACTIVE_AD_GROUPS' | 'PAUSED' | 'ARCHIVED' | 'PAUSED_FOR_BILLING' | 'INELIGIBLE': The status of the campaign computed based on the user status and internal checks.
      - `sub_objective` 'BRAND_AWARENESS' | 'WEBSITE_VISITS' | 'LEAD_GENERATION' | 'WEBSITE_CONVERSIONS' | 'APP_INSTALL', nullable: The sub-objective of the campaign.
      - `updated_at` string, date-time: The last update time of the campaign.
      - `user_status` 'ACTIVE' | 'PAUSED' | 'ARCHIVED': The user set status of the campaign.
  - `page_info` object: The pagination info for the api caller to get the rest of the advertiser's campaigns.
    - `end_cursor` string, nullable: The end cursor of the current page result, typically this is the cursor of the last object.
    - `page_size` integer: The number of results returned in this page.

## 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)