OTotto
SponsoredProductAds V1

Get campaigns

Changed on

Retrieve a paginated list of campaigns for the authenticated partner.

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

Query parameters

cursorstring
Example:eyJjcmVhdGVkQXQi...

Opaque cursor for pagination. Use the value of nextCursor or prevCursor from the previous response.

limitinteger

Results per page (max 1000)

Response

List of campaigns retrieved successfully.

nextCursorstring 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.

prevCursorstring 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.

Example response

{
  "campaigns": [
    {
      "startDate": "2026-04-28",
      "endDate": "2026-10-28",
      "_links": {
        "self": {
          "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns/00000001-0000-4000-8000-000000000001"
        },
        "targets": {
          "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns/00000001-0000-4000-8000-000000000001/targets"
        }
      }
    }
  ],
  "nextCursor": "eyJjcmVhdGVkQXQi...",
  "prevCursor": "eyJjcmVhdGVkQXQi...",
  "_links": {
    "self": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns?limit=20"
    },
    "next": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns?cursor=eyJjcmVhdGVkQXQi...&limit=20"
    },
    "prev": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns?cursor=eyJjcmVhdGVkQXQi...&limit=20"
    }
  }
}

Changes