---
title: "Cancel a booking"
method: DELETE
path: "/bookings/{id}"
---

# Cancel a booking

`DELETE /bookings/{id}`

## Request

- Base URL: `https://api.tellandgo.com/api/v1/agent`
- URL: `https://api.tellandgo.com/api/v1/agent/bookings/{id}`
- Auth: API key in header `X-API-Key`

Cancels a booking. Cancellation policies may apply.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `reason` string: Cancellation reason

## Response `200`

Booking cancelled

- BookingResponse
  - `success` boolean
  - `booking` object
    - `id` string
    - `status` 'pending_payment' | 'confirmed' | 'cancelled' | 'completed'
    - `reference` string
    - `confirmation_number` string
    - `property` object
      - `id` string
      - `name` string
    - `room` object
      - `name` string
    - `dates` object
      - `check_in` string, date
      - `check_out` string, date
      - `nights` integer
    - `guests` object[]
      - `name` string
      - `is_primary` boolean
    - `payment` object
      - `method` 'stripe_checkout' | 'redirect': Payment method used
      - `status` 'pending' | 'completed' | 'failed' | 'refunded'
      - `amount` number
      - `currency` string
      - `url` string, uri: Payment URL. For hosted checkout, this is a hosted payment page.
      - `session_id` string: Hosted checkout session ID (only for hosted checkout)
      - `expires_at` string, date-time
    - `created_at` string, date-time

## Other responses

- `401`: Authentication required or invalid
- `404`: Resource not found

---

[API](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api.md) · [All operations](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api/revisions/3d84f816eb4f?raw)