---
title: "Delete payments in bulk"
method: DELETE
path: "/payments/{companyId}"
tags: ["Payments"]
---

# Delete payments in bulk

`DELETE /payments/{companyId}`

Deletes several payments in a single call, identified by `customId`.

## Path parameters

- `companyId` string, required

## Request body

- BulkDeletePaymentsRequestSchema
  - `data` DeletePaymentsRequestSchema[], required — Payments to delete, identified by `customId`.
    - `customId` string, required — Custom ID of the payment to delete.

## Response `200`

Successful Response

- BulkModifyPaymentsResponseSchema
  - `data` ModifyPaymentsResponseSchema[], required — Result of the bulk operation, one entry per payment.
    - `id` string, required — Embat payment ID

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Company not found, or none of the given `customId` values match a payment.
- `422` — Validation Error
- `500` — Unexpected error. Contact support if it persists.
- `502` — Payment deletion failed upstream; some of the requested payments may not have been deleted. Deletion is idempotent: retry the same request.

## Changes

- **2026-09-02** `8dca7fa9abc3` — 1 info
  - added the non-success response with the status `502`

[Change history](https://skmtc.dev/embat/apis/embat-api/changes/payments/:companyId/delete.md)

---

[API](https://skmtc.dev/embat/apis/embat-api.md) · [All operations](https://skmtc.dev/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/embat/embat-api/revisions/8dca7fa9abc3/schema)