> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jupico.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get dispute history

> Returns the event timeline for disputes, detailing each stage and status change.



## OpenAPI

````yaml /openapi.json post /v1/query/disputes/chartslines
openapi: 3.0.0
info:
  title: Jupico - OpenAPI 3.0
  description: >-
    The Jupico API lets Service Providers onboard merchants, process card and
    eCheck (ACH) payments, run hosted payment pages, manage recurring billing,
    send payouts, and query every resource. All endpoints use HTTPS with Basic
    authentication and accept and return JSON. Endpoints are grouped by
    workflow: onboard merchants first, then accept payments, then move funds and
    report.
  termsOfService: https://help.jupico.com/references-and-resources/legal
  contact:
    email: support@jupico.com
  license:
    name: Jupico License
    url: https://jupico.com
  version: 1.0.5
servers:
  - url: https://sandbox-platform.jupico.com
security:
  - basicAuth: []
tags:
  - name: Status
    description: Health check for the Jupico API.
  - name: Onboarding Invites
    description: >-
      Create and send invites that onboard merchants through the Jupico-hosted
      flow, with optional pre-filled identity, fees, and payout bank account
      data.
  - name: Provisioning
    description: >-
      Onboard merchants from your own UI. Collect onboarding data and submit it
      through the provisioning chain: applicant → application → submerchant.
  - name: Session
    description: >-
      Create browser authorization sessions for the Jupico web components, so
      card and bank account data is tokenized client-side and never touches your
      servers.
  - name: Tokenization
    description: >-
      Convert one-time tokens from the web components into permanent Jupico
      tokens, or tokenize raw card data if your systems are PCI DSS compliant.
  - name: Customer
    description: >-
      Create and manage customer records that payments, subscriptions,
      installments, and invoices link to.
  - name: Card Transactions
    description: >-
      Process credit and debit card transactions using tokenized card data:
      sale, authorization, capture, void, refund, and rollback.
  - name: eCheck Transactions
    description: >-
      Debit customer bank accounts via eCheck (ACH): sale, void, refund,
      rollback, and bank account tokenization.
  - name: Checkouts
    description: >-
      Hosted checkout sessions where customers complete payment on a
      Jupico-hosted page.
  - name: Payment Links
    description: >-
      Shareable links that open a Jupico-hosted payment page — no integration
      code needed at the point of sharing.
  - name: Invoices
    description: Create and email invoices that customers pay online.
  - name: Subscriptions
    description: >-
      Recurring billing. Plans define billing schedules and pricing models;
      subscriptions enroll customers against a stored payment token.
  - name: Installments
    description: Split a fixed total into scheduled payments with an optional deposit.
  - name: Payouts
    description: >-
      Send funds from a submerchant's available balance to a tokenized bank
      account with on-demand payout instructions.
  - name: Query
    description: >-
      Search and report across every resource: transactions, merchants,
      settlements, balances, disputes, fees, and more. All query endpoints
      accept the same filter, sort, and pagination envelope — see the Query
      Capabilities guide.
paths:
  /v1/query/disputes/chartslines:
    post:
      tags:
        - Query
      summary: Get dispute history
      description: >-
        Returns the event timeline for disputes, detailing each stage and status
        change.
      operationId: findDisputesChartslines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          $ref: '#/components/responses/findDisputesChartLines'
      security:
        - basicAuth: []
components:
  responses:
    findDisputesChartLines:
      description: findDisputesChartLines
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
                description: >-
                  Whether the request was processed successfully. Declines
                  return HTTP 200 with `success: false`.
              message:
                type: string
                example: succeeded
                description: Human-readable result message.
              code:
                type: string
                example: '0'
                description: Machine-readable result code. See the Error Codes reference.
              data:
                type: array
                items:
                  type: object
                  properties:
                    spProductId:
                      type: string
                      example: '255'
                      description: >-
                        Identifier of the Service Provider product the merchant
                        belongs to.
                    facId:
                      type: string
                      example: JPT
                      description: Facilitator identifier assigned by Jupico.
                    transactionId:
                      type: string
                      example: b164e6e2-791c-4831-aefd-003de4d71085
                      description: Unique identifier of the original transaction.
                    txReceivedDate:
                      type: string
                      example: '210606'
                      description: Date the dispute record was received (network format).
                    txType:
                      type: string
                      example: '41'
                      description: Transaction type code from the network.
                    disputeAmount:
                      type: string
                      example: '0000020773'
                      description: Amount in dispute.
                    disputeAmountPretty:
                      type: string
                      example: '207.73'
                      description: Dispute amount formatted for display.
                    networkId:
                      type: string
                      example: VISA
                      description: Card network identifier.
                    draftRetrievalNumber:
                      type: string
                      example: '231268787'
                      description: Draft retrieval reference number.
                    recordNumber:
                      type: string
                      example: '112710461802'
                      description: Record number within the dispute file.
                    originalTxDate:
                      type: string
                      example: '10414'
                      description: Date of the original transaction (network format).
                    originalTxTime:
                      type: string
                      example: '732004'
                      description: Time of the original transaction (network format).
                    merchantChainNumberFromOriginalTx:
                      type: string
                      example: 6416Y
                      description: Merchant chain number from the original transaction.
                    divisionNumberFromOriginalTx:
                      type: string
                      example: '000'
                      description: Merchant division number from the original transaction.
                    totalSegments:
                      type: string
                      example: '2'
                      description: Number of segments in the dispute record.
                    terminalId:
                      type: string
                      example: '01'
                      description: Terminal ID from the original transaction.
                    registerNumber:
                      type: string
                      example: '0000'
                      description: Register number from the original transaction.
                    chargebackUsageCode:
                      type: string
                      example: C
                      description: Chargeback usage code (first or subsequent presentment).
                    adjustmentType:
                      type: string
                      example: HBK2
                      description: Adjustment type code.
                    draftActionCode:
                      type: string
                      example: ''
                      description: Draft action code.
                    draftActionCodeDate:
                      type: string
                      example: ''
                      description: Date of the draft action (network format).
                    documentIndicator:
                      type: string
                      example: '1'
                      description: Indicates whether supporting documentation exists.
                    primaryAccountNumber:
                      type: string
                      example: 53506XXXXXX6148   M
                      description: Masked primary account number (PAN).
                    chargebackActionCode:
                      type: string
                      example: ACP2
                      description: Chargeback action code.
                    chargebackActionCodeDate:
                      type: string
                      example: '106060'
                      description: Date of the chargeback action (network format).
                    departmentNumber:
                      type: string
                      example: '00008'
                      description: Department number from the original transaction.
                    issuerCurrencyCode:
                      type: string
                      example: '405'
                      description: Currency code used by the issuer.
                    merchantCategoryCode:
                      type: string
                      example: 812V
                      description: >-
                        Merchant category code (MCC) of the original
                        transaction.
                    adjustmentReasonCode:
                      type: string
                      example: 04  0
                      description: Adjustment reason code from the network.
                    chargebackReferenceCode:
                      type: string
                      example: '020870072561'
                      description: Chargeback reference assigned by the network.
                    dispositionQualifier:
                      type: string
                      example: '022'
                      description: Disposition qualifier code.
                    aRN:
                      type: string
                      example: '44450011043004499215196'
                      description: >-
                        Acquirer reference number (ARN) for the disputed
                        transaction.
                    merchantChain:
                      type: string
                      example: 416Y
                      description: Merchant chain number.
                    merchantDivisionNumber:
                      type: string
                      example: '0'
                      description: Merchant division number.
                    feeAmount:
                      type: string
                      example: '0.00'
                      description: Fee amount.
                    salesPersonNumber:
                      type: string
                      example: '000000000'
                      description: Salesperson number from the original transaction.
                    entryMode:
                      type: string
                      example: '1'
                      description: Card entry mode of the original transaction.
                    authorizationSource:
                      type: string
                      example: '7'
                      description: Authorization source code from the original transaction.
                    previousDraftAction:
                      type: string
                      example: ''
                      description: Previous draft action code.
                    electronicCommerce:
                      type: string
                      example: ''
                      description: E-commerce indicator from the original transaction.
                    userDataField1:
                      type: string
                      example: ''
                      description: Network user data field.
                    userDataField2:
                      type: string
                      example: ''
                      description: Network user data field.
                    userDataField3:
                      type: string
                      example: ''
                      description: Network user data field.
                    userDataField4:
                      type: string
                      example: ''
                      description: Network user data field.
                    commentsFromIssuer:
                      type: string
                      example: ''
                      description: Comments from the issuing bank.
                    commentsToIssuer:
                      type: string
                      example: ''
                      description: Comments sent to the issuing bank.
                    commentToMerchant:
                      type: string
                      example: ''
                      description: Comment addressed to the merchant.
                    commentsFromMerchant:
                      type: string
                      example: ''
                      description: Comments submitted by the merchant.
                    merchantStoreNumber:
                      type: string
                      example: '000000092'
                      description: Merchant store number.
                    updatedAt:
                      type: string
                      example: '2024-04-19T00:14:51.690Z'
                      description: Timestamp when the object was last updated (ISO 8601).
                    createdAt:
                      type: string
                      example: '2023-04-28T16:46:36.516Z'
                      description: Timestamp when the object was created (ISO 8601).
                description: The response payload.
              totals:
                type: object
                properties:
                  count:
                    type: integer
                    example: 2
                    description: Number of records.
                description: Aggregate totals across all returned records.
              count:
                type: integer
                example: 2
                description: Number of records.
              query:
                type: object
                properties:
                  criteria:
                    type: object
                    example: {}
                    description: Filter criteria applied, keyed by field path.
                  options:
                    type: object
                    properties:
                      limit:
                        type: integer
                        example: 1000
                        description: Maximum number of records returned.
                      projection:
                        type: object
                        properties:
                          _id:
                            type: integer
                            example: 0
                            description: Internal document identifier.
                          spProductId:
                            type: integer
                            example: 1
                            description: >-
                              Identifier of the Service Provider product the
                              merchant belongs to.
                          facId:
                            type: integer
                            example: 1
                            description: Facilitator identifier assigned by Jupico.
                          transactionId:
                            type: integer
                            example: 1
                            description: Unique identifier of the original transaction.
                          txReceivedDate:
                            type: integer
                            example: 1
                            description: >-
                              Date the dispute record was received (network
                              format).
                          txType:
                            type: integer
                            example: 1
                            description: Transaction type code from the network.
                          disputeAmount:
                            type: integer
                            example: 1
                            description: Amount in dispute.
                          disputeAmountPretty:
                            type: integer
                            example: 1
                            description: Dispute amount formatted for display.
                          networkId:
                            type: integer
                            example: 1
                            description: Card network identifier.
                          draftRetrievalNumber:
                            type: integer
                            example: 1
                            description: Draft retrieval reference number.
                          recordNumber:
                            type: integer
                            example: 1
                            description: Record number within the dispute file.
                          originalTxDate:
                            type: integer
                            example: 1
                            description: Date of the original transaction (network format).
                          originalTxTime:
                            type: integer
                            example: 1
                            description: Time of the original transaction (network format).
                          merchantChainNumberFromOriginalTx:
                            type: integer
                            example: 1
                            description: >-
                              Merchant chain number from the original
                              transaction.
                          divisionNumberFromOriginalTx:
                            type: integer
                            example: 1
                            description: >-
                              Merchant division number from the original
                              transaction.
                          totalSegments:
                            type: integer
                            example: 1
                            description: Number of segments in the dispute record.
                          terminalId:
                            type: integer
                            example: 1
                            description: Terminal ID from the original transaction.
                          registerNumber:
                            type: integer
                            example: 1
                            description: Register number from the original transaction.
                          chargebackUsageCode:
                            type: integer
                            example: 1
                            description: >-
                              Chargeback usage code (first or subsequent
                              presentment).
                          adjustmentType:
                            type: integer
                            example: 1
                            description: Adjustment type code.
                          draftActionCode:
                            type: integer
                            example: 1
                            description: Draft action code.
                          draftActionCodeDate:
                            type: integer
                            example: 1
                            description: Date of the draft action (network format).
                          documentIndicator:
                            type: integer
                            example: 1
                            description: Indicates whether supporting documentation exists.
                          primaryAccountNumber:
                            type: integer
                            example: 1
                            description: Masked primary account number (PAN).
                          chargebackActionCode:
                            type: integer
                            example: 1
                            description: Chargeback action code.
                          chargebackActionCodeDate:
                            type: integer
                            example: 1
                            description: Date of the chargeback action (network format).
                          departmentNumber:
                            type: integer
                            example: 1
                            description: Department number from the original transaction.
                          issuerCurrencyCode:
                            type: integer
                            example: 1
                            description: Currency code used by the issuer.
                          merchantCategoryCode:
                            type: integer
                            example: 1
                            description: >-
                              Merchant category code (MCC) of the original
                              transaction.
                          adjustmentReasonCode:
                            type: integer
                            example: 1
                            description: Adjustment reason code from the network.
                          chargebackReferenceCode:
                            type: integer
                            example: 1
                            description: Chargeback reference assigned by the network.
                          dispositionQualifier:
                            type: integer
                            example: 1
                            description: Disposition qualifier code.
                          aRN:
                            type: integer
                            example: 1
                            description: >-
                              Acquirer reference number (ARN) for the disputed
                              transaction.
                          merchantChain:
                            type: integer
                            example: 1
                            description: Merchant chain number.
                          merchantDivisionNumber:
                            type: integer
                            example: 1
                            description: Merchant division number.
                          feeAmount:
                            type: integer
                            example: 1
                            description: Fee amount.
                          salesPersonNumber:
                            type: integer
                            example: 1
                            description: Salesperson number from the original transaction.
                          entryMode:
                            type: integer
                            example: 1
                            description: Card entry mode of the original transaction.
                          authorizationSource:
                            type: integer
                            example: 1
                            description: >-
                              Authorization source code from the original
                              transaction.
                          previousDraftAction:
                            type: integer
                            example: 1
                            description: Previous draft action code.
                          electronicCommerce:
                            type: integer
                            example: 1
                            description: >-
                              E-commerce indicator from the original
                              transaction.
                          userDataField1:
                            type: integer
                            example: 1
                            description: Network user data field.
                          userDataField2:
                            type: integer
                            example: 1
                            description: Network user data field.
                          userDataField3:
                            type: integer
                            example: 1
                            description: Network user data field.
                          userDataField4:
                            type: integer
                            example: 1
                            description: Network user data field.
                          commentsFromIssuer:
                            type: integer
                            example: 1
                            description: Comments from the issuing bank.
                          commentsToIssuer:
                            type: integer
                            example: 1
                            description: Comments sent to the issuing bank.
                          commentToMerchant:
                            type: integer
                            example: 1
                            description: Comment addressed to the merchant.
                          commentsFromMerchant:
                            type: integer
                            example: 1
                            description: Comments submitted by the merchant.
                          merchantStoreNumber:
                            type: integer
                            example: 1
                            description: Merchant store number.
                          updatedAt:
                            type: integer
                            example: 1
                            description: >-
                              Timestamp when the object was last updated (ISO
                              8601).
                          createdAt:
                            type: integer
                            example: 1
                            description: Timestamp when the object was created (ISO 8601).
                        description: Field projection applied to results.
                    description: 'Query options: pagination, sorting, and field projection.'
                description: Echo of the query envelope that produced this result.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````