> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Dispute History Records

# Type: Dispute History Record Object

# Link: https://dev.wix.com/docs/api-reference/business-management/payments/disputes/dispute-history-records/dispute-history-record-object.md

## Description: A dispute history record represents a snapshot of dispute information at a specific point in time.

Records are automatically created whenever a dispute changes status, stage, or other key properties, providing a complete audit trail for compliance and audit requirements.

## Schema:

```json
 Type: Dispute History Record Object | type: DisputeHistoryRecord
 Description: A dispute history record represents a snapshot of dispute information at a specific point in time.

Records are automatically created whenever a dispute changes status, stage, or other key properties, providing a complete audit trail for compliance and audit requirements.
       - name: id  | type: string | description: Dispute history record ID.
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the dispute history record is updated. To prevent conflicting changes, the existing revision must be specified when updating a dispute history record.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the dispute history record was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the dispute history record was last updated.
       - name: disputeId  | type: string | description: ID of the dispute that this history record is a snapshot of.
       - name: stage  | type: string | description: Stage of the dispute process.
           enum: CHARGEBACK, INQUIRY
       - name: status  | type: string | description: Status of the dispute at the time this record was created. Indicates what action was required and by whom at this point in the dispute lifecycle.
           enum: WAITING_MERCHANT, UNDER_REVIEW, WAITING_BUYER, WON, LOST
       - name: dueDate  | type: string | description: The latest date and time until which the dispute can remain in its current status.  If this date passes, the dispute will be resolved against the party that is required to take action. For example, if the status is `WAITING_MERCHANT`, and the due date passes, the dispute will be `LOST` and a refund will be processed automatically.
       - name: chargeId  | type: string | description: ID of the charge that is being disputed.
       - name: channel  | type: string | description: Channel through which the dispute is being processed.
           enum: INTERNAL, EXTERNAL
       - name: extendedFields  | type: ExtendedFields | description: Custom field data for the dispute history record object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
       - name: tags  | type: Tags | description: Tags assigned to the dispute history record for organization and filtering purposes.
           - name: privateTags  | type: TagList | description: Tags that require an additional permission in order to access them, normally not given to site members or visitors.
               - name: tagIds  | type: Array<string> | description: List of tag IDs.
           - name: publicTags  | type: TagList | description: Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.

```