---
title: "Get failed bulk payments"
method: GET
path: "bulk-payments/{bulkPaymentId}/errors"
tags: ["Bulk Payments"]
---

# Get failed bulk payments

`GET bulk-payments/{bulkPaymentId}/errors`

## Request

- Base URL: `https://payments.air-pay.io`
- URL: `https://payments.air-pay.io/bulk-payments/{bulkPaymentId}/errors`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/docs/bulk-payments/:bulkPaymentId/errors/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to see the parts of your bulk payment that
could not be processed. There is no way to restart them other than to
create a new bulk payment. There may be unlikely occurrences where some
errors might not be clear or will only contain an error code. Please
reach out to enterprise@airtm.com, we are eager to improve the API or
explain why a payment cannot be processed.

There is no way of restarting a failed payment. You must post a new bulk
payment or contact support.

This endpoint is paginated, so make sure to "flip through the pages" via
the query parameter "page" if you need to get all the information.

## Path parameters

- `bulkPaymentId` string

## Headers

- `Accept` string
- `Authorization` string

## Other responses

- `404`: Not found
- `200 - Failed payments`: OK
- `200 - No failed payments`: OK

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/revisions/4e8326a04343?raw)