---
title: "Mark a lead booked (the renter ordered with you). The billable booked event is recorded once, from this call or from the renter's own confirmation, whichever comes first. Empty body is fine. On a sandbox key only the sample lead's id is accepted, and nothing is recorded."
method: POST
path: "/v1/leads/{id}/booked"
tags: ["move_intake"]
---

# Mark a lead booked (the renter ordered with you). The billable booked event is recorded once, from this call or from the renter's own confirmation, whichever comes first. Empty body is fine. On a sandbox key only the sample lead's id is accepted, and nothing is recorded.

`POST /v1/leads/{id}/booked`

## Request

- Base URL: `https://www.putroots.com`
- URL: `https://www.putroots.com/v1/leads/{id}/booked`
- Auth: HTTP bearer

Mark a lead booked (the renter ordered with you). The billable booked event is recorded once, from this call or from the renter's own confirmation, whichever comes first. Empty body is fine. On a sandbox key only the sample lead's id is accepted, and nothing is recorded.

## Path parameters

- `id` string, required

## Request body

- object
  - `amount` number
  - `note` string

## Response `200`

OK

- object
  - `source` unknown, required
  - `fetched_at` string, date-time, required
  - `ok` boolean, required
  - `lead_id` string, required
  - `already` boolean
  - `dry_run` boolean
  - `sample` boolean: Sandbox only: this was the sample lead from POST /v1/leads/sample. Your call was validated and accepted, but nothing was recorded — there is no renter behind it.

## Other responses

- `400`: Bad input — error says which field.
- `401`: No key / bad token.
- `403`: Key is fine but not for this: pending approval, revoked, scope missing, or an operation only the renter's own account may call.
- `404`: No such lead / hand-off / listing under this key.
- `409`: Conflict: the code is already registered.
- `429`: Rate limited; Retry-After in seconds.

---

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