API reference / Demo tools
Demo tools
The Demo tools endpoints of the Voiceland AI API, with parameters, schemas and curl examples.
Last updated:
GET /v1/demo/bookings#
Demo: a customer's bookings. Same fixture family: no key, CORS-open, deterministic per reference, nothing stored. Bookings come back in the shape the calendar API uses, so a template built against the demo moves to the real calendar without changing the prompt.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
email |
query |
string | Customer email (first reference tried). | |
phone |
query |
string | Customer phone (when email is absent). | |
uid |
query |
string | Booking uid (when both are absent). |
Responses
| Code | Description |
|---|---|
200 |
Success. |
401 |
Missing or invalid API key. |
4XX |
Request error (validation, not-found, etc.). |
5XX |
Server or upstream error. |
Example request
curl "https://api.voiceland.ai/v1/demo/bookings" \
-H "Authorization: Bearer VL_API_KEY"Example response
{
"bookings": [
{
"attendees": [
{
"email": "maria@example.com",
"name": "Maria Papadopoulou"
}
],
"duration_min": 30,
"end": "2026-09-15T10:30:00+03:00",
"meeting_url": "https://example.com/demo-1",
"start": "2026-09-15T10:00:00+03:00",
"status": "accepted",
"timezone": "Europe/Athens",
"title": "Consultation",
"uid": "bk-1a2b3c"
}
],
"demo": true,
"timezone": "Europe/Athens"
}GET /v1/demo/orders#
Demo: look up an order. A fixture for trying custom tools before you own an API, the demo agent templates point their tools here. No key and CORS-open, so it also works as a visitor-executed tool from a browser. Deterministic: the same order_id always returns the same order; without one it returns three recent orders as {"orders": […], "demo": true}. Nothing is stored.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
order_id |
query |
string | Order reference (orderId is accepted too). Omit for the recent list. |
Responses
| Code | Description |
|---|---|
200 |
Success. |
401 |
Missing or invalid API key. |
4XX |
Request error (validation, not-found, etc.). |
5XX |
Server or upstream error. |
Example request
curl "https://api.voiceland.ai/v1/demo/orders" \
-H "Authorization: Bearer VL_API_KEY"Example response
{
"carrier": "Courier",
"estimated_delivery": "2026-09-15",
"items": [
{
"name": "Noise-cancelling headset",
"price_eur": 149,
"quantity": 1,
"sku": "VL-HS-02"
},
{
"name": "USB-C cable, 2m",
"price_eur": 12.9,
"quantity": 1,
"sku": "VL-CB-07"
}
],
"order_id": "A-1008",
"placed_on": "2026-09-08",
"status": "shipped",
"total_eur": 161.9,
"tracking_number": "TRK1234567890"
}GET /v1/demo/temperatures#
Demo: current weather for a city. Same fixture family as /demo/orders: no key, CORS-open, deterministic per city, nothing stored. Defaults to Athens.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
city |
query |
string | City name. |
Responses
| Code | Description |
|---|---|
200 |
Success. |
401 |
Missing or invalid API key. |
4XX |
Request error (validation, not-found, etc.). |
5XX |
Server or upstream error. |
Example request
curl "https://api.voiceland.ai/v1/demo/temperatures" \
-H "Authorization: Bearer VL_API_KEY"Example response
{
"city": "Athens",
"conditions": "clear",
"feels_like_c": 23,
"humidity_pct": 41,
"observed_at": "2026-09-13T12:00:00+03:00",
"temperature_c": 24,
"wind_kph": 12
}Schemas#
Error#
Error envelope returned for non-2xx responses.
| Field | Type | Required | Description |
|---|---|---|---|
error |
object | Yes |