---
title: "List a campaign's ads"
method: GET
path: "/ads-management/v1/campaigns/{campaignId}/ads"
---

# List a campaign's ads

`GET /ads-management/v1/campaigns/{campaignId}/ads`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/campaigns/{campaignId}/ads`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `ad.campaign:read`

Lists every ad the campaign has had, one per creative, including PAUSED and REMOVED ads, in creation order (oldest first). id matches the ad ID reported by analytics-query-api.

## Path parameters

- `campaignId` string, required

## Query parameters

- `maxPageSize` integer
- `pageToken` string

## Response `200`

OK

- ListCampaignAdsResponse
  - `ads` CampaignAd[], required: The page of campaign ads.
    - `creativeAssetId` string, required: The Roblox image asset ID this ad serves, as a decimal string. This is the same value as Creative.assetId.
    - `deliveryStatus` 'SERVING' | 'IN_REVIEW' | 'NOT_SERVING' | 'REJECTED', required: Per-ad serving state (`SERVING`, `IN_REVIEW`, `NOT_SERVING`, or `REJECTED`).
    - `id` string, required: Stable ad ID; matches the ad ID in analytics-query-api.
    - `removeTime` string, date-time: Set when status is `REMOVED`, as an RFC 3339 UTC timestamp.
    - `reviewIssues` Reason[]: Structured review issues, when applicable.
      - `code` string, required: A stable, machine-readable code.
      - `message` string, required: A human-readable explanation.
      - `remediation` string: What the caller can do to resolve it.
      - `resource` string: The related resource, for example `billing-accounts/123`.
    - `reviewStatus` 'IN_REVIEW' | 'APPROVED' | 'REJECTED', required: Combined result of the creative's review and the experience's review (`IN_REVIEW`, `APPROVED`, or `REJECTED`).
    - `status` 'ACTIVE' | 'PAUSED' | 'REMOVED', required: Lifecycle intent for this ad (`ACTIVE`, `PAUSED`, or `REMOVED`).
  - `nextPageToken` string: The cursor for the next page. Pass it as pageToken to fetch the next page. Absent on the last page.

## Other responses

- `400`: Invalid maxPageSize or pageToken
- `403`: Permission denied
- `404`: Campaign not found
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/campaigns/:campaignId/ads/get.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/a94d3bd77d7f?raw)
