Sevenrooms Api Documentation Official

SevenRooms API enables hospitality operators to unify their guest data by connecting the platform to over 100 third-party tools, including point-of-sale (POS) systems, marketing platforms, and website widgets

  1. OAuth handshake to get access token.
  2. Webhook listener at /webhooks/sevenrooms receives reservation.created.
  3. Verify signature, parse payload → extract reservation_id, guest_id, party_size, datetime.
  4. GET /reservations/id to fetch full details (including special requests, table assignment).
  5. Transform data into POS format (e.g., create a “docket” or “order session”).
  6. Store external_pos_id in your DB, optionally PUT /reservations/id to add a custom field (pos_synced: true).
  7. Handle reservation.updated webhook to modify the POS session (party size change, cancellation).

When you exceed a limit, the API returns HTTP 429 Too Many Requests with a Retry-After header (in seconds). Implement exponential backoff in your integration—SevenRooms recommends starting with a 1-second wait, doubling each time. sevenrooms api documentation

| Code | Meaning | Handling | |------|---------|----------| | 200 | Success | – | | 400 | Bad request (invalid JSON, missing field) | Check request body against schema | | 401 | Unauthorized (invalid or expired token) | Refresh token or re-authenticate | | 403 | Forbidden (scope missing) | Request additional scopes | | 404 | Resource not found | Verify ID or venue context | | 409 | Conflict (e.g., double booking) | Retry with different time/table | | 429 | Rate limited | Backoff and retry | | 500 | Internal server error | Retry once after 5s, then escalate | SevenRooms API enables hospitality operators to unify their

  1. GET: Retrieve data from the API.
  2. POST: Create new data in the API.
  3. PUT: Update existing data in the API.
  4. DELETE: Delete data from the API.
  • Maximum of 100 reservations per page.
  • Date ranges cannot exceed 31 days for a single query.

that extracts JSON-formatted reservation data, and community programs for booking availability notifications SevenRooms Capabilities Covered in Documentation The API documentation typically provides endpoints for: Reservations : Pulling raw reservation data and managing seating. OAuth handshake to get access token

Privacy Preference Center

Privacy Preferences