---
title: "Download Retailers Reverse Transfers"
method: POST
path: "/download"
---

# Download Retailers Reverse Transfers

`POST /download`

## Request

- Base URL: `https://api.tap.company/v4/reversedestination`
- URL: `https://api.tap.company/v4/reversedestination/download`
- Auth: API key in header `Authorization`

## Request body

- object
  - `period` object, required
    - `date` object, required
      - `from` number, required
      - `to` number, required
  - `merchants` string[]: To filter by the merchant IDs
  - `payouts` string[]
  - `settlements` string[]
  - `retailers` string[]: To filter by the retailer IDs
  - `transfers` string[]
  - `mobile` string
  - `email` string
  - `customers` string[]: To filter by the customers IDs
  - `payment_methods` string[]: To filter by the payment methods, for example: VISA,MASTERCARD,MADA
  - `charges` string[]: To filter by the charge IDs
  - `sources` string[]: To filter by the token IDs
  - `filters` object
    - `currency` string[]: To filter by currency with iso-3 format (SAR,KWD,AED,...)
    - `payment_scheme` string[]: To filter by the payment scheme such us VISA, MASTERCARD and MADA
  - `starting_after` string: To get the transfer after the selected transfer, the API is limited to return 100K records only, to get the transfers after this number you can get the Last_destination_id from the response header and get the records if Has_more is true

## Response `200`

Successful response

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/tap/apis/reversedestination.md) - [All operations](https://skmtc.dev/tap/apis/reversedestination/llms.txt) - [OpenAPI document](https://skmtc.dev/tap/apis/reversedestination/revisions/7da4ae48313d?raw)