---
title: "Download Payouts"
method: POST
path: "/download"
---

# Download Payouts

`POST /download`

## Request

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

This endpoint allows you to download the payouts with detailed information for each payout. The response returned is a zip file contains all the details of the payout such as the charges, refunds, payout summary, dispute and released dispute. Here is an example of the [folder](https://drive.google.com/drive/folders/1D5YTG5ZucN8urWquzbh7rtEt3IeoLWgi?usp=sharing).

## Request body

- object
  - `merchants` string[]: List of merchant IDs for which the charges are being queried
  - `payouts` object: Retrieve charges based on payouts
    - `payout_id` string[]: The specific payout ID you want to retrieve

## Response `200`

200

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