{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"f5e75e83-3879-4448-b457-8cb44cbf6167","name":"API Reference","description":"The Dispute.com's API is organized around [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts JSON request bodies (`Content-Type: application/json`) for most endpoints and multipart/form-data for endpoints that accept file uploads (e.g. chargeback response documents), returns [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs.\n\nNeed a Dispute.com account? Contact [<b>sales@dispute.com</b>](https://mailto:sales@dispute.com) to get started.\n\n---\n\n## **Getting started guide**\n\nTo start using the Dispute.com API,\n\n- You must use a valid API Key to send requests to the API endpoints.\n\n- The API has [rate and usage limits](https://postman.postman.co/workspace/Collection-Templates~6311738d-2e70-441f-ae12-78caf078c5b7/collection/22517504-e9c28f47-1253-44af-a2f3-20dce4da1f18?ctx=documentation#rate-and-usage-limits).\n\n- The API only responds to HTTPS-secured communications. Any requests sent via HTTP will fail.\n\n- The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.\n\n## Request and response format\n\n- **Request bodies:** For endpoints that accept a body, send JSON with `Content-Type: application/json`. For endpoints that accept file uploads (e.g. uploading a chargeback response PDF), use `Content-Type: multipart/form-data`.\n- **Accept header:** Include `Accept: application/json` in your requests to receive responses in JSON.\n- **Responses:** All responses are JSON. The server returns `Content-Type: application/json` on response bodies.\n\n## Authentication\n\nThe Dispute.com's API uses the http header `x-api-key` for authentication.\n\nYou must include an API key in each request to the Dispute's API with the `x-api-key` http header.\n\n### Authentication error response\n\nIf an API key is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.\n\n## Rate and usage limits\n\nAPI access rate limits apply at a per-API key basis in unit time. The limit is 300 requests per minute. Also, depending on your plan, you may have usage limits. If you exceed either limit, your request will return an HTTP 429 Too Many Requests status code.\n\nEach API response returns the following set of headers to help you identify your use status:\n\n| Header | Description |\n| --- | --- |\n| `X-RateLimit-Limit` | The maximum number of requests that the consumer is permitted to make per minute. Default to 100 requests per minute. Please contact support if you need a higher quota. |\n| `X-RateLimit-Remaining` | The number of requests remaining in the current rate limit window. |\n| `X-RateLimit-Reset` | The time in milliseconds until the current window resets. |\n\n### 503 response\n\nAn HTTP `503` response from our servers indicates there is an unexpected spike in API access traffic. Our infrastructure is usually operational within the next 1 - 5 minutes. If the outage persists or you receive any other form of an HTTP `5XX` error, [contact support](https://hello@dispute.com).\n\n## **Errors**\n\nDispute.com uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the `2xx` range indicate success. Codes in the `4xx` range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a invalid object passed, etc.). Codes in the `5xx` range indicate an error with Dispute's servers (these are rare).\n\n| **HTTP STATUS CODE SUMMARY** |  |  |\n| --- | --- | --- |\n| 200 | ok | Everythign worked as expected. |\n| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |\n| 401 | Unauthorized | No valid API key provided. |\n| 402 | Request Failed | The parameters were valid but the request failed. |\n| 403 | Forbidden | The API key doesn’t have permissions to perform the request. |\n| 404 | Not Found | The requested resource doesn’t exist. |\n| 429 | Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |\n| 500, 502, 503, 504 | Server Errors | Something went wrong on Dispute’s end. (These are rare.) |\n\n### **Example Errors Response**\n\nAll `4xx` and `5xx` errors return an error message via the \"error\" field.\n\n```\n{\n    \"error\": \"Rate limit exceeded.\"\n}\n\n ```\n\n### Null Values\n\nIf there is no data for a response field the API will use `null` for that fields value.\n\n### **Need some help?**\n\nContact `developers@dispute.com` for questions, concerns, or general API support.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"40983365","team":6007123,"collectionId":"f5e75e83-3879-4448-b457-8cb44cbf6167","publishedId":"2sBXc7LQUY","public":true,"publicUrl":"https://docs.dispute.com","privateUrl":"https://go.postman.co/documentation/40983365-f5e75e83-3879-4448-b457-8cb44cbf6167","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Official Dispute.com API documentation. Learn how to integrate chargeback monitoring, dispute automation, webhooks, and case management into your platform."},{"name":"title","value":"Dispute.com API Documentation | Integrate Chargeback &amp; Dispute Management"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/bae5cd4f-6be1-47fb-9151-7efde922613e/NjU0Y2ZhNmRmYTVmZWIxMjNmMWMwYzgyX2xvZ28ucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/ebf029ed-00f0-4175-8377-7a15efa8993f/NjU0Y2Q1MTlmMjIxNzM5ZjI0MzI2NmUxX0dyb3VwLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-02-24T01:31:52.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Dispute.com API Documentation | Integrate Chargeback &amp; Dispute Management","description":"Official Dispute.com API documentation. Learn how to integrate chargeback monitoring, dispute automation, webhooks, and case management into your platform."},"logos":{"logoLight":"https://content.pstmn.io/ebf029ed-00f0-4175-8377-7a15efa8993f/NjU0Y2Q1MTlmMjIxNzM5ZjI0MzI2NmUxX0dyb3VwLnBuZw==","logoDark":"https://content.pstmn.io/bae5cd4f-6be1-47fb-9151-7efde922613e/NjU0Y2ZhNmRmYTVmZWIxMjNmMWMwYzgyX2xvZ28ucG5n"}},"statusCode":200},"environments":[{"name":"Public API V1","id":"93a8565d-6a42-49a1-9616-9b3f58f2f7d1","owner":"32667671","values":[{"key":"baseUrl","value":"https://api.dispute.com","enabled":true,"type":"default"},{"key":"collectionSchemaUrl","value":"","enabled":false,"type":"default"},{"key":"accessKey","value":"","enabled":false,"type":"default"},{"key":"workspaceId","value":"","enabled":false,"type":"default"},{"key":"collectionId","value":"","enabled":false,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/916dcbf7796ea489c605c384d7ca2af96d2ab76d100b6f7f20bbf394f6f1edaa","favicon":"https://dispute.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Public API V1","value":"32667671-93a8565d-6a42-49a1-9616-9b3f58f2f7d1"}],"canonicalUrl":"https://docs.dispute.com/view/metadata/2sBXc7LQUY"}