---
title: "Get campaign"
method: GET
path: "/vocalize/2/campaigns/{campaignId}"
tags: ["customer-engagement", "vocalize", "campaign"]
---

# Get campaign

`GET /vocalize/2/campaigns/{campaignId}`

## 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/vocalize/2/campaigns/{campaignId}`
- Auth: API key in header `Authorization`

Get a campaign by its ID.

## Path parameters

- `campaignId` string, uuid, required: The UUID of the campaign to retrieve.

## Response `200`

Campaign with ID successfully retrieved

- 1e177a7c00f43fb0cfaf8876573312572061d384022066ddec32b06770199719CampaignResponse
  - `name` string, required: Name of the campaign. Must be unique per account.
  - `keywordSpec` object: Specification of language-specific key phrases that users should pronounce during the campaign. This is a dictionary mapping language codes (ISO 639-1 with optional country code, e.g., 'en-US', 'es-ES') to the exact phrases users must say. Find the list of languages supported by Azure <a href="https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support?tabs=stt">here</a> and the list of languages supported by Google <a href="https://cloud.google.com/speech-to-text/docs/speech-to-text-supported-languages">here</a>. The speech-to-text engine will compare user audio against these phrases for scoring. If left unspecified, the campaign will rely solely on image and/or audio matching. Phrases should be clear, pronounceable words or short sentences in the target language.
  - `activeFrom` string, date-time, required: Date and time when the campaign becomes active, in ISO 8601 format (e.g., 2023-10-01T00:00:00Z).
  - `activeUntil` string, date-time, required: Date and time when the campaign ends, in ISO 8601 format (e.g., 2023-10-31T23:59:59Z).
  - `settings` 1e177a7c00f43fb0cfaf8876573312572061d384022066ddec32b06770199719CampaignSettings
    - `maxDailyAttemptsPerUser` integer: Maximum number of times a user can participate in the campaign in one day.
    - `sttModelProvider` 'AZURE' | 'GOOGLE': Speech-to-text model provider options.
    - `maxDailyAttemptsPerCampaign` integer: Maximum number of times all users can participate in the campaign in one day.
  - `imageUrl` string: Image used for shape matching.
  - `id` string, uuid, required: Unique identifier of the campaign.
  - `accountId` string, required: ID of the account that owns the campaign.
  - `dateCreated` string, date-time: Date and time when the campaign was created, in ISO 8601 format (e.g., 2023-10-01T00:00:00Z).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)