# List payouts

> Payout orders on Peer, newest first, each with its Peer link. Status moves through listed, matched, partially_paid and paid (or withdrawn).


`GET https://payday.direct/api/v1/payouts`

Payout orders on Peer, newest first, each with its Peer link. Status moves through `listed`, `matched`, `partially_paid` and `paid` (or `withdrawn`).

## Parameters

- `limit` (query, integer)
- `cursor` (query, string): next_cursor from the previous page
- `handle` (query, string)
- `status` (query, string)

## Responses

- 200: OK
- 401: Missing or invalid key
- 429: Over the limit. Retry-After says when to try again.

```json
{
  "data": [
    {
      "id": "412",
      "handle": "examplehandle",
      "rail": "xmoney",
      "status": "paid",
      "usdc": "120.00",
      "rate": 0.8,
      "paid_usd": "96.00",
      "peer": {
        "deposit_id": "1834",
        "url": "https://www.peer.xyz/deposit/1834",
        "listing_tx": "0x5f0c...e21a"
      },
      "listed_at": "2026-11-15T17:40:02.000Z",
      "closed_at": "2026-11-15T18:22:41.000Z"
    }
  ],
  "next_cursor": "MQ",
  "total": 288,
  "meta": {
    "updated_at": "2026-11-15T20:03:20.991Z",
    "api_version": "v1"
  }
}
```

## Example

```bash
curl "https://payday.direct/api/v1/payouts?status=paid" \
  -H "Authorization: Bearer pd_YOUR_KEY"
```