Taventi API
https://api.taventi.app. The public endpoints work without signing in; the restaurant API at the end needs an API key.Restaurants
get/v1/storefronts/{subdomain}
Get a restaurant
The restaurant behind a Taventi site (<subdomain>.taventi.app): name, description, default language, branding, its own address (customDomain, once connected) and its locations.
SDK: client.getStorefront()
| Parameter | In | Description |
|---|---|---|
subdomain | path | The restaurant's subdomain, e.g. beastie. |
curl "https://api.taventi.app/v1/storefronts/beastie"Response 200 · StorefrontResponse
| Field | Type | Notes |
|---|---|---|
organization | object | |
organization.slug | string | |
organization.name | string | |
organization.description | object | null | |
organization.description.nl | string | |
organization.description.fr | string | |
organization.description.en | string | |
organization.defaultLocale | "nl" | "fr" | "en" | |
organization.branding | object | |
organization.branding.logoUrl | string | null | |
organization.branding.logoFileId | string (uuid) | null | |
organization.branding.coverUrl | string | null | |
organization.branding.coverFileId | string (uuid) | null | |
organization.branding.primaryColor | string | |
organization.branding.accentColor | string | |
organization.branding.template | "classic" | "bistro" | "street" | |
organization.customDomain | string | null | |
locations | object[] | |
locations[].id | string (uuid) | |
locations[].slug | string | |
locations[].name | object | |
locations[].name.nl | string | |
locations[].name.fr | string | |
locations[].name.en | string |
| Status | Code | When |
|---|---|---|
| 404 | storefront_not_found | No restaurant has it. |
get/v1/storefronts/domains/{hostname}
Get a restaurant by its own address
The same as above, for a restaurant's own connected address (e.g. order.beastie.be). customDomain in the answer is that address.
SDK: client.getStorefrontByDomain()
| Parameter | In | Description |
|---|---|---|
hostname | path | The address, e.g. order.beastie.be. |
curl "https://api.taventi.app/v1/storefronts/domains/<hostname>"Response 200 · StorefrontResponse
| Field | Type | Notes |
|---|---|---|
organization | object | |
organization.slug | string | |
organization.name | string | |
organization.description | object | null | |
organization.description.nl | string | |
organization.description.fr | string | |
organization.description.en | string | |
organization.defaultLocale | "nl" | "fr" | "en" | |
organization.branding | object | |
organization.branding.logoUrl | string | null | |
organization.branding.logoFileId | string (uuid) | null | |
organization.branding.coverUrl | string | null | |
organization.branding.coverFileId | string (uuid) | null | |
organization.branding.primaryColor | string | |
organization.branding.accentColor | string | |
organization.branding.template | "classic" | "bistro" | "street" | |
organization.customDomain | string | null | |
locations | object[] | |
locations[].id | string (uuid) | |
locations[].slug | string | |
locations[].name | object | |
locations[].name.nl | string | |
locations[].name.fr | string | |
locations[].name.en | string |
| Status | Code | When |
|---|---|---|
| 404 | storefront_not_found | No restaurant has connected it. |
get/v1/storefronts/{subdomain}/pages/{key}
Get the privacy notice or terms
The restaurant's own text in NL / FR / EN; body null means it uses Taventi's default text.
SDK: client.getStorefrontPage()
| Parameter | In | Description |
|---|---|---|
subdomain | path | The restaurant's subdomain. |
key | path | privacy or terms. |
curl "https://api.taventi.app/v1/storefronts/beastie/pages/privacy"Response 200 · ContentPage
| Field | Type | Notes |
|---|---|---|
key | "privacy" | "terms" | |
body | object | null | |
body.nl | string | |
body.fr | string | |
body.en | string | |
updatedAt | string (ISO date-time) | null |
Takeaway
post/v1/carts/price
Price a cart
Taventi's prices and totals for a cart. Show these, never your own sums: the order is charged at these prices. Unknown products, sold-out items or options that break a group's rules answer 422 cart_invalid with the reasons in details.
SDK: client.priceCart() · At most 120 requests per minute per IP address.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
locationId | string (uuid) | Yes | |
lines | object[] | Yes | 1–100 items |
lines[].productId | string (uuid) | Yes | |
lines[].quantity | integer | Yes | 1–99 |
lines[].modifierIds | string (uuid)[] | at most 50 items · default [] |
curl -X POST "https://api.taventi.app/v1/carts/price" \
-H "Content-Type: application/json" \
-d '{
"locationId": "6f0c…",
"lines": [
{
"productId": "a12a…",
"quantity": 2,
"modifierIds": [
"c41e…"
]
}
]
}'Response 200 · PricedCart
| Field | Type | Notes |
|---|---|---|
locationId | string (uuid) | |
currency | "EUR" | |
lines | object[] | |
lines[].productId | string (uuid) | |
lines[].quantity | integer | -9007199254740991–9007199254740991 |
lines[].modifierIds | string (uuid)[] | |
lines[].unitPriceCents | integer | 0–9007199254740991 |
lines[].lineTotalCents | integer | 0–9007199254740991 |
itemCount | integer | -9007199254740991–9007199254740991 |
subtotalCents | integer | 0–9007199254740991 |
totalCents | integer | 0–9007199254740991 |
| Status | Code | When |
|---|---|---|
| 422 | cart_invalid | A line can't be ordered as sent. |
get/v1/locations/{slug}/pickup-slots
List pickup times
The pickup times guests can choose now (from opening hours, preparation time and slot capacity), the first one for “as soon as possible”, and whether the location takes orders at all.
SDK: client.getPickupSlots() · At most 120 requests per minute per IP address.
| Parameter | In | Description |
|---|---|---|
slug | path | The location's slug, e.g. beastie-antwerp. |
curl "https://api.taventi.app/v1/locations/beastie-antwerp/pickup-slots"Response 200 · PickupSlotsResponse
| Field | Type | Notes |
|---|---|---|
timeZone | string | |
acceptingOrders | boolean | |
asap | object | |
asap.available | boolean | |
asap.pickupAt | string (ISO date-time) | null | |
slots | object[] | |
slots[].startsAt | string (ISO date-time) | |
slots[].endsAt | string (ISO date-time) | |
slots[].available | boolean |
post/v1/orders
Place an order
Places a takeaway order, paid at pickup. Send a unique Idempotency-Key per checkout and reuse it when retrying: the same request with the same key returns the first order (200) instead of creating another (201).
SDK: client.createOrder() · At most 10 requests per 10 minutes per IP address.
| Parameter | In | Description |
|---|---|---|
Idempotency-Key | header | Required. Unique per checkout (16–128 letters, digits, _ or -); reuse it to retry. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
locationId | string (uuid) | Yes | |
lines | object[] | Yes | 1–100 items |
lines[].productId | string (uuid) | Yes | |
lines[].quantity | integer | Yes | 1–99 |
lines[].modifierIds | string (uuid)[] | at most 50 items · default [] | |
customer | object | Yes | |
customer.name | string | Yes | 1–120 characters |
customer.phone | string | Yes | |
customer.email | string (email) | at most 254 characters | |
pickup | object | Yes | |
pickup.type | "asap" | "scheduled" | Yes | |
pickup.at | string (ISO date-time) | ||
notes | string | at most 500 characters | |
locale | "nl" | "fr" | "en" | default "nl" | |
source | "storefront" | "widget" | "api" | "dashboard" | default "api" | |
guestPass | string | at most 1000 characters |
curl -X POST "https://api.taventi.app/v1/orders" \
-H "Idempotency-Key: checkout_7d1f0a7c2b9e4d51" \
-H "Content-Type: application/json" \
-d '{
"locationId": "6f0c…",
"lines": [
{
"productId": "a12a…",
"quantity": 2,
"modifierIds": []
}
],
"customer": {
"name": "Lena",
"phone": "+32 470 12 34 56",
"email": "lena@example.com"
},
"pickup": {
"type": "asap"
},
"locale": "nl",
"guestPass": "v1.eyJv…"
}'Response 201 · Order
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
number | string | |
locationId | string (uuid) | |
status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | |
pickupAt | string (ISO date-time) | |
isAsap | boolean | |
customer | object | |
customer.name | string | 1–120 characters |
customer.phone | string | |
customer.email | string (email) | at most 254 characters |
notes | string | null | |
items | object[] | |
items[].id | string (uuid) | |
items[].productId | string (uuid) | null | |
items[].name | object | |
items[].name.nl | string | |
items[].name.fr | string | |
items[].name.en | string | |
items[].quantity | integer | -9007199254740991–9007199254740991 |
items[].unitPriceCents | integer | 0–9007199254740991 |
items[].lineTotalCents | integer | 0–9007199254740991 |
items[].modifiers | object[] | |
items[].modifiers[].modifierId | string (uuid) | |
items[].modifiers[].name | object | |
items[].modifiers[].name.nl | string | |
items[].modifiers[].name.fr | string | |
items[].modifiers[].name.en | string | |
items[].modifiers[].priceDeltaCents | integer | -9007199254740991–9007199254740991 |
currency | "EUR" | |
subtotalCents | integer | 0–9007199254740991 |
totalCents | integer | 0–9007199254740991 |
payment | object | |
payment.method | "pay_at_pickup" | |
payment.status | "unpaid" | "paid" | "refunded" | |
createdAt | string (ISO date-time) |
| Status | Code | When |
|---|---|---|
| 400 | idempotency_key_required | The header is missing. |
| 400 | source_not_allowed | source is dashboard (staff only). |
| 409 | idempotency_key_reused | The key was used for another order. |
| 409 | takeaway_closed | The location isn't taking orders. |
| 409 | pickup_time_unavailable | The chosen time just filled up. |
| 409 | restaurant_unavailable | The restaurant isn't taking orders or bookings online. |
| 422 | cart_invalid | A line can't be ordered as sent. |
| 422 | guest_check_required | The location checks guests (guestCheck) and guestPass is missing, expired or for another email. |
get/v1/orders/{id}/status
Track an order
Number, status and pickup time, for a tracking page. No personal data.
SDK: client.getOrderStatus() · At most 120 requests per minute per IP address.
| Parameter | In | Description |
|---|---|---|
id | path | The order's id. |
curl "https://api.taventi.app/v1/orders/<id>/status"Response 200 · OrderStatusResponse
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
number | string | |
status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | |
pickupAt | string (ISO date-time) |
Reservations
get/v1/locations/{slug}/reservations/availability
List free times
The times a party of this size can book on a date, from the location's tables, combinations and booking settings.
SDK: client.getReservationAvailability() · At most 120 requests per minute per IP address.
| Parameter | In | Description |
|---|---|---|
slug | path | The location's slug, e.g. beastie-antwerp. |
Query
| Field | Type | Required | Notes |
|---|---|---|---|
date | string (date) | Yes | |
partySize | number | Yes |
curl "https://api.taventi.app/v1/locations/beastie-antwerp/reservations/availability?date=2026-12-04&partySize=4"Response 200 · ReservationAvailability
| Field | Type | Notes |
|---|---|---|
locationId | string (uuid) | |
timeZone | string | |
acceptingReservations | boolean | |
date | string (date) | |
partySize | integer | 1–100 |
minPartySize | integer | -9007199254740991–9007199254740991 |
maxPartySize | integer | -9007199254740991–9007199254740991 |
lastDate | string (date) | |
times | object[] | |
times[].startsAt | string (ISO date-time) | |
times[].available | boolean |
post/v1/reservations
Book a table
Books a table, confirmed at once or waiting for the restaurant, depending on its settings. Idempotent like orders.
SDK: client.createReservation() · At most 10 requests per 10 minutes per IP address.
| Parameter | In | Description |
|---|---|---|
Idempotency-Key | header | Required. Unique per checkout (16–128 letters, digits, _ or -); reuse it to retry. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
locationId | string (uuid) | Yes | |
startsAt | string (ISO date-time) | Yes | |
partySize | integer | Yes | 1–100 |
guest | object | Yes | |
guest.name | string | Yes | 1–120 characters |
guest.phone | string | Yes | |
guest.email | string (email) | Yes | at most 254 characters |
notes | string | at most 500 characters | |
locale | "nl" | "fr" | "en" | default "nl" | |
source | "storefront" | "widget" | "api" | default "api" | |
guestPass | string | at most 1000 characters |
curl -X POST "https://api.taventi.app/v1/reservations" \
-H "Idempotency-Key: checkout_7d1f0a7c2b9e4d51" \
-H "Content-Type: application/json" \
-d '{
"locationId": "6f0c…",
"startsAt": "2026-12-04T19:30:00+01:00",
"partySize": 4,
"guest": {
"name": "Lena",
"phone": "+32 470 12 34 56",
"email": "lena@example.com"
},
"notes": "A high chair, please",
"locale": "nl",
"guestPass": "v1.eyJv…"
}'Response 201 · PublicReservation
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
locationId | string (uuid) | |
status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | |
startsAt | string (ISO date-time) | |
partySize | integer | -9007199254740991–9007199254740991 |
canCancel | boolean | |
cancelUntil | string (ISO date-time) |
| Status | Code | When |
|---|---|---|
| 409 | reservations_closed | The location doesn't take bookings. |
| 409 | time_unavailable | The time was just taken. |
| 409 | restaurant_unavailable | The restaurant isn't taking orders or bookings online. |
| 422 | party_size_not_bookable | Too few or too many guests. |
| 422 | guest_check_required | The location checks guests (guestCheck) and guestPass is missing, expired or for another email. |
get/v1/reservations/{id}
Get a booking
Status, time and party, and whether the guest may still cancel online.
SDK: client.getReservation() · At most 120 requests per minute per IP address.
| Parameter | In | Description |
|---|---|---|
id | path | The reservation's id. |
curl "https://api.taventi.app/v1/reservations/<id>"Response 200 · PublicReservation
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
locationId | string (uuid) | |
status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | |
startsAt | string (ISO date-time) | |
partySize | integer | -9007199254740991–9007199254740991 |
canCancel | boolean | |
cancelUntil | string (ISO date-time) |
post/v1/reservations/{id}/cancel
Cancel a booking
Cancels for the guest while canCancel is true (before the location's notice).
SDK: client.cancelReservation() · At most 10 requests per 10 minutes per IP address.
| Parameter | In | Description |
|---|---|---|
id | path | The reservation's id. |
curl -X POST "https://api.taventi.app/v1/reservations/<id>/cancel"Response 200 · PublicReservation
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
locationId | string (uuid) | |
status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | |
startsAt | string (ISO date-time) | |
partySize | integer | -9007199254740991–9007199254740991 |
canCancel | boolean | |
cancelUntil | string (ISO date-time) |
Guest checks
post/v1/guest-checks
Email a code
Against fake orders and no-shows: where a location checks guests (guestCheck: true on its menu), guests confirm their email before ordering or booking online. This emails a 6-digit code that works thirty minutes. Skip it when you already hold a guestPass for this email.
SDK: client.startGuestCheck() · At most 10 requests per 10 minutes per IP address.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
locationId | string (uuid) | Yes | |
email | string | Yes | |
locale | "nl" | "fr" | "en" | default "nl" |
curl -X POST "https://api.taventi.app/v1/guest-checks" \
-H "Content-Type: application/json" \
-d '{
"locationId": "6f0c…",
"email": "lena@example.com",
"locale": "nl"
}'Response 201 · GuestCheckStarted
| Field | Type | Notes |
|---|---|---|
checkId | string (uuid) | |
expiresAt | string (ISO date-time) |
| Status | Code | When |
|---|---|---|
| 404 | location_not_found | No location has this id. |
| 429 | guest_codes_too_many | Three codes for this email in 15 minutes. |
post/v1/guest-checks/{checkId}/confirm
Confirm the code
A right code gives a guestPass for this restaurant and email. Send it as guestPass with orders and bookings made with that email, and keep it on the guest's device: it works for about six months, so returning guests aren't asked again.
SDK: client.confirmGuestCheck() · At most 30 requests per 10 minutes per IP address.
| Parameter | In | Description |
|---|---|---|
checkId | path | From the code's answer. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
code | string | Yes |
curl -X POST "https://api.taventi.app/v1/guest-checks/<checkId>/confirm" \
-H "Content-Type: application/json" \
-d '{
"code": "482913"
}'Response 200 · GuestPass
| Field | Type | Notes |
|---|---|---|
guestPass | string | |
email | string | |
expiresAt | string (ISO date-time) |
| Status | Code | When |
|---|---|---|
| 404 | guest_check_not_found | Unknown or already used: send a new code. |
| 422 | guest_code_wrong | The code isn't right. |
| 422 | guest_code_expired | The thirty minutes are over. |
| 422 | guest_code_tries | Five wrong tries: send a new code. |
Platform
get/health
Check the API
Whether the API and its database are up, and the Taventi version.
SDK: client.health()
curl "https://api.taventi.app/health"Response 200 · HealthResponse
| Field | Type | Notes |
|---|---|---|
status | "ok" | "degraded" | |
checks | map of "up" | "down" | |
time | string (ISO date-time) | |
version | string |
Restaurant API
A restaurant's own endpoints, for its own systems and its agency: today's orders, accepting them, selling out a dish, the day's bookings. The owner (or anyone allowed to manage integrations) makes a key under Integrations → API keys, chooses what it may do, and copies it once. The restaurant's id is shown there too.
Authorization: Bearer tav_live_…- Keep keys on a server: never in a web page or an app, where anyone can read them.
- A key acts as the team member who made it, limited to what it was given. When that member leaves the team or loses a permission, the key loses it too.
- A key works for its own restaurant only; agencies get one key per restaurant. Changes made with a key are in the restaurant's activity log, with the key's name.
- Revoking a key stops it at once.
get/v1/organizations/{organizationId}/locations/{locationId}/orders/board
Today's orders
The order board of one location: new, preparing, ready, later today, scheduled and done. Guests' phone and email need customers.contact.view too.
API key with orders.view
| Parameter | In | Description |
|---|---|---|
organizationId | path | Your restaurant's id, shown next to its API keys (Integrations → API keys). |
locationId | path | The location's id. |
curl "https://api.taventi.app/v1/organizations/<organizationId>/locations/<locationId>/orders/board"Response 200 · OrderBoard
| Field | Type | Notes |
|---|---|---|
now | string (ISO date-time) | |
timeZone | string | |
takeaway | object | |
takeaway.enabled | boolean | |
takeaway.paused | boolean | |
takeaway.prepMinutes | integer | -9007199254740991–9007199254740991 |
active | object[] | |
active[].id | string (uuid) | |
active[].number | string | |
active[].status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | |
active[].source | "storefront" | "widget" | "api" | "dashboard" | |
active[].pickupAt | string (ISO date-time) | |
active[].isAsap | boolean | |
active[].createdAt | string (ISO date-time) | |
active[].customer | object | |
active[].customer.name | string | |
active[].customer.phone | string | |
active[].customer.email | string | null | |
active[].customer.masked | boolean | |
active[].notes | string | null | |
active[].items | object[] | |
active[].items[].name | object | |
active[].items[].name.nl | string | |
active[].items[].name.fr | string | |
active[].items[].name.en | string | |
active[].items[].quantity | integer | -9007199254740991–9007199254740991 |
active[].items[].options | object[] | |
active[].totalCents | integer | 0–9007199254740991 |
done | object[] | |
done[].id | string (uuid) | |
done[].number | string | |
done[].status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | |
done[].source | "storefront" | "widget" | "api" | "dashboard" | |
done[].pickupAt | string (ISO date-time) | |
done[].isAsap | boolean | |
done[].createdAt | string (ISO date-time) | |
done[].customer | object | |
done[].customer.name | string | |
done[].customer.phone | string | |
done[].customer.email | string | null | |
done[].customer.masked | boolean | |
done[].notes | string | null | |
done[].items | object[] | |
done[].items[].name | object | |
done[].items[].name.nl | string | |
done[].items[].name.fr | string | |
done[].items[].name.en | string | |
done[].items[].quantity | integer | -9007199254740991–9007199254740991 |
done[].items[].options | object[] | |
done[].totalCents | integer | 0–9007199254740991 |
post/v1/organizations/{organizationId}/orders/{id}/status
Change an order's status
Accept or reject a new order, then preparing, ready, completed, or cancelled. The guest gets the matching email.
API key with orders.edit
| Parameter | In | Description |
|---|---|---|
organizationId | path | Your restaurant's id, shown next to its API keys (Integrations → API keys). |
id | path | The order's id. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | Yes |
curl -X POST "https://api.taventi.app/v1/organizations/<organizationId>/orders/<id>/status" \
-H "Content-Type: application/json" \
-d '{
"status": "accepted"
}'Response 200 · BoardOrder
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
number | string | |
status | "pending" | "accepted" | "rejected" | "preparing" | "ready" | "completed" | "cancelled" | |
source | "storefront" | "widget" | "api" | "dashboard" | |
pickupAt | string (ISO date-time) | |
isAsap | boolean | |
createdAt | string (ISO date-time) | |
customer | object | |
customer.name | string | |
customer.phone | string | |
customer.email | string | null | |
customer.masked | boolean | |
notes | string | null | |
items | object[] | |
items[].name | object | |
items[].name.nl | string | |
items[].name.fr | string | |
items[].name.en | string | |
items[].quantity | integer | -9007199254740991–9007199254740991 |
items[].options | object[] | |
items[].options[].nl | string | |
items[].options[].fr | string | |
items[].options[].en | string | |
totalCents | integer | 0–9007199254740991 |
| Status | Code | When |
|---|---|---|
| 409 | order_status_conflict | That step isn't possible now. |
post/v1/organizations/{organizationId}/locations/{locationId}/takeaway/pause
Pause or resume takeaway
Stop new orders now (e.g. when the kitchen is overrun), and start again.
API key with orders.edit
| Parameter | In | Description |
|---|---|---|
organizationId | path | Your restaurant's id, shown next to its API keys (Integrations → API keys). |
locationId | path | The location's id. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
paused | boolean | Yes |
curl -X POST "https://api.taventi.app/v1/organizations/<organizationId>/locations/<locationId>/takeaway/pause" \
-H "Content-Type: application/json" \
-d '{
"paused": true
}'Response 200 · PauseTakeaway
| Field | Type | Notes |
|---|---|---|
paused | boolean |
get/v1/organizations/{organizationId}/reservations
A day's bookings
One location's bookings on one date (today and the first location when left out).
API key with reservations.view
| Parameter | In | Description |
|---|---|---|
organizationId | path | Your restaurant's id, shown next to its API keys (Integrations → API keys). |
Query
| Field | Type | Required | Notes |
|---|---|---|---|
location | string (uuid) | ||
date | string (date) |
curl "https://api.taventi.app/v1/organizations/<organizationId>/reservations?date=2026-12-04&partySize=4"Response 200 · ReservationDay
| Field | Type | Notes |
|---|---|---|
now | string (ISO date-time) | |
locationId | string (uuid) | |
locations | object[] | |
locations[].id | string (uuid) | |
locations[].name | object | |
locations[].name.nl | string | |
locations[].name.fr | string | |
locations[].name.en | string | |
timeZone | string | |
date | string (date) | |
enabled | boolean | |
hasTables | boolean | |
durationMinutes | integer | -9007199254740991–9007199254740991 |
reservations | object[] | |
reservations[].id | string (uuid) | |
reservations[].status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | |
reservations[].source | "storefront" | "widget" | "api" | "phone" | "walk_in" | |
reservations[].startsAt | string (ISO date-time) | |
reservations[].endsAt | string (ISO date-time) | |
reservations[].partySize | integer | -9007199254740991–9007199254740991 |
reservations[].guest | object | |
reservations[].guest.name | string | |
reservations[].guest.phone | string | null | |
reservations[].guest.email | string | null | |
reservations[].guest.masked | boolean | |
reservations[].notes | string | null | |
reservations[].tables | object[] | |
reservations[].tables[].id | string (uuid) | |
reservations[].tables[].name | string | |
reservations[].createdAt | string (ISO date-time) |
post/v1/organizations/{organizationId}/reservations/{id}/status
Change a booking's status
confirmed or declined (a pending booking), seated, no_show, completed (finished) or cancelled.
API key with reservations.edit
| Parameter | In | Description |
|---|---|---|
organizationId | path | Your restaurant's id, shown next to its API keys (Integrations → API keys). |
id | path | The reservation's id. |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | Yes |
curl -X POST "https://api.taventi.app/v1/organizations/<organizationId>/reservations/<id>/status" \
-H "Content-Type: application/json" \
-d '{
"status": "seated"
}'Response 200 · BookedReservation
| Field | Type | Notes |
|---|---|---|
id | string (uuid) | |
status | "pending" | "confirmed" | "seated" | "completed" | "declined" | "cancelled" | "no_show" | |
source | "storefront" | "widget" | "api" | "phone" | "walk_in" | |
startsAt | string (ISO date-time) | |
endsAt | string (ISO date-time) | |
partySize | integer | -9007199254740991–9007199254740991 |
guest | object | |
guest.name | string | |
guest.phone | string | null | |
guest.email | string | null | |
guest.masked | boolean | |
notes | string | null | |
tables | object[] | |
tables[].id | string (uuid) | |
tables[].name | string | |
createdAt | string (ISO date-time) |