Skip to main content
The DisputeNinja API uses Bearer Token authentication to secure your API requests. This page will guide you through the process of obtaining and using your API key for authentication.

​
Obtaining Your API Key

To get started with the API, you’ll need to obtain an API key:
  1. Log in to your account (or sign up if you don’t have one)
  2. Navigate to settings -> API keys
  3. Click on “Generate New Key”
  4. Copy your new API key

​
Using Your API Key

To authenticate your API requests, include your API key in the Authorization header of each request. The header should be formatted as follows: 
Authorization: Bearer YOUR_API_KEY
Replace YOUR_API_KEY with your actual API key.

​
Example Request

Here’s an example of how to include the authorization header in a cURL request: 
curl --request POST \
  --url https://app.disputeninja.io/api/v1/disputes/update-evidence \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "stripe_dispute_id": "dp_1PnDIEGo98l4hPg3tloPgtOA",
    "evidence": {
      "shipping_tracking_numbers": ["1234567890"]
    }
  }'

​
Rate Limiting

To ensure fair usage and protect our services, we implement rate limiting on API requests. The current limits are:
  • 5,000 requests per hour
If you exceed these limits, you’ll receive a 429 Too Many Requests response. The response will include a Retry-After header indicating how long you should wait before making another request.
If you need higher rate limits, please contact us.
⌘I