> ## 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. # /2026-01/marketing-solutions/advertisers/{advertiser-id}/ads > Get the list of self-services Ads for a given advertiser ## OpenAPI ````yaml https://api.criteo.com/2026-01/marketingsolutions/open-api-specifications.json get /2026-01/marketing-solutions/advertisers/{advertiser-id}/ads openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: 2026-01 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Creative - name: Gateway - name: Reco paths: /2026-01/marketing-solutions/advertisers/{advertiser-id}/ads: get: tags: - Creative summary: /2026-01/marketing-solutions/advertisers/{advertiser-id}/ads description: Get the list of self-services Ads for a given advertiser operationId: GetAdvertiserAds parameters: - name: advertiser-id in: path description: The advertiser identifier. required: true schema: type: string - name: limit in: query description: The number of ads to be returned. The default is 50. schema: type: integer format: int32 nullable: true - name: offset in: query description: >- The (zero-based) offset into the collection of ads. The default is 0. schema: type: integer format: int32 nullable: true responses: '200': description: The list of self-services Ads is returned. content: application/json: schema: $ref: '#/components/schemas/ResourceCollectionOutcomeOfAd' security: - oauth: - MarketingSolutions_Creative_Read components: schemas: ResourceCollectionOutcomeOfAd: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfAd' nullable: true 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: >- A top-level object that encapsulates a Criteo API response for several entities. ResourceOfAd: type: object properties: attributes: $ref: '#/components/schemas/Ad' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API. 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. Ad: type: object properties: adClickTracking: type: array items: $ref: '#/components/schemas/ExamAdClickTracking' description: Optional ad-level click tracking configuration. nullable: true adDeliveryStatus: enum: - Live - Paused type: string description: "The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it." nullable: true adImpressionTracking: type: array items: $ref: '#/components/schemas/ExamAdImpressionTracking' description: Optional ad-level impression tracking configuration. nullable: true adSetId: type: string description: The id of the Ad Set binded to this Ad nullable: true creativeId: type: string description: The id of the Creative binded to this Ad nullable: true description: type: string description: The description of the ad nullable: true endDate: type: string description: "The date when when we will stop to show this ad. If the end date is not specified (i.e. null) then the ad will go on forever\r\nString must be in ISO8601 format" nullable: true id: type: string nullable: true inventoryType: enum: - Native - Display - Video type: string description: >- The inventory the Ad belongs to. Possible values are "Display" and "Native". This is optional since this doesn't make sense for every creative type but will throw an error if not set for a dynamic creative. nullable: true name: type: string description: The name of the ad nullable: true startDate: type: string description: "The date when the ad will be launched\r\nString must be in ISO8601 format" nullable: true description: An ad is the binding that connects a creative with an ad set nullable: true ExamAdClickTracking: type: object properties: bindingId: type: string description: "Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused." nullable: true clickZone: enum: - Unknown - AppInstall - Coupon - Logo - Main - Product - Store - Video - BrandingImage type: string description: "The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"." nullable: true disableForCoupons: type: boolean description: Whether this rule is skipped for clicks on coupons. nullable: true disableLandingUrlEncode: type: boolean description: >- Whether the landing url is left unencoded when it is substituted into the tracking url. nullable: true disableMacroUrlEncode: type: boolean description: >- Whether url macros are left unencoded when they are substituted into the tracking url. nullable: true displayHeight: type: integer description: "The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size." format: int32 nullable: true displayWidth: type: integer description: "The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size." format: int32 nullable: true id: type: string description: "Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted." nullable: true urlPrefix: type: string description: The url prepended to the landing url of the clicks this rule covers. nullable: true urlSuffix: type: string description: The url appended to the landing url of the clicks this rule covers. nullable: true description: "An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)." ExamAdImpressionTracking: type: object properties: bindingId: type: string description: "Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused." nullable: true displayHeight: type: integer description: "The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size." format: int32 nullable: true displayWidth: type: integer description: "The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size." format: int32 nullable: true id: type: string description: "Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted." nullable: true url: type: string description: The url called when an impression covered by this rule is served. nullable: true vendorId: type: string description: Unique ID of the third party vendor the tracking url belongs to. nullable: true description: "An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)." 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: {} ````