---
title: "Get a campaign"
method: GET
path: "/v1/campaigns/{campaignId}"
tags: ["campaigns"]
---

# Get a campaign

`GET /v1/campaigns/{campaignId}`

Get one campaign by campaignId.

## Path parameters

- `campaignId` integer, required

## Response `200`

successful operation

- Campaign
  - `id` integer
  - `name` string
  - `key` string
  - `description` string
  - `reduction` integer
  - `customData` object
  - `start_at` string
  - `end_at` string

## Other responses

- `401` — authentication failed
- `404` — It was not possible possible to find the campaign

## Changes

- **2026-07-17** `8cfa924ae703` — 1 info
  - added the non-success response with the status `401`
- **2023-08-21** `beabe2149947` — 3 warning
  - removed the optional property `customData/newField1` from the response with the `200` status
  - removed the optional property `customData/newField2` from the response with the `200` status
  - removed the optional property `customData/prices` from the response with the `200` status
- **2023-08-06** `302b7c443b51` — 4 info
  - removed the non-success response with the status `401`
  - added the optional property `customData/newField1` to the response with the `200` status
  - added the optional property `customData/newField2` to the response with the `200` status
  - added the optional property `customData/prices` to the response with the `200` status

[Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/campaigns/:campaignId/get.md)

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)