Skip to content
Ads API •References / campaigns / Get Campaign by ID

Get Campaign by ID

Returns campaign based on a given campaign ID.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • campaign_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • fields
    array of strings
    Unique items

    Subset of campaign fields to be returned.

    Array minimum length: 1Example: fields=NAME&fields=CREATED_AT&fields=STATUS
    Allowed values: "ID", "NAME", "CREATED_AT", "UPDATED_AT", "STATUS", "PURCHASE_ORDER", "OBJECTIVE", "MEASUREMENT_METADATA"

Response

Metadata for a single campaign.

  • id
    string [uuid]

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • name
    string

    Name given to identify your campaign.

    Pattern: ^\S.*\S$Length between 2 and 200Example: "Spotify Ads Summer Campaign 2022"
  • created_at
    string [date-time]

    Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • updated_at
    string [date-time]

    Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • purchase_order
    string

    A purchase order number, to be shown on your invoice, for your own personal organization.

    Length between 2 and 45Example: "ORDER_1"
  • restricted_ad_category
    string

    Restricted ad category identifier for the campaign

    Default: "UNSET"Allowed values: "UNSET", "NONE", "JOB_OFFERS", "INSURANCE", "LOANS_AND_CREDIT", "HOME_RENTING_AND_SALES", "GOVERNMENT_AND_NON_PROFIT", "GAMBLING", "PHARMACIES_AND_PHARMACEUTICALS", "GENERAL_HEALTHCARE", "NEW_OR_EXPECTING_PARENTS", "ALCOHOL", "PROCESSED_OR_REGULATED_FOOD", "POLITICAL_ADVERTISING"Example: "JOB_OFFERS"
  • status
    string

    Current state of campaign.

    Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "UNRECOGNIZED"Example: "ACTIVE"
  • objective
    string

    Objective for a campaign. UNSET should not be used.

    Default: "EVEN_IMPRESSION_DELIVERY"Allowed values: "UNSET", "REACH", "EVEN_IMPRESSION_DELIVERY", "CLICKS", "VIDEO_VIEWS", "PODCAST_STREAMS"Example: "EVEN_IMPRESSION_DELIVERY"

Response sample

{  "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "name": "Spotify Ads Summer Campaign 2022",  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "purchase_order": "ORDER_1",  "restricted_ad_category": "JOB_OFFERS",  "status": "ACTIVE",  "objective": "EVEN_IMPRESSION_DELIVERY"}