get/disputes

Request

  • Base URL
    https://gateway.pmnts-sandbox.io/v1.0
  • URL
    https://gateway.pmnts-sandbox.io/v1.0/disputes
  • Auth
    HTTP basic

Query parameters

fromstring

Return disputes that were opened on or after this date, provided in the format 'YYYY-DD-MM'.

tostring

Return disputes that were opened up to and on this date, provided in the format 'YYYY-MM-DD'.

searchstring

Dispute reference or transaction fatzebra ID to search on.

statusstring

Disputes of any status will be returned if this is not provided. Acceptable values: open, lost, won, expired, accepted.

order_bystring

Acceptable values: opened_on, next_due_date.

order_directionstring

Acceptable values: asc, desc.

offsetinteger

Page number.

limitinteger

Number of disputes to return per page.

Headers

Content-Typestring

Response

200

successfulboolean
testboolean

Example response

{
  "successful": true,
  "response": {
    "has_more": true,
    "records": 2,
    "total_records": 9,
    "page": 1,
    "total_pages": 5,
    "disputes": [
      {
        "opened_on": "2022-09-15",
        "transaction_id": "092-P-JHXOULO0",
        "reference": "202208036718",
        "reason_code": "001",
        "reason_description": "Fraud",
        "amount_cents": 1000000,
        "amount_currency": "AUD",
        "next_due_date": "2022-09-30",
        "status": "open"
      }
    ]
  },
  "test": true
}

Changes