---
title: "List of payouts"
method: GET
path: "/v1/payout"
tags: ["Mass payouts"]
---

# List of payouts

`GET /v1/payout`

## Request

- Base URL: `https://api.nowpayments.io`
- URL: `https://api.nowpayments.io/v1/payout`
- Auth: none declared
- TypeScript: <https://skmtc.dev/nowpayments/apis/np-open-api/docs/v1/payout/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to get a list of your payouts.

The list of available parameters:

- batch_id: batch ID of enlisted payouts;
    
- status: the statuses of enlisted payouts;
    
- order_by: can be id, batchId, dateCreated, dateRequested, dateUpdated, currency, status;
    
- order: 'asc' or 'desc' order;
    
- date_from: beginning date of the requested payouts;
    
- date_to: ending date of the requested payouts;
    
- limit: a number of results to show;
    
- page: the current page;

## Query parameters

- `batch_id` integer
- `status` string
- `order_by` string
- `order` string
- `date_from` string
- `date_to` string
- `limit` integer
- `page` integer

## Headers

- `x-api-key` string

## Response `200`

List of payouts

- object
  - `payouts` object[]
    - `id` string
    - `batch_withdrawal_id` string
    - `status` string
    - `currency` string
    - `amount` string
    - `address` string
    - `hash` string
    - `is_request_payouts` boolean
    - `created_at` string, date-time
    - `requested_at` string, date-time
    - `updated_at` string, date-time

---

[API](https://skmtc.dev/nowpayments/apis/np-open-api.md) - [All operations](https://skmtc.dev/nowpayments/apis/np-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nowpayments/apis/np-open-api/revisions/32c28317af15?raw)