---
title: "Request a cancel"
method: POST
path: "/api/v1/orders/{id}/cancel"
tags: ["Orders"]
---

# Request a cancel

`POST /api/v1/orders/{id}/cancel`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/orders/{id}/cancel`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

For a pending or processing order of a cancelable service. Whatever was not delivered is refunded to your balance.

## Path parameters

- `id` integer, required

## Response `202`

Requested.

- ActionRequested
  - `ok` unknown
  - `order` integer
  - `action` 'cancel'
  - `status` 'requested'

## Other responses

- `400`: Not cancelable now.
- `404`: Not found on your account.
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

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