> ## 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. # Retrieve a campaign > Récupérer les détails d'une campagne marketing spécifique identifiée par son ID interne. Ce point de terminaison vous permet d'accéder aux informations de la campagne et aux ressources associées. Il est utile pour obtenir des données de campagne à des fins d'analyse ou de reporting. Si les propriétés à retourner ne sont pas définies avec le paramètre de requête « properties », la réponse inclura une carte de propriétés vide. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-campaigns-public-api-v2026-09.json GET /marketing/campaigns/2026-09/{campaignGuid} 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/{campaignGuid}: get: tags: - Basic summary: Récupérer une campagne description: "Récupérer les détails d'une campagne marketing spécifique identifiée par son ID interne. Ce point de terminaison vous permet d'accéder aux informations de la campagne et aux ressources associées. Il est utile pour obtenir des données de campagne à des fins d'analyse ou de reporting. Si les propriétés à retourner ne sont pas définies avec le paramètre de requête «\_properties\_», la réponse inclura une carte de propriétés vide." operationId: get-/marketing/campaigns/2026-09/{campaignGuid} parameters: - name: campaignGuid in: path description: L'identifiant unique de la campagne à récupérer. required: true style: simple explode: false schema: type: string - name: endDate in: query description: >- La date de fin pour le filtrage des données de campagne, au format AAAA-MM-JJ. 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 données de campagne, au format AAAA-MM-JJ. required: false style: form explode: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicCampaignWithAssets' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.campaigns.read components: schemas: 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 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 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 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. 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. 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: '' ````