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

# Get campaigns

`GET /v1/sponsored-product-ads/campaigns`

## Request

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

Retrieve a paginated list of campaigns for the authenticated partner.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

List of campaigns retrieved successfully.

- PaginatedCampaignsResponseSponsoredProductAdsV1
  - `campaigns` CampaignListItemDTOSponsoredProductAdsV1[], required
    - `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.
  - `nextCursor` string, nullable: Opaque cursor for the next page. Absent or `null` when there is no next page. Pass this value as the `cursor` query parameter to retrieve the next page.
  - `prevCursor` string, nullable: Opaque cursor for the previous page. Absent or `null` on the first page. Pass this value as the `cursor` query parameter to retrieve the previous page.
  - `_links` object, required
    - `self` LinkSponsoredProductAdsV1: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.
    - `next` LinkSponsoredProductAdsV1: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.
    - `prev` LinkSponsoredProductAdsV1: A HAL link object as defined in draft-kelly-json-hal.
      - `href` string, uri, required: The URL of the linked resource.

## 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.
- `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/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)