---
title: "List Retailers Reverse Transfers"
method: POST
path: "/list"
---

# List Retailers Reverse Transfers

`POST /list`

## Request

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

## Request body

- object
  - `limit` number: The records limit, the default is 50. The minimum is 1 and the maximum is 50
  - `page_no` number: The page number is starting from 1 until the [total_count/limit]
  - `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

## Response `200`

OK

- object

## 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)