Home
SpotOn
Reserve Reservation Structure
Reserve Reservation Structure
A created reservation.
Type: object
Properties: 7
Restaurant Point-of-Sale Payments Online Ordering Reservations Reporting
Reservation is a JSON Structure definition published by SpotOn, describing 7 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
reservationId
restaurantId
customerInformation
time
partySize
status
notes
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/spoton/refs/heads/main/json-structure/reserve-reservation-structure.json",
"name": "Reservation",
"description": "A created reservation.",
"type": "object",
"properties": {
"reservationId": {
"type": "string",
"description": "The unique identifier for the reservation."
},
"restaurantId": {
"type": "int32",
"description": "The restaurant the reservation belongs to."
},
"customerInformation": {
"type": "object",
"description": "Guest contact and identity details for a reservation or waitlist entry.",
"properties": {
"customerId": {
"type": "string",
"description": "Optional existing customer identifier."
},
"firstName": {
"type": "string",
"description": "Guest first name."
},
"lastName": {
"type": "string",
"description": "Guest last name."
},
"phoneNumber": {
"type": "string",
"description": "Guest phone number."
},
"email": {
"type": "string",
"description": "Guest email address."
},
"imageUrl": {
"type": "uri",
"description": "Optional URL of a guest image."
},
"memberNumber": {
"type": "string",
"description": "Optional loyalty member number."
},
"memberTier": {
"type": "string",
"description": "Optional loyalty member tier."
}
},
"required": [
"firstName",
"phoneNumber"
]
},
"time": {
"type": "datetime",
"description": "The reserved date and time, in RFC 3339 format."
},
"partySize": {
"type": "int32",
"description": "The number of guests in the party."
},
"status": {
"type": "string",
"description": "The current status of the reservation.",
"enum": [
"booked",
"confirmed",
"checked_in",
"cancelled"
]
},
"notes": {
"type": "string",
"description": "Notes attached to the reservation."
}
}
}
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools
Call it yourself
curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/reserve-reservation-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.