> ## 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 budget details > Récupérer des informations détaillées sur le budget et les dépenses, y compris les totaux, pour une campagne marketing spécifique. Ce point de terminaison fournit des informations sur les aspects financiers d'une campagne, aidant les utilisateurs à gérer et à analyser efficacement les allocations budgétaires et les modèles de dépenses. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-campaigns-public-api-v2026-09.json GET /marketing/campaigns/2026-09/{campaignGuid}/budget/totals 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}/budget/totals: get: tags: - Budget summary: Récupérer les détails du budget description: >- Récupérer des informations détaillées sur le budget et les dépenses, y compris les totaux, pour une campagne marketing spécifique. Ce point de terminaison fournit des informations sur les aspects financiers d'une campagne, aidant les utilisateurs à gérer et à analyser efficacement les allocations budgétaires et les modèles de dépenses. operationId: get-/marketing/campaigns/2026-09/{campaignGuid}/budget/totals parameters: - name: campaignGuid in: path description: >- L'identifiant unique de la campagne pour laquelle les totaux budgétaires sont récupérés. required: true style: simple explode: false schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicBudgetTotals' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.campaigns.read components: schemas: PublicBudgetTotals: required: - budgetItems - currencyCode - spendItems type: object properties: budgetItems: type: array description: >- Un tableau d'éléments budgétaires associés à la campagne, chacun représenté par un objet PublicBudgetItem. items: $ref: '#/components/schemas/PublicBudgetItem' budgetTotal: type: number description: Le montant total du budget alloué à la campagne, exprimé en nombre. currencyCode: type: string description: "Le code de devise utilisé pour les montants de budget et de dépenses, représenté sous forme de chaîne de caractères. Les valeurs valides incluent les codes de devise standard tels que «\_USD\_», «\_EUR\_», «\_JPY\_», etc." enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BOV - BRL - BSD - BTN - BWP - BYN - BZD - CAD - CDF - CHE - CHF - CHW - CLF - CLP - CNY - COP - COU - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MXV - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - SSP - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - USN - UYI - UYU - UZS - VEF - VND - VUV - WST - XAF - XAG - XAU - XBA - XBB - XBC - XBD - XCD - XDR - XOF - XPD - XPF - XPT - XSU - XUA - YER - ZAR - ZMW - ZWL remainingBudget: type: number description: >- Le budget restant disponible pour la campagne, calculé comme la différence entre le budgetTotal et le spendTotal, exprimé en nombre. spendItems: type: array description: >- Un tableau d'éléments de dépenses associés à la campagne, chacun représenté par un objet PublicSpendItem. items: $ref: '#/components/schemas/PublicSpendItem' spendTotal: type: number description: >- Le montant total dépensé pour la campagne, exprimé sous forme de nombre. PublicBudgetItem: required: - amount - createdAt - id - name - order - updatedAt type: object properties: amount: type: number description: >- Le montant financier alloué à cet élément budgétaire, représenté par un nombre. createdAt: type: integer description: >- Un horodatage Unix en millisecondes indiquant la date de création de cet élément budgétaire. format: int64 description: type: string description: >- Une description de l'élément budgétaire, représentée sous forme de chaîne de caractères. id: type: string description: >- L'identifiant unique de ce poste budgétaire, représenté sous forme de chaîne de caractères. name: type: string description: >- Le nom du poste budgétaire, représenté sous forme de chaîne de caractères. order: type: integer description: >- Un entier représentant l'ordre ou la séquence de cet élément budgétaire au sein de la campagne. format: int32 updatedAt: type: integer description: >- Un horodatage Unix en millisecondes indiquant la dernière mise à jour de cet élément de budget. format: int64 PublicSpendItem: required: - amount - createdAt - id - name - order - updatedAt type: object properties: amount: type: number description: >- Le montant financier associé à l'élément de dépense, représenté par un nombre. createdAt: type: integer description: >- Un horodatage Unix en millisecondes indiquant la date de création de l'élément de dépense. format: int64 description: type: string description: >- Chaîne de caractères fournissant des détails supplémentaires sur le poste de dépense. id: type: string description: >- L'identifiant unique du poste de dépense, représenté sous forme de chaîne de caractères. name: type: string description: >- Le nom du poste de dépense, représenté sous forme de chaîne de caractères. order: type: integer description: Un entier indiquant l'ordre ou la séquence du poste de dépense. format: int32 updatedAt: type: integer description: >- Un horodatage Unix en millisecondes indiquant la dernière mise à jour du poste de dépense. 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 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. 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: '' ````