TheFork is a leading European restaurant reservations marketplace, part of Tripadvisor, connecting diners with tens of thousands of restaurants across Europe and beyond. Through its developers portal, TheFork exposes a public REST API surface for restaurants, point-of-sale systems, and third-party partners to integrate with TheFork Management platform. The API enables partners to build custom booking flows, create and manage reservations with full detail such as meal date, party size, and customer data, surface preset menus and curated dining experiences, and access personalized guest data including allergies, dietary restrictions, and seating preferences. Offerings include a B2B API for restaurants and a POS API for point-of-sale providers.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Restaurant, Reservations, Booking, Dining, Point Of Sale, Marketplace
- Created: 2026-06-02
- Modified: 2026-06-03
TheFork B2B API lets restaurants and groups integrate with TheFork Management platform. It supports designing custom booking flows, creating reservations with meal date, party size, and customer data, presenting preset menus, accessing personalized guest data such as allergies, dietary restrictions, and seating preferences, and retrieving guest reviews. The API is fronted by a Kong gateway and documented with OpenAPI 3. Authentication uses the Auth0 OAuth 2.0 client credentials flow to obtain a bearer access token.
Human URL: https://docs.thefork.io/B2B-API/introduction
- Reservations, Booking, Menus, Guests, Reviews
- Documentation
- APIReference
- GettingStarted
- Authentication
- OpenAPI
- JSONSchema
- JSONSchema
- JSONSchema
- JSONStructure
- JSON-LD
- Example
- Example
- Example
- Example
TheFork POS API enables point-of-sale providers to integrate their systems with TheFork Management platform, synchronizing reservations and restaurant operations data. TheFork calls the POS provider's configured webhook endpoints (for example a receipt opening URL) to open orders when a diner is seated, then receives final order details such as total amount and currency back, marking reservations as left when payment completes. Authentication uses an API key supplied in the X-Api-Key header for requests to TheFork, and a bearer token for callbacks.
Human URL: https://docs.thefork.io/POS-API/how-it-works
- Point Of Sale, Reservations, Orders
- Website
- Documentation
- Portal
- GettingStarted
- SignUp
- TermsOfService
- Blog
- GitHubOrganization
- SpectralRules
- Vocabulary
- JSON-LD
- Plans
- RateLimits
- FinOps
| Name | Description |
|---|---|
| Custom Booking Funnel | Build a custom booking flow with real-time availability, offers, and preset menus, then create reservations directly against a restaurant. |
| Reservation Management | Create, retrieve, and update reservations including meal date, party size, and customer data. |
| Guest Profiles | Access personalized guest data such as allergies, intolerances, dietary restrictions, and seating preferences. |
| Customer Lookup | Find customer details by phone number for a given restaurant. |
| Reviews | Retrieve guest review details by review UUID. |
| Asynchronous Data Sync | Synchronize data without requiring real-time updates, using webhooks for reservation created and updated events. |
| POS Order Sync | Open and close point-of-sale orders tied to reservations and sync final amounts back to TheFork Management. |
| Name | Description |
|---|---|
| Restaurant Booking Integration | Restaurants and groups embed TheFork availability and booking into their own websites and apps. |
| POS Integration | Point-of-sale vendors connect their systems to reflect seated guests, open tickets, and reconcile spend with reservations. |
| Guest Personalization | Use allergy, dietary, and seating preferences to personalize the dining experience and pre-service preparation. |
| Review Aggregation | Pull guest reviews into restaurant CRM and reputation tooling. |
| Name | Description |
|---|---|
| TheFork Management (TFM) | The restaurant management platform the APIs synchronize with. |
| Tripadvisor | Parent company; TheFork is part of the Tripadvisor group. |
| Auth0 | Identity provider issuing OAuth 2.0 client credentials tokens. |
| Kong | API gateway fronting the public API with auth, rate limiting, and IP allowlisting. |
| Name | Description |
|---|---|
| For Restaurants | B2B API for restaurants and groups to manage bookings and guests. |
| For POS Providers | POS API for point-of-sale vendors to sync orders and reservations. |
| For Partners | Partner API for third-party partners (announced as available soon). |
Machine-readable API specifications organized by format.
- 15 schema files in json-schema/ covering reservations, customers, reviews, orders, and supporting types.
- 5 request/response examples in examples/.
Naftiko capabilities organized as self-contained per-tag definitions, each exposing both a REST and an MCP adapter.
| Workflow | APIs Combined | Tools | Persona |
|---|---|---|---|
| Reservations | TheFork B2B API | 3 | Restaurant Integrator |
| Customers | TheFork B2B API | 2 | Restaurant Integrator |
| Reviews | TheFork B2B API | 1 | Restaurant Integrator |
| Orders | TheFork POS API | 2 | POS Provider |
- TheFork Vocabulary — Unified taxonomy mapping 4 resources, 7 actions, 4 workflows, and 2 personas across operational (OpenAPI) and capability (Naftiko) dimensions
- TheFork Spectral Rules — 11 rules enforcing TheFork API conventions (HTTPS hosts, kebab-case paths, camelCase properties, Title Case tags and summaries, security schemes)
- Plans & Pricing — Contract-based partner access model
- Rate Limits — Kong gateway, contract-defined per-partner limits
- FinOps — FOCUS-aligned billing view
FN: Kin Lane
Email: kin@apievangelist.com