---
title: "Cancel a pending onramp event"
method: POST
path: "/v1/onramp/cancel"
tags: ["onramp"]
---

# Cancel a pending onramp event

`POST /v1/onramp/cancel`

Cancel the user's current open onramp event (pending or confirmed). Marks it
as failed so the frontend stops polling. Used when the user abandons the
Coinbase flow before completing the purchase.

Returns the cancelled event ID, or 404 if no open onramp exists.

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove.

## Response `200`

Successful Response

- OnrampCancelResponse — Response model for POST /v1/onramp/cancel.
  - `cancelled` boolean, required — Whether the onramp was cancelled
  - `event_id` string, required — Cancelled onramp event ID

## Other responses

- `401` — Missing or invalid JWT
- `404` — No open onramp event to cancel
- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/versions/f286b48a8105/schema)