> ## 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 changes > Récupérer les modifications associées à un contrat spécifique dans votre compte HubSpot. Ce point de terminaison vous permet de visualiser toutes les modifications apportées à un contrat, ce qui peut être utile pour suivre l'historique du contrat et comprendre l'évolution de ses conditions. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/commerce-contracts-v2027-03-beta.json GET /commerce/contracts/2027-03-beta/contracts/{contractId}/changes openapi: 3.0.1 info: title: Commerce Contracts description: Basepom for all HubSpot Projects version: 2027-03-beta 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: Basic - name: Changes paths: /commerce/contracts/2027-03-beta/contracts/{contractId}/changes: get: tags: - Changes summary: Récupérer les modifications description: >- Récupérer les modifications associées à un contrat spécifique dans votre compte HubSpot. Ce point de terminaison vous permet de visualiser toutes les modifications apportées à un contrat, ce qui peut être utile pour suivre l'historique du contrat et comprendre l'évolution de ses conditions. operationId: get-/commerce/contracts/2027-03-beta/contracts/{contractId}/changes parameters: - name: contractId in: path description: >- L'identifiant unique du contrat pour lequel les modifications sont récupérées. required: true style: simple explode: false schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ContractChangesResponse' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: ContractChangesResponse: required: - changes type: object properties: changes: type: array description: "Un tableau de résumés des modifications de contrat\_: chaque élément du tableau fournit des détails sur une modification spécifique apportée au contrat, représentée par le schéma ContractChangeSummaryResponse." items: $ref: '#/components/schemas/ContractChangeSummaryResponse' ContractChangeSummaryResponse: required: - contractId - id - lineItemChanges - prorating - status - type type: object properties: contractId: type: string description: L'identifiant unique du contrat associé à cette modification. createdAt: type: string description: >- La date et l'heure de création de cette modification de contrat, au format ISO 8601. format: date-time effectiveDate: type: string description: "La date d'entrée en vigueur de cette modification de contrat, au format «\_JJ/MM/AAAA\_»." format: date id: type: string description: L'identifiant unique de cette modification de contrat. lineItemChanges: type: array description: >- Un ensemble de modifications apportées aux lignes de produit dans le cadre de cette modification de contrat. items: $ref: '#/components/schemas/LineItemChangeResponse' name: type: string description: Le nom attribué à cette modification de contrat. prorating: type: boolean description: >- Un booléen indiquant si le changement de contrat implique un prorata. quoteId: type: string description: >- L'identifiant unique du devis associé à cette modification de contrat, le cas échéant. status: type: string description: "Le statut actuel de la modification du contrat. Les valeurs valides incluent «\_BROUILLON\_», «\_PROPOSÉ\_», «\_ACCEPTÉ\_», « ANNULÉ », «\_ÉCHOUÉ\_» et «\_EXPIRÉ\_»." enum: - ACCEPTED - CANCELED - DRAFT - EXPIRED - FAILED - PROPOSED type: type: string description: "Le type de modification de contrat, qui peut être «\_DIRECT\_» ou «\_DEVIS\_»." enum: - DIRECT - QUOTE updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de cette modification de contrat, au format ISO 8601. format: date-time Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, fourni sous la forme d'un objet avec des propriétés supplémentaires qui sont des tableaux de chaînes de caractères. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. Il est formaté comme un UUID. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Information supplémentaire sur l'erreur, représentée sous forme de tableau d'objets ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant la documentation sur l'erreur ou les étapes de remédiation recommandées. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les étapes de remédiation appropriées, le cas échéant. example: An error occurred 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 propriété de type 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 LineItemChangeResponse: required: - action - rampKey type: object properties: action: type: string description: "Le type d'action effectué sur la ligne de produit. Les valeurs valides incluent «\_ADD\_», «\_UPDATE\_» et «\_REMOVE\_»." enum: - ADD - ADD_PHASE - PAUSE - REMOVE - REMOVE_PHASE - RESUME - UPDATE - UPDATE_PHASE lineItemAdd: description: "Un objet représentant les détails de la ligne de produit ajoutée si l'action était «\_ADD\_». Il peut s'agir de plusieurs types, tels que personnalisé, issu d'un produit ou un clone." oneOf: - $ref: '#/components/schemas/LineItemCustomCreateRequest' - $ref: '#/components/schemas/LineItemFromProductCreateRequest' - $ref: '#/components/schemas/LineItemCloneCreateRequest' lineItemUpdate: $ref: '#/components/schemas/LineItemChangeUpdate' rampKey: type: string description: >- Un identifiant unique pour la modification de la ligne de produit, formaté en tant que UUID. format: uuid ErrorDetail: required: - message type: object properties: code: type: string description: >- Le code de statut associé au détail de l'erreur, représenté sous forme de chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, représenté sous forme d'objet où chaque clé est une chaîne et chaque valeur est un tableau de chaînes. Ceci fournit des informations supplémentaires sur l'erreur. 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'un champ de chaîne facultatif. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur, accompagné, le cas échéant, des étapes de correction. Ce champ est obligatoire et est de type 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, fournie sous forme de chaîne de caractères. 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. LineItemCustomCreateRequest: title: CUSTOM required: - mode - name - pricing - quantity type: object properties: allowBuyerSelectedQuantity: type: boolean description: >- Un booléen indiquant si l'acheteur peut sélectionner la quantité de la ligne de produit. billingCycleAnchorDate: type: string description: >- Une chaîne au format de date représentant la date d'ancrage du cycle de facturation. format: date billingStartDelayDays: type: integer description: >- Un entier indiquant le délai en jours avant le début de la facturation. format: int32 billingStartDelayMonths: type: integer description: >- Un entier représentant le délai en mois avant le début de la facturation. format: int32 buyerSelectedQuantityMax: type: number description: >- Un nombre représentant la quantité maximale que l'acheteur peut sélectionner. buyerSelectedQuantityMin: type: number description: >- Un nombre indiquant la quantité minimale que l'acheteur peut sélectionner. description: type: string description: Une chaîne fournissant une description de la ligne de produit. discount: type: number description: >- Un nombre représentant le montant de la remise appliquée à la ligne de produit. discountPercentage: type: number description: >- Un nombre indiquant le pourcentage de remise appliqué à la ligne de produit. externalId: type: string description: >- Une chaîne représentant un identifiant externe pour la ligne de produit. images: type: string description: >- Une chaîne contenant les URL d'images associées à la ligne de produit. isEditablePrice: type: boolean description: >- Un booléen indiquant si le prix de la ligne de produit est modifiable. isOptional: type: boolean description: Un booléen indiquant si la ligne de produit est facultative. lineItemCurrencyCode: type: string description: Une chaîne indiquant le code de devise pour la ligne de produit. mode: type: string description: "Une chaîne indiquant le mode de la ligne de produit, qui est «\_CUSTOM\_» par défaut." default: CUSTOM enum: - CUSTOM name: type: string description: Chaîne de caractères représentant le nom de la ligne de produit. positionOnQuote: type: integer description: Un entier indiquant la position de la ligne de produit sur le devis. format: int32 priceBookId: type: string description: >- Une chaîne indiquant l'ID du catalogue des prix associé à la ligne de produit. pricing: $ref: '#/components/schemas/PricingFullUpdateRequest' productId: type: string description: >- Chaîne de caractères représentant l'ID du produit associé à la ligne de produit. productType: type: string description: Une chaîne indiquant le type de produit pour la ligne de produit. quantity: type: number description: Un nombre indiquant la quantité de la ligne de produit. recurringBillingEndDate: type: string description: >- Chaîne de caractères au format de date représentant la date de fin de la facturation récurrente. format: date recurringBillingFrequency: type: string description: "Une chaîne représentant la fréquence de facturation récurrente\_: les valeurs valides incluent «\_ANNUELLEMENT\_», «\_DEUX FOIS PAR SEMAINE\_», «\_TOUS LES MOIS\_», «\_TOUS LES CINQ ANS\_», «\_TOUS LES QUATRE ANS\_», «\_TOUS LES SIX MOIS\_», «\_TOUS LES TROIS ANS\_», «\_TOUS LES DEUX ANS\_», «\_TOUS LES TRIMESTRES\_», «\_TOUTES LES SEMAINES\_»." enum: - ANNUALLY - BIWEEKLY - MONTHLY - PER_FIVE_YEARS - PER_FOUR_YEARS - PER_SIX_MONTHS - PER_THREE_YEARS - PER_TWO_YEARS - QUARTERLY - WEEKLY recurringBillingPeriod: type: string description: Une chaîne indiquant la période de facturation récurrente. recurringBillingStartDate: type: string description: >- Une chaîne au format de date indiquant la date de début de la facturation récurrente. format: date richTextDescription: type: string description: >- Une chaîne contenant une description en texte enrichi de la ligne de produit. sku: type: string description: >- Une chaîne représentant l'unité de gestion des stocks (UGS) de la ligne de produit. taxCategory: type: string description: >- Une chaîne de caractères représentant la catégorie de taxe pour la ligne de produit. taxRateGroupId: type: string description: >- Une chaîne de caractères indiquant l'ID du groupe de taux de taxe applicable à la ligne de produit. variantId: type: string description: Une chaîne représentant l'ID de la variante du produit. x-hubspot-sub-type-impl: true LineItemFromProductCreateRequest: title: FROM_PRODUCT required: - allowBuyerSelectedQuantity - billingCycleAnchorDate - billingStartDelayDays - billingStartDelayMonths - buyerSelectedQuantityMax - buyerSelectedQuantityMin - description - discount - discountPercentage - externalId - images - isEditablePrice - isOptional - lineItemCurrencyCode - mode - name - positionOnQuote - priceBookId - pricing - productId - productType - quantity - recurringBillingEndDate - recurringBillingFrequency - recurringBillingPeriod - recurringBillingStartDate - richTextDescription - sku - taxCategory - taxRateGroupId - variantId type: object properties: allowBuyerSelectedQuantity: type: object properties: {} description: >- Un objet indiquant si l'acheteur peut sélectionner la quantité de la ligne de produit. billingCycleAnchorDate: type: object properties: {} description: Un objet représentant la date d'ancrage du cycle de facturation. billingStartDelayDays: type: object properties: {} description: >- Un objet représentant le délai en jours avant le début de la facturation. billingStartDelayMonths: type: object properties: {} description: >- Un objet représentant le délai en mois avant le début de la facturation. buyerSelectedQuantityMax: type: object properties: {} description: >- Un objet représentant la quantité maximale que l'acheteur peut sélectionner. buyerSelectedQuantityMin: type: object properties: {} description: >- Un objet représentant la quantité minimale que l'acheteur peut sélectionner. description: type: object properties: {} description: Un objet fournissant une description de la ligne de produit. discount: type: object properties: {} description: Un objet représentant la remise appliquée à la ligne de produit. discountPercentage: type: object properties: {} description: >- Un objet représentant le pourcentage de remise appliqué à la ligne de produit. externalId: type: object properties: {} description: >- Un objet représentant un identifiant externe pour la ligne de produit. images: type: object properties: {} description: Un objet contenant les images associées à la ligne de produit. isEditablePrice: type: object properties: {} description: Un objet indiquant si le prix de la ligne de produit est modifiable. isOptional: type: object properties: {} description: Un objet indiquant si la ligne de produit est facultative. lineItemCurrencyCode: type: object properties: {} description: Un objet représentant le code de devise pour la ligne de produit. mode: type: string description: "Une chaîne de caractères indiquant le mode de création de la ligne de produit, avec une valeur par défaut de «\_FROM_PRODUCT\_»." default: FROM_PRODUCT enum: - FROM_PRODUCT name: type: object properties: {} description: Un objet représentant le nom de la ligne de produit. positionOnQuote: type: object properties: {} description: Un objet indiquant la position de la ligne de produit sur le devis. priceBookId: type: object properties: {} description: >- Un objet représentant l'ID du catalogue des prix associé à la ligne de produit. pricing: type: object properties: {} description: >- Un objet représentant les détails de tarification de la ligne de produit. productId: type: string description: >- Une chaîne représentant l'ID du produit associé à la ligne de produit. productType: type: object properties: {} description: Un objet représentant le type de produit pour la ligne de produit. quantity: type: object properties: {} description: >- Un objet représentant la quantité du produit pour la ligne de produit. recurringBillingEndDate: type: object properties: {} description: Un objet représentant la date de fin de la facturation récurrente. recurringBillingFrequency: type: object properties: {} description: >- Un objet représentant la fréquence de la facturation récurrente pour la ligne de produit. recurringBillingPeriod: type: object properties: {} description: Un objet représentant la période de facturation récurrente. recurringBillingStartDate: type: object properties: {} description: Un objet représentant la date de début de la facturation récurrente. richTextDescription: type: object properties: {} description: >- Un objet fournissant une description en texte enrichi de la ligne de produit. sku: type: object properties: {} description: >- Un objet représentant l'unité de gestion des stocks (UGS) du produit. taxCategory: type: object properties: {} description: Un objet représentant la catégorie de taxe de la ligne de produit. taxRateGroupId: type: object properties: {} description: >- Un objet représentant l'ID du groupe de taux de taxe pour la ligne de produit. variantId: type: object properties: {} description: Un objet représentant l'ID de la variante du produit. x-hubspot-sub-type-impl: true LineItemCloneCreateRequest: title: CLONE required: - allowBuyerSelectedQuantity - billingCycleAnchorDate - billingStartDelayDays - billingStartDelayMonths - buyerSelectedQuantityMax - buyerSelectedQuantityMin - description - discount - discountPercentage - externalId - images - isEditablePrice - isOptional - lineItemCurrencyCode - mode - name - positionOnQuote - priceBookId - pricing - productType - quantity - recurringBillingEndDate - recurringBillingFrequency - recurringBillingPeriod - recurringBillingStartDate - richTextDescription - sku - sourceLineItemId - taxCategory - taxRateGroupId - variantId type: object properties: allowBuyerSelectedQuantity: type: object properties: {} description: >- Un objet indiquant si l'acheteur peut sélectionner la quantité de la ligne de produit. billingCycleAnchorDate: type: object properties: {} description: >- Un objet représentant la date d'ancrage pour le cycle de facturation de la ligne de produit. billingStartDelayDays: type: object properties: {} description: >- Un objet représentant le nombre de jours pour retarder le début de la facturation de la ligne de produit. billingStartDelayMonths: type: object properties: {} description: >- Un objet représentant le nombre de mois pour retarder le début de la facturation de la ligne de produit. buyerSelectedQuantityMax: type: object properties: {} description: >- Un objet représentant la quantité maximale que l'acheteur peut sélectionner. buyerSelectedQuantityMin: type: object properties: {} description: >- Un objet représentant la quantité minimale que l'acheteur peut sélectionner. description: type: object properties: {} description: Un objet représentant la description de la ligne de produit. discount: type: object properties: {} description: Un objet représentant la remise appliquée à la ligne de produit. discountPercentage: type: object properties: {} description: >- Un objet représentant le pourcentage de remise appliqué à la ligne de produit. externalId: type: object properties: {} description: >- Un objet représentant un identifiant externe pour la ligne de produit. images: type: object properties: {} description: Un objet représentant les images associées à la ligne de produit. isEditablePrice: type: object properties: {} description: Un objet indiquant si le prix de la ligne de produit est modifiable. isOptional: type: object properties: {} description: Un objet indiquant si la ligne de produit est facultative. lineItemCurrencyCode: type: object properties: {} description: Un objet représentant le code de devise pour la ligne de produit. mode: type: string description: "Une chaîne indiquant le mode de la ligne de produit, avec une valeur par défaut de «\_CLONE\_»." default: CLONE enum: - CLONE name: type: object properties: {} description: Un objet représentant le nom de la ligne de produit. positionOnQuote: type: object properties: {} description: >- Un objet représentant la position de la ligne de produit sur le devis. priceBookId: type: object properties: {} description: >- Un objet représentant l'ID du catalogue des prix associé à la ligne de produit. pricing: type: object properties: {} description: >- Un objet représentant les détails de tarification de la ligne de produit. productType: type: object properties: {} description: Un objet représentant le type de produit pour la ligne de produit. quantity: type: object properties: {} description: Un objet représentant la quantité de la ligne de produit. recurringBillingEndDate: type: object properties: {} description: >- Un objet représentant la date de fin de la facturation récurrente pour la ligne de produit. recurringBillingFrequency: type: object properties: {} description: >- Un objet représentant la fréquence de la facturation récurrente pour la ligne de produit. recurringBillingPeriod: type: object properties: {} description: >- Un objet représentant la période de facturation récurrente pour la ligne de produit. recurringBillingStartDate: type: object properties: {} description: >- Un objet représentant la date de début de la facturation récurrente pour la ligne de produit. richTextDescription: type: object properties: {} description: >- Un objet représentant la description en texte enrichi de la ligne de produit. sku: type: object properties: {} description: >- Un objet représentant l'unité de gestion des stocks (UGS) de la ligne de produit. sourceLineItemId: type: string description: Chaîne représentant l'ID de la ligne de produit source à cloner. taxCategory: type: object properties: {} description: Un objet représentant la catégorie de taxe de la ligne de produit. taxRateGroupId: type: object properties: {} description: >- Un objet représentant l'ID du groupe de taux de taxe pour la ligne de produit. variantId: type: object properties: {} description: Un objet représentant l'ID de la variante de la ligne de produit. x-hubspot-sub-type-impl: true LineItemChangeUpdate: required: - allowBuyerSelectedQuantity - billingCycleAnchorDate - billingStartDelayDays - billingStartDelayMonths - buyerSelectedQuantityMax - buyerSelectedQuantityMin - description - discount - discountPercentage - externalId - images - isEditablePrice - isOptional - lineItemCurrencyCode - name - positionOnQuote - priceBookId - pricing - productType - quantity - recurringBillingEndDate - recurringBillingFrequency - recurringBillingPeriod - recurringBillingStartDate - richTextDescription - sku - taxCategory - taxRateGroupId - variantId type: object properties: allowBuyerSelectedQuantity: type: object properties: {} description: >- Un objet indiquant si l'acheteur peut sélectionner la quantité de la ligne de produit. billingCycleAnchorDate: type: object properties: {} description: >- Un objet représentant la date d'ancrage pour le cycle de facturation de la ligne de produit. billingStartDelayDays: type: object properties: {} description: >- Un objet représentant le nombre de jours pour retarder le début de la facturation de la ligne de produit. billingStartDelayMonths: type: object properties: {} description: >- Un objet représentant le nombre de mois pour retarder le début de la facturation de la ligne de produit. buyerSelectedQuantityMax: type: object properties: {} description: >- Un objet représentant la quantité maximale qu'un acheteur peut sélectionner pour la ligne de produit. buyerSelectedQuantityMin: type: object properties: {} description: >- Un objet représentant la quantité minimale qu'un acheteur peut sélectionner pour la ligne de produit. description: type: object properties: {} description: Un objet représentant la description de la ligne de produit. discount: type: object properties: {} description: Un objet représentant la remise appliquée à la ligne de produit. discountPercentage: type: object properties: {} description: >- Un objet représentant le pourcentage de remise appliqué à la ligne de produit. externalId: type: object properties: {} description: >- Un objet représentant un identifiant externe pour la ligne de produit. images: type: object properties: {} description: Un objet représentant les images associées à la ligne de produit. isEditablePrice: type: object properties: {} description: Un objet indiquant si le prix de la ligne de produit est modifiable. isOptional: type: object properties: {} description: Un objet indiquant si la ligne de produit est facultative. lineItemCurrencyCode: type: object properties: {} description: Un objet représentant le code de devise pour la ligne de produit. name: type: object properties: {} description: Un objet représentant le nom de la ligne de produit. positionOnQuote: type: object properties: {} description: >- Un objet représentant la position de la ligne de produit sur le devis. priceBookId: type: object properties: {} description: >- Un objet représentant l'ID du catalogue des prix associé à la ligne de produit. pricing: type: object properties: {} description: >- Un objet représentant les détails de tarification de la ligne de produit. productType: type: object properties: {} description: Un objet représentant le type de produit pour la ligne de produit. quantity: type: object properties: {} description: Un objet représentant la quantité de la ligne de produit. recurringBillingEndDate: type: object properties: {} description: >- Un objet représentant la date de fin de la facturation récurrente pour la ligne de produit. recurringBillingFrequency: type: object properties: {} description: >- Un objet représentant la fréquence de la facturation récurrente pour la ligne de produit. recurringBillingPeriod: type: object properties: {} description: >- Un objet représentant la période de facturation pour la facturation récurrente de la ligne de produit. recurringBillingStartDate: type: object properties: {} description: >- Un objet représentant la date de début de la facturation récurrente pour la ligne de produit. richTextDescription: type: object properties: {} description: >- Un objet représentant la description en texte enrichi de la ligne de produit. sku: type: object properties: {} description: >- Un objet représentant l'unité de gestion des stocks (UGS) de la ligne de produit. taxCategory: type: object properties: {} description: Un objet représentant la catégorie de taxe de la ligne de produit. taxRateGroupId: type: object properties: {} description: >- Un objet représentant l'ID du groupe de taux de taxe pour la ligne de produit. variantId: type: object properties: {} description: Un objet représentant l'ID de la variante de la ligne de produit. PricingFullUpdateRequest: required: - prices - pricingModel type: object properties: prices: type: array description: >- Un tableau d'entrées de prix qui définissent les détails de tarification spécifiques pour le contrat. Chaque entrée inclut des informations sur la devise et le prix. items: $ref: '#/components/schemas/PriceUpdateEntry' pricingModel: type: string description: "Le modèle de tarification appliqué au contrat. Les valeurs valides incluent «\_FLAT\_», «\_GRADUATED\_», «\_STAIRSTEP\_» et «\_VOLUME\_»." enum: - FLAT - GRADUATED - STAIRSTEP - VOLUME PriceUpdateEntry: required: - currencyCode - price type: object properties: currencyCode: type: string description: >- Une chaîne représentant la devise dans laquelle le prix est spécifié. maxQuantity: type: integer description: >- Un entier indiquant la quantité maximale applicable pour cette entrée de prix. format: int32 price: type: object properties: {} description: Un objet représentant les détails du prix pour l'entrée. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````