---
title: "Verify or lock a quote before payment"
method: POST
path: "/quotes/{id}/prebook"
---

# Verify or lock a quote before payment

`POST /quotes/{id}/prebook`

## Request

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

Runs the final verification step for a quote before payment.
Quotes that require verification are locked before payment. If live pricing
reports a price increase or decrease, this endpoint returns HTTP 409 with
structured price-change details so the caller can refresh and ask the user
to confirm before payment. Quotes that do not require prebook return
status `not_required`.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

Quote verified or prebook not required

- PrebookResponse
  - `success` boolean
  - `quote_id` string
  - `prebook` object
    - `required_before_payment` boolean
    - `status` 'not_required' | 'locked'
    - `expires_at` string, date-time
    - `price_changed` boolean
    - `original_book_hash` string
    - `book_hash` string
  - `pricing` object
    - `total` number
    - `currency` string

## Other responses

- `401`: Authentication required or invalid
- `404`: Resource not found
- `409`: Price changed or prebook required action

---

[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)