> ## 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 history > Récupérez l'historique des valeurs de score pour un type d'objet et un ID spécifiques dans le cadre du score des leads. Ce point de terminaison vous permet de suivre les changements au fil du temps, jusqu'aux 90 derniers jours, ce qui peut être utile pour analyser les tendances et comprendre comment les scores ont évolué. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/marketing-lead-scoring-v2027-03-beta.json GET /marketing/lead-scoring/2027-03-beta/score-values/object-history openapi: 3.0.1 info: title: Marketing Lead Scoring 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 paths: /marketing/lead-scoring/2027-03-beta/score-values/object-history: get: tags: - Basic summary: Récupérer l'historique description: "Récupérez l'historique des valeurs de score pour un type d'objet et un ID spécifiques dans le cadre du score des leads. Ce point de terminaison vous permet de suivre les changements au fil du temps, jusqu'aux 90\_derniers jours, ce qui peut être utile pour analyser les tendances et comprendre comment les scores ont évolué." operationId: get-/marketing/lead-scoring/2027-03-beta/score-values/object-history parameters: - name: after in: query description: "Le jeton de curseur de pagination de la dernière ressource lue avec succès, utilisé pour la pagination. Ce jeton est renvoyé en tant que propriété JSON «\_paging.next.after\_» d'une réponse paginée contenant plus de résultats." required: false style: form explode: true schema: type: string - name: limit in: query description: "Le nombre maximal de résultats à afficher par page\_: la valeur par défaut est 100." required: false style: form explode: true schema: type: integer format: int32 default: 100 - name: objectId in: query description: >- L'identifiant unique de l'objet pour lequel l'historique des scores est récupéré, spécifié sous forme d'entier. required: false style: form explode: true schema: type: integer format: int64 - name: objectTypeId in: query description: >- Le type d'objet pour lequel l'historique des scores est récupéré, spécifié sous forme de chaîne de caractères. required: false style: form explode: true schema: type: string - name: outputProperty in: query description: >- La propriété spécifique de la sortie du score à inclure dans la réponse, spécifiée sous forme de chaîne de caractères. required: false style: form explode: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePublicScoreHistoryEntryForwardPaging default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: CollectionResponsePublicScoreHistoryEntryForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array description: >- Un tableau d'objets PublicScoreHistoryEntry, chacun représentant une entrée historique des changements de score pour un objet. items: $ref: '#/components/schemas/PublicScoreHistoryEntry' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: "Informations de pagination pour une pagination unidirectionnelle. Contient la référence de la page suivante lorsque d'autres résultats sont disponibles\_; omis ou vide sur la dernière page." PublicScoreHistoryEntry: required: - renderedEvents - resolvedListIds - resolvedProperties - timestamp type: object properties: delta: type: number description: Un nombre représentant la variation de la valeur du score. propertyValue: type: string description: >- La valeur actuelle de la propriété sous forme de chaîne de caractères. renderedEvents: type: array description: >- Un tableau d'événements rendus qui ont contribué au changement de score, chaque événement détaillant ses composants et son horodatage. items: $ref: '#/components/schemas/PublicRenderedEvent' resolvedListIds: type: array description: >- Un tableau d'entiers représentant les ID des listes qui ont été résolues pendant le processus de notation. items: type: integer format: int32 resolvedProperties: type: object additionalProperties: $ref: '#/components/schemas/PublicResolvedPropertyChange' description: >- Un objet mappant les noms de propriétés à leurs modifications, chacune représentée par une valeur passée et présente ainsi qu'un horodatage. timestamp: type: string description: >- La date et l'heure d'enregistrement de l'entrée de score, 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 concernant la condition d'erreur. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: Informations supplémentaires sur l'erreur. 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 NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne utilisé comme curseur pour indiquer la position après la dernière ressource lue avec succès dans une réponse paginée. link: type: string description: >- Chaîne contenant le lien URL pour accéder à la page de résultats suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PublicRenderedEvent: required: - heading - renderedComponents - timestamp type: object properties: defaultTemplate: type: string description: >- Une chaîne représentant le modèle par défaut utilisé pour le rendu de l'événement. eventTypeId: type: string description: Un identifiant de chaîne pour le type d'événement qui a été rendu. heading: type: string description: Une chaîne représentant l'en-tête ou le titre de l'événement rendu. renderedComponents: type: array description: >- Un tableau de composants rendus qui font partie de l'événement, chacun défini par le schéma PublicRenderedComponent. items: $ref: '#/components/schemas/PublicRenderedComponent' timestamp: type: integer description: >- Un entier représentant l'heure à laquelle l'événement a été rendu, au format horodatage Unix (int64). format: int64 PublicResolvedPropertyChange: type: object properties: pastValue: type: string description: >- La valeur précédente de la propriété avant la modification. Il s'agit d'une chaîne de caractères. presentValue: type: string description: >- La valeur actuelle de la propriété après la modification. Il s'agit d'une chaîne de caractères. timestamp: type: string description: "La date et l'heure auxquelles la propriété a changé, au format ISO\_8601." format: date-time 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 propriété de chaîne. 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 un nom de contexte et la valeur est un tableau de chaînes de caractères fournissant des détails 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 propriété de chaîne. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur, accompagné, le cas échéant, des étapes de correction. Il s'agit d'une propriété de chaîne obligatoire. 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 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. PublicRenderedComponent: required: - componentType - fields - tokenName type: object properties: componentType: type: string description: Une chaîne représentant le type du composant. fields: type: object additionalProperties: type: object properties: {} description: >- Un objet contenant des propriétés supplémentaires liées au composant, où chaque propriété est un objet avec sa propre structure. tokenName: type: string description: Une chaîne représentant le nom du jeton associé au composant. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````