---
title: "Get campaign"
method: GET
path: "/v1/sponsored-product-ads/campaigns/{campaignId}"
tags: ["SponsoredProductAds V1"]
---

# Get campaign

`GET /v1/sponsored-product-ads/campaigns/{campaignId}`

## Request

- Base URL: `https://api.otto.market`
- URL: `https://api.otto.market/v1/sponsored-product-ads/campaigns/{campaignId}`
- Auth: HTTP bearer

Retrieve details of a specific campaign.

## Path parameters

- `campaignId` string, uuid, required

## Response `200`

Campaign details retrieved successfully.

- CampaignDTOSponsoredProductAdsV1
  - `campaignId` string, uuid, required
  - `name` string, required
  - `status` 'PENDING' | 'WAITING' | 'ACTIVE' | 'PAUSED' | 'ENDED' | 'CANCELED', required
  - `startDate` string, date, required
  - `endDate` string, date, nullable
  - `budget` MonetaryAmountSponsoredProductAdsV1, required
    - `amount` integer, required: Amount in minor units (cents). Example 1099 = 10.99 EUR. Minimum value is 20 (0.20 EUR).
    - `currency` 'EUR', required
  - `budgetType` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'LIFETIME', required
  - `pacing` 'ASAP' | 'EVEN', required
  - `campaignType` 'AUTOMATIC' | 'MANUAL', required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `_links` object, required
    - `self` LinkSponsoredProductAdsV1, required: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.
    - `targets` LinkSponsoredProductAdsV1: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.
    - `latest-change-request` LinkSponsoredProductAdsV1: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.
  - `_embedded` object
    - `latest-change-request` ChangeRequestSponsoredProductAdsV1
      - `requestId` string, uuid, required
      - `requestType` 'CREATE_CAMPAIGN' | 'UPDATE_CAMPAIGN' | 'CREATE_TARGETS' | 'UPDATE_TARGETS' | 'DELETE_TARGETS' | 'CREATE_KEYWORDS' | 'UPDATE_KEYWORDS' | 'DELETE_KEYWORDS', required
      - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED', required
      - `lastModifiedAt` string, date-time, required: Timestamp of the last status change of this change request.

## Other responses

- `400`: Bad request. Invalid or rejected input data.
- `401`: Unauthorized. Missing or invalid authentication token.
- `403`: Forbidden. Insufficient permissions or resource access denied.
- `404`: Not found. The requested resource does not exist.
- `500`: Internal server error.

## Changes

- **2026-09-10** `3d020f15ab4d`: 1 info
  - endpoint added
- **2026-09-08** `06ee9d8814bd`: 1 breaking
  - api path removed without deprecation
- **2026-09-01** `b1bc133112bd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/otto/apis/otto-market-api/changes/v1/sponsored-product-ads/campaigns/:campaignId/get.md)

---

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