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

# List Retailers Transfers

`POST /list`

## Request

- Base URL: `https://api.tap.company/v4/destination`
- URL: `https://api.tap.company/v4/destination/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: To add the date range to search within the selected period
    - `date` object, required: The date range to search within. Maximum 30 days
      - `from` number, required
      - `to` number, required
  - `merchants` string[]: To filter by the merchant IDs of the marketplace, the retailer IDs should be added in the retailers list.
  - `payouts` string[]
  - `settlements` string[]
  - `retailers` string[]: To filter by the retailer IDs
  - `destination_transactions` string[]
  - `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`

Successful response

## Other responses

- `400`: Bad Request

---

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