---
title: "Get today's bulk payout uploads for a merchant"
method: GET
path: "/merchants/{merchantId}/payouts/upload"
tags: ["Bulk Payouts"]
---

# Get today's bulk payout uploads for a merchant

`GET /merchants/{merchantId}/payouts/upload`

Returns all bulk payout uploads created today. No filtering or searching is supported; only today's uploads are returned.

## Path parameters

- `merchantId` string, required — A unique merchant ID provided by Peach Payments in hexadecimal format.

## Response `200`

List of today's bulk payout uploads

- object
  - `bulkPayouts` BulkPayoutUpload[], required
    - `bulkPayoutId` string, required — UUID for the bulk payout
    - `payoutRequestId` string — UUID for the payout request
    - `originalFilename` string, required — Name of the file as provided in the upload request
    - `filename` string, required — Name of the file as stored by the payouts system
    - `errorFilename` string — Name of the uploaded error file (if it exists)
    - `state` 'processing' | 'submitted' | 'submitted_with_errors', required — The current state of a bulk payout upload.
    - `createdAt` string, date-time, required — Creation timestamp
    - `modifiedAt` string, date-time, required — Last modification timestamp
  - `resultCode` string, string, required — The result code indicating the status or error of the payout.

## Other responses

- `400` — There was an error with the request. Please fix the request and try again.
- `401` — The request is not authenticated. Please re-authenticate and provide a new token.
- `403` — The request is not authorised. Please contact your business administrator.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/revisions/3a98165665f8/schema)