> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve history > Retrieve the history of score values for a specific object type and ID in the lead scoring framework. This endpoint allows you to track changes over time, up to the last 90 days, which can be useful for analyzing trends and understanding how scores have evolved. > [accordion] Supported products > [accordion] 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: Retrieve history description: >- Retrieve the history of score values for a specific object type and ID in the lead scoring framework. This endpoint allows you to track changes over time, up to the last 90 days, which can be useful for analyzing trends and understanding how scores have evolved. operationId: get-/marketing/lead-scoring/2027-03-beta/score-values/object-history parameters: - name: after in: query description: >- The paging cursor token of the last successfully read resource, used for pagination. This token is returned as the `paging.next.after` JSON property of a paged response containing more results. required: false style: form explode: true schema: type: string - name: limit in: query description: The maximum number of results to display per page. Defaults to 100. required: false style: form explode: true schema: type: integer format: int32 default: 100 - name: objectId in: query description: >- The unique identifier of the object for which the score history is being retrieved, specified as an integer. required: false style: form explode: true schema: type: integer format: int64 - name: objectTypeId in: query description: >- The type of the object for which the score history is being retrieved, specified as a string. required: false style: form explode: true schema: type: string - name: outputProperty in: query description: >- The specific property of the score output to be included in the response, specified as a string. 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: >- An array of PublicScoreHistoryEntry objects, each representing a historical entry of score changes for an object. items: $ref: '#/components/schemas/PublicScoreHistoryEntry' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: >- Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page. PublicScoreHistoryEntry: required: - renderedEvents - resolvedListIds - resolvedProperties - timestamp type: object properties: delta: type: number description: A number representing the change in the score value. propertyValue: type: string description: The current value of the property as a string. renderedEvents: type: array description: >- An array of rendered events that contributed to the score change, with each event detailing its components and timestamp. items: $ref: '#/components/schemas/PublicRenderedEvent' resolvedListIds: type: array description: >- An array of integers representing the IDs of lists that were resolved during the scoring process. items: type: integer format: int32 resolvedProperties: type: object additionalProperties: $ref: '#/components/schemas/PublicResolvedPropertyChange' description: >- An object mapping property names to their changes, each represented by a past and present value along with a timestamp. timestamp: type: string description: >- The date and time when the score entry was recorded, in ISO 8601 format. format: date-time Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category. context: type: object additionalProperties: type: array items: type: string description: Context about the error condition. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request. Include this value with any error reports or support tickets. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: Further information about the error. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs containing documentation about the error or recommended remediation steps. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error. description: >- Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered. 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: >- A string token used as a cursor to indicate the position after the last successfully read resource in a paginated response. link: type: string description: A string containing the URL link to access the next page of results. 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: >- A string representing the default template used for rendering the event. eventTypeId: type: string description: A string identifier for the type of event that was rendered. heading: type: string description: A string representing the heading or title of the rendered event. renderedComponents: type: array description: >- An array of rendered components that are part of the event, each defined by the PublicRenderedComponent schema. items: $ref: '#/components/schemas/PublicRenderedComponent' timestamp: type: integer description: >- An integer representing the time the event was rendered, in Unix timestamp format (int64). format: int64 PublicResolvedPropertyChange: type: object properties: pastValue: type: string description: >- The previous value of the property before the change occurred. It is a string. presentValue: type: string description: The current value of the property after the change. It is a string. timestamp: type: string description: >- The date and time when the property change occurred, in ISO 8601 format. format: date-time ErrorDetail: required: - message type: object properties: code: type: string description: >- The status code associated with the error detail. This is a string property. context: type: object additionalProperties: type: array items: type: string description: >- Context about the error condition, represented as an object where each key is a context name and the value is an array of strings providing further details. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- The name of the field or parameter in which the error was found. This is a string property. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. It is a required string property. subCategory: type: string description: >- A specific category that contains more specific detail about the error. This is a string property. description: >- Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typically as part of an error response. PublicRenderedComponent: required: - componentType - fields - tokenName type: object properties: componentType: type: string description: A string representing the type of the component. fields: type: object additionalProperties: type: object properties: {} description: >- An object containing additional properties related to the component, where each property is an object with its own structure. tokenName: type: string description: >- A string representing the name of the token associated with the component. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````