> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /2025-04/marketing-solutions/campaigns/{campaign-id} > Get the data for the specified campaign. A campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria. ## OpenAPI ````yaml https://api.criteo.com/2025-04/marketingsolutions/open-api-specifications.json get /2025-04/marketing-solutions/campaigns/{campaign-id} openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: 2025-04 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Creative - name: Gateway paths: /2025-04/marketing-solutions/campaigns/{campaign-id}: get: tags: - Campaign summary: /2025-04/marketing-solutions/campaigns/{campaign-id} description: "Get the data for the specified campaign.\r\n \r\nA campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria." operationId: GetCampaign parameters: - name: campaign-id in: path description: ID of the marketing campaign; This field is required. required: true schema: type: string responses: '200': description: Returns the data of the specified marketing campaign. content: application/json: schema: $ref: '#/components/schemas/CampaignV23Q1Response' security: - oauth: - MarketingSolutions_Campaign_Read components: schemas: CampaignV23Q1Response: type: object properties: data: $ref: '#/components/schemas/CampaignV23Q1Resource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: Data model for response resource CampaignV23Q1Resource: type: object properties: attributes: $ref: '#/components/schemas/CampaignV23Q1' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true example: Campaign description: Data model for a Resource nullable: true CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. CampaignV23Q1: type: object properties: advertiserId: type: string description: Advertiser id of the campaign (string-encoded integer) nullable: true budgetAutomation: $ref: '#/components/schemas/CampaignBudgetAutomationV23Q1' goal: enum: - unspecified - acquisition - retention type: string description: "Goal of the campaign\r\n \r\nSerialized values are {unspecified}, {acquisition} and {retention}.\r\n \r\nAcquisition and retention are defined as follows:\r\n- Acquisition: campaign with the goal of acquiring new customers. The success of an acquisition campaign is measured by the number of new customers it brings.\r\n- Retention: campaign with the goal of retaining existing customers. The success of a retention campaign is measured by the number of existing customers it retains." nullable: true id: type: string description: Id of the entity (duplicate of the parent id). nullable: true name: type: string description: Name of the campaign nullable: true spendLimit: $ref: '#/components/schemas/CampaignSpendLimitV23Q1' description: "Campaign read model\r\n \r\nThe {id} field is the campaign identifier (string-encoded integer)." nullable: true CampaignBudgetAutomationV23Q1: type: object properties: automatedBudgetConfiguration: $ref: '#/components/schemas/AutomatedBudgetConfigurationV23Q1' enabled: type: boolean description: >- Whether budget automation is enabled for this campaign. This field is always present in the response. nullable: true description: "Budget automation, also known as automated budget or budget pacing, lets users configure KPIs and budgets once at the campaign level while Criteo dynamically routes spend toward the best-performing ad sets.\r\nWhen enabled is false, automatedBudgetConfiguration is null.\r\nWhen enabled is true, automatedBudgetConfiguration.adSetOptimizationObjective is expected." nullable: true CampaignSpendLimitV23Q1: type: object properties: spendLimitAmount: $ref: '#/components/schemas/NillableDecimal' spendLimitRenewal: enum: - undefined - daily - monthly - lifetime type: string description: "The period over which the campaign spend limit is applied.\r\nWhen spendLimitType is \"capped\", this is \"daily\", \"monthly\", or \"lifetime\".\r\nWhen spendLimitType is \"uncapped\", this is \"undefined\"." nullable: true spendLimitType: enum: - capped - uncapped type: string description: "Controls whether the campaign has a spend limit.\r\n\"capped\" returns a non-null spendLimitAmount.value and a spendLimitRenewal of \"daily\", \"monthly\", or \"lifetime\".\r\n\"uncapped\" returns spendLimitAmount.value as null and spendLimitRenewal as \"undefined\"." nullable: true description: >- Campaign spend-limit configuration. A capped spend limit restricts campaign spending per renewal period. An uncapped spend limit does not impose a spending ceiling. nullable: true AutomatedBudgetConfigurationV23Q1: type: object properties: adSetOptimizationObjective: enum: - conversions - revenue - visits - videoViews type: string description: "Optimization objective used to automate budget allocation across ad sets.\r\nExpected when budgetAutomation.enabled is true.\r\nPossible values are \"conversions\", \"revenue\", \"visits\", and \"videoViews\"." nullable: true description: Detailed configuration used when campaign budget automation is enabled. nullable: true NillableDecimal: type: object properties: value: type: number format: double nullable: true description: >- structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided. nullable: true securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````