---
title: "Get Campaigns"
method: GET
path: "/number-registration/1/campaigns"
tags: ["platform", "numbers", "number-registration", "campaigns"]
---

# Get Campaigns

`GET /number-registration/1/campaigns`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number-registration/1/campaigns`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Gets a page of campaigns, using query parameters to filter results.

## Query parameters

- `id` string[]
- `brandId` string[]
- `type` string[]
- `nameLike` string
- `referenceId` string[]
- `applicationId` string
- `entityId` string
- `stage` string[]
- `number` string[]
- `page` integer
- `size` integer
- `sort` string[]

## Response `200`

OK

- 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aPageResponseCampaign
  - `results` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaign[]: The list of the results for this page.
    - `id` string, uuid: The identifier for the campaign.
    - `referenceId` string: Unique user defined ID for the campaign. While not required, it is recommended to supply a referenceId as the uniqueness constraint will help ensure a campaign is not accidentally created multiple times. Subsequent create requests with the same referenceId will be rejected with an error.
    - `applicationId` string: CPaaS X property identifying an application, a use case or an environment on your system. It should only be set if you are using CPaaS X Applications with your traffic.
    - `entityId` string: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.
    - `name` string, required: The name of the campaign.
    - `createdDate` string, date-time: The date and time when the campaign was created.
    - `lastModifiedDate` string, date-time: The date and time when the campaign was last modified.
    - `stage` 'DRAFT' | 'SUBMITTED_FOR_REVIEW' | 'IN_REVIEW' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'APPROVED_BY_INTERNAL_REVIEWER' | 'SUBMITTED' | 'REJECTED_EXTERNALLY' | 'REGISTERED' | 'REJECTED' | 'ON_HOLD' | 'DEREGISTERED' | 'REGISTERED_PENDING_UPDATE' | 'REGISTERED_PENDING_DEREGISTRATION' | 'ARCHIVED' | 'BLOCKED' | 'SUSPENDED' | 'APPEALED' | 'IN_MIGRATION' | 'PAUSED'
    - `priority` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aPriorityInfo: Priority information used in latest campaign review.
      - `priorityId` string, uuid: Id of a priority
      - `submittedDate` string, date-time: Date submitted for review
    - `campaignFeedback` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaignFeedback: Offers additional information regarding the campaign, includes rejection reason and time.
      - `rejectionReasons` string[]: The reasons for the rejection.
      - `rejectionDetails` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aRejectionReason[]: Rejection reasons details.
        - `errorCode` string: Predefined code.
        - `description` string: Rejection reason.
        - `recommendedAction` string: Recommended action.
      - `rejectionDate` string, date-time: The time of the rejection.
    - `type` 'TEN_DIGIT_LONG_CODE' | 'EXTERNAL_TEN_DIGIT_LONG_CODE' | 'SHORT_CODE' | 'DCA2_TEN_DIGIT_LONG_CODE' | 'TOLL_FREE_NUMBER' | 'TOLL_FREE_UNIFIED_NUMBER' | 'TOLL_FREE_EXTERNALLY_VERIFIED' | 'RCS_SENDER_LAUNCH': Campaign type.
  - `paging` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aPageInfo: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)