---
title: "Book a table by phone."
method: POST
path: "/reservations"
---

# Book a table by phone.

`POST /reservations`

## Request

- Base URL: `https://cosvoice.com/api/v1`
- URL: `https://cosvoice.com/api/v1/reservations`
- Auth: HTTP bearer

## Request body

- object
  - `venue_name` string: Restaurant name.
  - `venue_phone` string, required: Restaurant number, E.164.
  - `party_size` integer, required
  - `requested_for` string, required: When, in plain words or ISO.
  - `fallbacks` string: What else is acceptable.

## Response `200`

Placed.

- object

## Other responses

- `400`: Something in the request is missing or malformed; the message says which field.
- `401`: The key is missing, wrong, or revoked. Ask the owner for a new one; do not retry.
- `404`: No such call, email, or contact on this line.
- `429`: Over 240 requests a minute. Wait a little and try again.

---

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