---
title: "Retrieve a Payout (new)"
method: POST
path: "/-"
---

# Retrieve a Payout (new)

`POST /-`

## Request

- Base URL: `https://api.tap.company/v2/payouts`
- URL: `https://api.tap.company/v2/payouts/-`
- Auth: API key in header `Authorization`

This endpoint allows you to retrieve and download payout information for both merchant and retailer accounts

## Request body

- object
  - `payouts` object: Filter criteria for the payout to retrieve
    - `payout_id` string[]: The specific payout ID you want to retrieve
  - `merchants` string[]: merchant ID for which the payout is being queried

## Response `200`

200

- object
  - `object` string
  - `live_mode` boolean
  - `api_version` string
  - `count` integer
  - `has_more` boolean
  - `payouts` object[]
    - `id` string
    - `status` string
    - `date` integer
    - `amount` integer
    - `currency` string
    - `merchant_id` string
    - `wallet` object
      - `id` string
      - `legacy_id` string
      - `country` string
      - `bank` object
        - `id` string
        - `country` string
        - `name` string
        - `swift` string
        - `beneficiary` object
          - `name` string
          - `iban` string
    - `settlements_available` boolean
    - `bank_reference` string

## Other responses

- `400`: 400

---

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