---
title: "Retrieve bulk operation status"
method: GET
path: "/v3/campaigns/bulk/status/{id}"
tags: ["BulkCampaignOperations"]
---

# Retrieve bulk operation status

`GET /v3/campaigns/bulk/status/{id}`

This endpoint retrieves the status and details of a bulk campaign operation using the bulk operation ID. It has been enhanced to support pagination (default: 20 items per page) and status-based filtering, for improved performance and targeted data retrieval.

## Path parameters

- `id` string, required

## Query parameters

- `pageToken` string
- `pageSize` string, int64
- `status` string

## Response `200`

Provides the status and details for the requested bulk campaign operation.

- V3BulkCampaignStatusResponse
  - `bulkId` string — Unique identifier for the bulk operation.
  - `resource` 'BULK_OPERATION_RESOURCE_BILLING' | 'BULK_OPERATION_RESOURCE_CAMPAIGN' | 'BULK_OPERATION_RESOURCE_AUTH'
  - `operationType` 'BULK_OPERATION_TYPE_CAMPAIGN_UPDATE' | 'BULK_OPERATION_TYPE_CAMPAIGN_STATE_UPDATE' | 'BULK_OPERATION_TYPE_WALLET_UPDATE' | 'BULK_OPERATION_TYPE_TEAM_UPDATE' | 'BULK_OPERATION_TYPE_WALLET_CREATE' | 'BULK_OPERATION_TYPE_TEAM_CREATE' | 'BULK_OPERATION_TYPE_CAMPAIGN_CREATE' | 'BULK_OPERATION_TYPE_INVITE_USER' | 'BULK_OPERATION_TYPE_REMOVE_USER'
  - `status` 'BULK_OPERATION_SUBMITTED' | 'BULK_OPERATION_IN_PROGRESS' | 'BULK_OPERATION_COMPLETED' | 'BULK_OPERATION_FAILED'
  - `totalCount` string, int64 — Total number of items in the bulk operation.
  - `successCount` string, int64 — Number of items processed successfully.
  - `failureCount` string, int64 — Number of items that failed processing.
  - `createdAt` string, date-time — Timestamp when the bulk operation was created.
  - `updatedAt` string, date-time — Timestamp when the bulk operation was last updated.
  - `items` Campaignv3BulkOperationItem[] — Array of bulk operation items with their status and details.
    - `status` 'BULK_ITEM_SUCCESS' | 'BULK_ITEM_FAILED'
    - `successResponse` Campaignv3SuccessResponse
      - `message` string — Success message for the operation.
      - `campaignId` string — The identifier of the campaign that was processed.
    - `errorResponse` V1ErrorResponse
      - `details` string — Error details describing what went wrong during the operation.
    - `approvalStateRequest` V3BulkApproveCampaignRequest
      - `campaignType` 'CAMPAIGN_TYPE_BANNER' | 'CAMPAIGN_TYPE_BANNERX' | 'CAMPAIGN_TYPE_DISPLAY'
      - `id` string — The unique identifier of the campaign to be approved.
      - `approval` Campaignv3Approval
        - `state` 'APPROVAL_STATE_PENDING' | 'APPROVAL_STATE_APPROVED' | 'APPROVAL_STATE_REJECTED'
        - `rejectionReason` string — The reason a campaign has been rejected. Mandatory field if status is APPROVAL_STATE_REJECTED
    - `campaignRequest` object
  - `nextPageToken` string — Token to retrieve the next page of results.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)