---
title: "Get a campaign"
method: GET
path: "/v2/campaigns/{id}"
tags: ["Campaigns"]
---

# Get a campaign

`GET /v2/campaigns/{id}`

## Request

- Base URL: `https://api.tenjin.com`
- URL: `https://api.tenjin.com/v2/campaigns/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

The campaign

- CampaignDocument
  - `data` CampaignResource, required
    - `id` string, uuid, required
    - `type` 'campaign', required
    - `attributes` object, required
      - `channel_id` integer, required: Id of the campaign's channel
      - `app_id` string, uuid, nullable, required: Id of the app the campaign promotes
      - `ad_account_id` string, uuid, nullable, required: Id of the campaign's ad account
      - `name` string, nullable, required: Name of the campaign in Tenjin
      - `short_id` string, nullable, required: URL-safe id of the campaign in Tenjin
      - `remote_campaign_id` string, nullable, required: Id of the campaign on the ad network
      - `click_tracking_url` string, nullable, required: Click tracking URL of the campaign, with the ad network's macros left as is
      - `impression_tracking_url` string, nullable, required: Impression tracking URL of the campaign, with the ad network's macros left as is
      - `attribution_window` integer, nullable, required: Click attribution window in seconds. Null uses the ad account's window. Attribution does not use it: it uses the app's attribution windows and the integration's attribution settings
      - `created_at` string, date-time, nullable, required: When the campaign was created
      - `hidden` boolean, required: Whether the campaign is deleted
  - `links` Links, required
    - `self` string, uri, required: URL of this request
    - `first` string, uri: URL of the first page of a list
    - `prev` string, uri: URL of the previous page of a list
    - `next` string, uri: URL of the next page of a list
    - `last` string, uri: URL of the last page of a list
  - `meta` object, required: Always empty

## Other responses

- `400`: A param is missing or invalid, a record is not found, or the request cannot be served
- `401`: Missing or invalid credentials, or no access to the requested data
- `403`: Invalid token, or the user's role does not allow the request
- `498`: Expired token, or a token with an invalid signature

---

[API](https://skmtc.dev/tenjin/apis/campaign-management-api.md) - [All operations](https://skmtc.dev/tenjin/apis/campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/campaign-management-api/revisions/e3cae1a03a92?raw)