{ "opencollection": "1.0.0", "info": { "name": "Business Accounting Disputes API", "version": "1.0" }, "items": [ { "info": { "name": "Disputes", "type": "folder" }, "items": [ { "info": { "name": "Retrieve a dispute list", "type": "http" }, "http": { "method": "GET", "url": "https://b2b.revolut.com/api/1.0/api/disputes", "headers": [ { "name": "Authorization", "value": "" }, { "name": "Revolut-Api-Version", "value": "" } ], "params": [ { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return. Used for **pagination**." }, { "name": "from_created_date", "value": "", "type": "query", "description": "Retrieve records with a `created_at` value ≥ `from_created_date`.\n\nUse the [ISO 8601 date-time format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`." }, { "name": "to_created_date", "value": "", "type": "query", "description": "Retrieve records with a `created_at` value ≤ `to_created_date`.\n\nUse the [ISO 8601 date-time format](https://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss[.SSSSSS]Z`." }, { "name": "state", "value": "", "type": "query", "description": "Filter disputes by state. Repeat the parameter to filter by multiple states.\n\n| Value | Description |\n|-------|-------------|\n| `needs_response` | Dispute requires your response |\n| `under_review` | Dispute is being reviewed |\n| `won` | Dispute resolved in your favour |\n| `lost` | Dispute resolved against you |\n\nThe parameter is case sensitive." }, { "name": "payment_id", "value": "", "type": "query", "description": "Filter disputes by the ID of the associated payment. Repeat the parameter to filter by multiple payment IDs.\n\n```\nhttps://merchant.revolut.com/api/disputes?payment_id=123&payment_id=456\n```" } ] }, "docs": "Retrieve a list of disputes associated with your merchant account. \n\n:::note\nThis endpoint is only available in **Production** environment.\n:::\n\nYou can also use the query parameters for:\n \n | Filtering | Pagination |\n | --------- | ---------- |\n | Filter the diputes that you want to retrieve, for example, only retrieve the disputes that have a specific state.

Parameters used for filtering: