---
title: "Batch get campaign status"
method: POST
path: "/ads-management/v1/campaigns:batchGetStatus"
tags: ["Advertising"]
---

# Batch get campaign status

`POST /ads-management/v1/campaigns:batchGetStatus`

Returns the status (lifecycle state) and deliveryStatus (whether the campaign is currently serving), along with deliveryStatusReasons, for up to 100 campaigns in a single call. This is the recommended way to poll the review and serving state of many campaigns at once. Provide the campaign IDs in campaignIds; any ID that is not found or is not owned by the caller is returned in the failures array with reason NOT_FOUND.

## Request body

- InternalPublicV1BatchGetStatusRequest
  - `campaignIds` string[], required — The campaign IDs to look up. Required. At most 100 per request.

## Response `200`

OK

- InternalPublicV1BatchGetStatusResponse
  - `failures` InternalPublicV1CampaignIDFailure[] — The IDs that could not be resolved. Omitted when every ID resolved.
    - `id` string — The campaign ID that could not be resolved.
    - `reason` 'NOT_FOUND' — Why the ID could not be resolved. `NOT_FOUND` means the campaign does not exist or is not owned by the caller.
  - `statuses` InternalPublicV1CampaignStatus[] — One entry per successfully resolved campaign.
    - `deliveryStatus` 'SERVING' | 'IN_REVIEW' | 'NOT_SERVING' | 'REJECTED' — The current serving state. Can be `SERVING`, `IN_REVIEW`, `NOT_SERVING`, or `REJECTED`.
    - `deliveryStatusReasons` string[] — The reasons behind the current deliveryStatus. Omitted when there are none.
    - `id` string — The campaign identifier.
    - `status` 'ACTIVE' | 'PAUSED' | 'CANCELLED' — The lifecycle state. Can be `ACTIVE`, `PAUSED`, or `CANCELLED`.

## Other responses

- `400` — Invalid request or exceeds 100 IDs
- `403` — Permission denied
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)