Managed Disputes

Retrieve a dispute

Changed on

Retrieves a specific dispute by its token.

get/v2/disputes/{dispute_token}

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v2/disputes/{dispute_token}
  • Auth
    API key in header Authorization

Path parameters

dispute_tokenstring uuid required

Token of the dispute to retrieve.

Response

OK

case_idstring nullable required

Identifier assigned by the network for this dispute.

tokenstring uuid required

Token assigned by Lithic for the dispute, in UUID format.

card_tokenstring uuid required

Token for the card used in the dispute, in UUID format.

account_tokenstring uuid required

Token for the account associated with the dispute, in UUID format.

claim_tokenstring uuid nullable required

Token for the claim this dispute was filed under, in UUID format. Null for disputes not initiated through the Dispute Intake API.

network'VISA' | 'MASTERCARD' required

Card network handling the dispute.

currencystring required

Three-letter ISO 4217 currency code.

createdstring date-time required

When the dispute was created.

updatedstring date-time required

When the dispute was last updated.

status'OPEN' | 'CLOSED' | 'null' nullable required

Current status of the dispute.

disposition'WON' | 'LOST' | 'PARTIALLY_WON' | 'WITHDRAWN' | 'DENIED' | 'null' nullable required

Dispute resolution outcome

Example response

{
  "merchant": {
    "acceptor_id": "333301802529120",
    "acquiring_institution_id": "191231",
    "city": "NEW YORK",
    "country": "USA",
    "descriptor": "COFFEE SHOP",
    "mcc": "5812",
    "state": "NY"
  }
}

Changes

  • 9977f6499efcRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      added discriminator to / response property for the response status

  • 1f219d35844eRevision changes
    • warning

      added the new WRITE_OFF_REVERSED enum value to the //// response property for the response status

    • info

      added the required property to the response with the status