---
title: "Delete Payee by Id"
method: DELETE
path: "/v4/payees/{payeeId}"
tags: ["Payees"]
---

# Delete Payee by Id

`DELETE /v4/payees/{payeeId}`

This API will delete Payee by Id (UUID). Deletion by ID is not allowed if:

\* Payee ID is not found

\* If Payee has not been on-boarded

\* If Payee is in grace period

\* If Payee has existing payments

## Path parameters

- `payeeId` string, uuid, required

## Response `204`

No content. Payee Id accepted for deletion.

## Other responses

- `400` — Invalid request. See Error message payload for details of failure
- `404` — The resource was not found or is no longer available

## Changes

- **2023-08-15** `b924ba134e09` — 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
- **2020-08-13** `75bb7af5ae63` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v4/payees/:payeeId/delete.md)

---

[API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [All operations](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/velopaymentsapi/velo-payments-apis/revisions/05c3f09fc50a/schema)