> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Batch retrieve campaigns > Récupérez un lot de campagnes en utilisant les paramètres spécifiés. Ce point de terminaison vous permet de filtrer les campagnes par plage de dates et de sélectionner des propriétés spécifiques à inclure dans la réponse. Il est utile pour obtenir des informations détaillées sur plusieurs campagnes à la fois. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-campaigns-public-api-v2026-09.json POST /marketing/campaigns/2026-09/batch/read openapi: 3.0.1 info: title: Marketing Campaigns Public Api description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Assets - name: Basic - name: Batch - name: Budget - name: Reports - name: Spend paths: /marketing/campaigns/2026-09/batch/read: post: tags: - Batch summary: Récupérer des campagnes par lot description: >- Récupérez un lot de campagnes en utilisant les paramètres spécifiés. Ce point de terminaison vous permet de filtrer les campagnes par plage de dates et de sélectionner des propriétés spécifiques à inclure dans la réponse. Il est utile pour obtenir des informations détaillées sur plusieurs campagnes à la fois. operationId: post-/marketing/campaigns/2026-09/batch/read parameters: - name: endDate in: query description: >- La date de fin pour le filtrage des campagnes, formatée en tant que chaîne de caractères. required: false style: form explode: true schema: type: string - name: properties in: query description: >- Une liste de noms de propriétés séparés par des virgules à inclure dans la réponse. required: false style: form explode: true schema: type: array items: type: string - name: startDate in: query description: >- La date de début pour le filtrage des campagnes, formatée en tant que chaîne de caractères. required: false style: form explode: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchInputPublicCampaignReadInput' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponsePublicCampaignWithAssets' '207': description: multiple statuses content: application/json: schema: $ref: >- #/components/schemas/BatchResponsePublicCampaignWithAssetsWithErrors default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.campaigns.read components: schemas: BatchInputPublicCampaignReadInput: required: - inputs type: object properties: inputs: type: array description: >- Un tableau d’objets PublicCampaignReadInput, chacun contenant l’ID d’une campagne à lire. Cette propriété est obligatoire. items: $ref: '#/components/schemas/PublicCampaignReadInput' BatchResponsePublicCampaignWithAssets: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées, fournissant des ressources ou une documentation supplémentaires liées à l'opération de lot. requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un tableau d'objets PublicCampaignWithAssets, représentant les campagnes impliquées dans l'opération de lot. items: $ref: '#/components/schemas/PublicCampaignWithAssets' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponsePublicCampaignWithAssetsWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time errors: type: array description: >- Un tableau d'erreurs survenues pendant l'opération par lot, chacune décrite par un objet d'erreur standard. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées qui fournissent des informations supplémentaires sur l'opération de lot. numErrors: type: integer description: Le nombre d'erreurs survenues pendant l'opération par lot. format: int32 requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un ensemble de campagnes avec leurs ressources associées qui ont été traitées dans l'opération par lot. items: $ref: '#/components/schemas/PublicCampaignWithAssets' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING PublicCampaignReadInput: required: - id type: object properties: id: type: string description: >- L'identifiant unique de la campagne. Il s'agit d'une chaîne de caractères et il est nécessaire pour récupérer les détails de la campagne. PublicCampaignWithAssets: required: - assets - businessUnits - createdAt - id - properties - updatedAt type: object properties: assets: type: object additionalProperties: $ref: '#/components/schemas/CollectionResponsePublicCampaignAsset' description: >- Une carte des types d'actifs et de leurs collections respectives d'actifs de campagne, représentées par des objets CollectionResponsePublicCampaignAsset. businessUnits: type: array description: >- Un tableau d'unités commerciales associées à la campagne, chacune représentée par un objet PublicBusinessUnit. items: $ref: '#/components/schemas/PublicBusinessUnit' createdAt: type: string description: La date et l'heure de création de la campagne, au format ISO 8601. format: date-time id: type: string description: >- L'identifiant unique de la campagne, représenté sous forme de chaîne de caractères. properties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés personnalisées et de leurs valeurs, où chaque valeur est une chaîne de caractères. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de la campagne, au format ISO 8601. format: date-time StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Une chaîne catégorisant le type d'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte supplémentaire sur l'erreur, avec des clés comme des noms de contexte et des valeurs comme des tableaux de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des informations supplémentaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Une chaîne représentant un identifiant unique pour l'erreur. links: type: object additionalProperties: type: string description: >- Un objet associant des noms de liens à des URI associées qui contiennent de la documentation ou des étapes de correction liées à l'erreur. message: type: string description: Message lisible par l'être humain décrivant l'erreur. status: type: string description: Une chaîne indiquant le statut de l'erreur. subCategory: type: object properties: {} description: Un objet fournissant une catégorisation plus spécifique de l'erreur. description: Ye olde error Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet fournissant un contexte sur la condition d'erreur, où chaque clé est une chaîne de caractères et chaque valeur est un tableau de chaînes. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête, formaté comme un UUID. Celui-ci doit être inclus dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau fournissant des informations supplémentaires sur l'erreur, chaque élément étant un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées contenant de la documentation sur l'erreur ou les étapes de correction recommandées, représentée sous forme d'objet avec des valeurs de chaîne. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur, représentée sous forme de chaîne de caractères. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base CollectionResponsePublicCampaignAsset: required: - results type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: >- Un tableau d'objets PublicCampaignAsset, chacun représentant un actif de campagne individuel. items: $ref: '#/components/schemas/PublicCampaignAsset' PublicBusinessUnit: required: - id type: object properties: id: type: integer description: >- L'identifiant unique de l'unité commerciale, représenté sous la forme d'un entier de 64 bits. format: int64 ErrorDetail: required: - message type: object properties: code: type: string description: >- Le code de statut associé au détail de l'erreur. Il s'agit d'une chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, fourni sous forme d'objet où chaque clé est un nom de contexte et la valeur est un tableau de chaînes de caractères fournissant des informations supplémentaires. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. Il s'agit d'une chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Il s'agit d'une chaîne. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. Paging: type: object properties: next: $ref: '#/components/schemas/NextPage' prev: $ref: '#/components/schemas/PreviousPage' description: >- Représente les informations de pagination pour naviguer dans une liste de résultats de l'API. Il fournit des détails sur la manière d'accéder à l'ensemble de résultats précédent ou suivant. PublicCampaignAsset: required: - id type: object properties: id: type: string description: >- L'identifiant unique de l'actif de campagne, représenté sous forme de chaîne de caractères. metrics: type: object additionalProperties: type: number description: >- Une collection de métriques de performance pour l'actif de campagne, représentée sous forme de carte où chaque clé est un nom de métrique et chaque valeur est un nombre. name: type: string description: >- Le nom de l'actif de campagne, représenté sous forme de chaîne de caractères. NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne qui sert de curseur de pagination, indiquant la position après la dernière ressource lue. link: type: string description: >- Une URL de chaîne qui fournit un lien vers la page de résultats suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PreviousPage: required: - before type: object properties: before: type: string description: >- Un jeton de chaîne utilisé pour identifier la position avant la page actuelle dans les résultats paginés. link: type: string description: >- Chaîne d'URL qui fournit un lien vers la page de résultats précédente. description: >- specifies the paging information needed to retrieve the previous set of results in a paginated API response responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: marketing.campaigns.read: '' marketing.campaigns.revenue.full.read: '' marketing.campaigns.revenue.lite.read: '' marketing.campaigns.revenue.read: '' marketing.campaigns.write: '' ````