Get DSP Refunds

GET {{base_url}}/v3/refunds?limit=50&page=0&active=true&search=door&filters[start]=2024-01-01&filters[stop]=2024-01-31&filters[status][]=pending&filters[status][]=approved&filters[internal_status][]=unreviewed&filters[internal_status][]=flagged&filters[merchant_id]=merchant_123&sorting[id]=created_at&sorting[desc]=true&format=csv

Required scope: refunds:read

Retrieves a paginated list of DSP refunds with filtering and sorting options. Supports CSV/Excel export.

Examples

cURL

curl --request GET '${base_url}/v3/refunds?limit=50&page=0&active=true&search=door&filters[start]=2024-01-01&filters[stop]=2024-01-31&filters[status][]=pending&filters[status][]=approved&filters[internal_status][]=unreviewed&filters[internal_status][]=flagged&filters[merchant_id]=merchant_123&sorting[id]=created_at&sorting[desc]=true&format=csv' \
  --header 'Authorization: Bearer {{auth_token}}'

Node.js

const response = await fetch("${base_url}/v3/refunds?limit=50&page=0&active=true&search=door&filters[start]=2024-01-01&filters[stop]=2024-01-31&filters[status][]=pending&filters[status][]=approved&filters[internal_status][]=unreviewed&filters[internal_status][]=flagged&filters[merchant_id]=merchant_123&sorting[id]=created_at&sorting[desc]=true&format=csv", {
  "method": "GET",
  "headers": {
    "Authorization": "Bearer {{auth_token}}"
  }
})
const data = await response.json()

Python

import requests

response = requests.request(
    "GET",
    "${base_url}/v3/refunds?limit=50&page=0&active=true&search=door&filters[start]=2024-01-01&filters[stop]=2024-01-31&filters[status][]=pending&filters[status][]=approved&filters[internal_status][]=unreviewed&filters[internal_status][]=flagged&filters[merchant_id]=merchant_123&sorting[id]=created_at&sorting[desc]=true&format=csv",
    headers={
  'Authorization': 'Bearer {{auth_token}}'
},
)
response.raise_for_status()

Saved responses

200 Success Response

{
  "success": true,
  "data": [
    {
      "id": "refund_12345",
      "amount": 15.5,
      "contact_email": "customer@example.com",
      "description": "Food was cold and delivery was late",
      "external_dsps_id": "dsp_delivery_12345",
      "external_dsps_name": "DoorDash",
      "issue_type": "food_quality",
      "merchant_name": "Joe's Pizza",
      "internal_status": "unreviewed",
      "status": "pending",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 50,
    "total": 1,
    "pages": 1
  },
  "usedCache": false
}