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

# Delete Payee by Id

`DELETE /v3/payees/{payeeId}`

> **Deprecated.**

Use v4 instead

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` — Payee Id not found

## Changes

- **2023-08-15** `b924ba134e09` — 1 info
  - added the media type `application/json` for the response with the status `400`
- **2021-01-14** `5e4369698639` — 1 info
  - endpoint deprecated
- **2020-01-28** `1b2abf26b5d6` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 info
  - api path removed with deprecation

[Change history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v3/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)