---
title: "Cancel a registration"
method: DELETE
path: "/signups/{id}/participants/{pid}"
tags: ["Participants"]
---

# Cancel a registration

`DELETE /signups/{id}/participants/{pid}`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/signups/{id}/participants/{pid}`
- Auth: HTTP bearer

Removes a single participant row. Use this for organizer-driven cleanup (e.g. removing a duplicate or no-show). Participant-driven cancellation flows still go through the confirmation-token URL. A row on a past or cancelled date (a Locked Commitment) is history and is refused with 400.

## Path parameters

- `id` string, uuid, required
- `pid` string, uuid, required

## Response `200`

Cancelled participant

- Participant
  - `id` string, uuid, required
  - `eventId` string, uuid, required
  - `name` string, required
  - `email` string, email, required
  - `phone` string, nullable, required
  - `quantityCommitted` integer, required
  - `timeSlotId` string, uuid, nullable, required
  - `itemId` string, uuid, nullable, required
  - `slotCustomFieldResponse` string, nullable, required
  - `itemCustomFieldResponse` string, nullable, required
  - `eventCustomFieldResponse` string, nullable, required
  - `createdAt` string, date-time, required
  - `slot` object, nullable, required
    - `id` string, uuid, required
    - `title` string, nullable, required
    - `startTime` string, date-time, required
    - `endTime` string, date-time, required
  - `item` object, nullable, required
    - `id` string, uuid, required
    - `name` string, required
    - `timeSlotId` string, uuid, nullable, required
    - `eventDayId` string, uuid, nullable, required

## Other responses

- `400`: Bad request — body or path could not be parsed
- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `404`: Not found
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/thesignup/apis/thesignup-api.md) · [All operations](https://skmtc.dev/thesignup/apis/thesignup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thesignup/apis/thesignup-api/revisions/c6da7cf92172?raw)