TheFork

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.

TheFork publishes 4 APIs on the APIs.io network, including Customers API, Orders API, Reservations API, and 1 more. Tagged areas include Restaurant, Reservations, Booking, Dining, and Point Of Sale.

The TheFork catalog on APIs.io includes 3 JSON-LD contexts and 2 Spectral governance rulesets.

TheFork’s developer surface includes authentication, documentation, developer portal, getting-started guide, signup flow, engineering blog, and 13 more developer resources.

🌐 Visit website 📡 Source on GitHub

56.4/100 strong ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessSelf serve

4 APIs 7 Features 4 Use Cases

RestaurantReservationsBookingDiningPoint Of SaleMarketplace

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 56.4/100 · strong

Contract Quality 20.2 / 25

Developer Ergonomics 9.1 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 3.4 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/thefork: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

TheFork Customers API

Look up customer and guest profile data.

TheFork Orders API

Open and close point-of-sale orders tied to reservations.

TheFork Reservations API

Create, retrieve, and update reservations.

TheFork Reviews API

Retrieve guest review details.

Postman Collections 4

Ready-to-run Postman collections for exercising this provider's APIs.

TheFork B2B Customers API

POSTMAN

TheFork B2B Customers Orders API

POSTMAN

TheFork B2B Customers Reservations API

POSTMAN

TheFork B2B Customers Reviews API

POSTMAN

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

TheFork B2B API

OPEN COLLECTION

TheFork POS API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Thefork Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Thefork Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Thefork Finops

FINOPS

Features 7

Notable capabilities this provider offers.

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.

Scroll for all 7

Semantic Vocabularies 3

JSON-LD contexts and semantic vocabularies used across these APIs.

Thefork B2B Context

8 classes · 26 properties

JSON-LD

Thefork Context

12 classes · 36 properties

JSON-LD

Thefork Pos Context

7 classes · 23 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

TheFork API Rules

5 rules · 3 warnings 2 info

SPECTRAL

TheFork API Rules

11 rules · 4 errors 6 warnings 1 info

SPECTRAL

JSON Schema 15

Standalone JSON Schema definitions for this provider's data models.

CustomerInput

4 properties

JSON SCHEMA

Customer

8 properties

JSON SCHEMA

Offer

4 properties

JSON SCHEMA

ReservationCreateRequest

6 properties

JSON SCHEMA

Reservation

9 properties

JSON SCHEMA

ReservationStatus

0 properties

JSON SCHEMA

ReservationUpdateRequest

2 properties

JSON SCHEMA

Review

6 properties

JSON SCHEMA

Customer

5 properties

JSON SCHEMA

Money

2 properties

JSON SCHEMA

Offer

4 properties

JSON SCHEMA

OrderClose

2 properties

JSON SCHEMA

Order

9 properties

JSON SCHEMA

ReservationStatus

0 properties

JSON SCHEMA

Table

2 properties

JSON SCHEMA

Scroll for all 15

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Thefork B2B Reservation Structure

9 properties

JSON STRUCTURE

Thefork Pos Order Structure

9 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Thefork B2B Create Reservation Example

2 fields

EXAMPLE

Thefork B2B Find Customer By Phone Example

2 fields

EXAMPLE

Thefork B2B Get Reservation Example

2 fields

EXAMPLE

Thefork B2B Get Review Example

2 fields

EXAMPLE

Thefork Pos Create Order Example

2 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Thefork Authentication

apiKey/http/oauth2 · 3 schemes

SECURITY

Thefork Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Thefork Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Thefork Agentic Access

8 operations · 4 acting

AGENTIC

Use Cases 4

What developers build with this provider.

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.

Integrations 4

Pre-built integrations with other platforms and tools.

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.

Solutions 3

Packaged solutions this provider offers.

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).

Resources

Get Started 3

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Signup

Signup

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRules

SpectralRules

Vocabulary

Vocabulary

JSONLD

JSONLD

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

OAuthScopes

OAuthScopes

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

Plans

Plans

FinOps

FinOps

Company 2

The organization behind the API

Website

Website

Blog

Blog

Source (apis.yml)

aid: thefork
name: TheFork
description: 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.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/thefork.png
tags:
- Restaurant
- Reservations
- Booking
- Dining
- Point Of Sale
- Marketplace
url: https://raw.githubusercontent.com/api-evangelist/thefork/refs/heads/main/apis.yml
created: '2026-06-02'
modified: '2026-06-03'
specificationVersion: '0.19'
apis:
- aid: thefork:thefork-customers-api
  name: TheFork Customers API
  description: Look up customer and guest profile data.
  humanURL: https://docs.thefork.io/B2B-API/introduction
  baseURL: https://api.thefork.io
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/thefork-customers-api-openapi.yml
  - type: Documentation
    url: https://docs.thefork.io/B2B-API/introduction
  - type: APIReference
    url: https://docs.thefork.io/B2B-API/API%20specifications/post-v-1-restaurants-id-reservations
  - type: GettingStarted
    url: https://docs.thefork.io/getting-started
  - type: Authentication
    url: https://docs.thefork.io/B2B-API/authentication
  - type: JSONSchema
    url: json-schema/thefork-b2b-reservation-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-customer-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-review-schema.json
  - type: JSONStructure
    url: json-structure/thefork-b2b-reservation-structure.json
  - type: JSONLD
    url: json-ld/thefork-b2b-context.jsonld
  - type: Examples
    url: examples/thefork-b2b-create-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-get-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-find-customer-by-phone-example.json
  - type: Examples
    url: examples/thefork-b2b-get-review-example.json
  - type: Documentation
    url: https://docs.thefork.io/POS-API/how-it-works
  - type: APIReference
    url: https://docs.thefork.io/POS-API/Flow/create-order
  - type: Authentication
    url: https://docs.thefork.io/preliminary-steps
  - type: JSONSchema
    url: json-schema/thefork-pos-order-schema.json
  - type: JSONStructure
    url: json-structure/thefork-pos-order-structure.json
  - type: Examples
    url: examples/thefork-pos-create-order-example.json
- aid: thefork:thefork-orders-api
  name: TheFork Orders API
  description: Open and close point-of-sale orders tied to reservations.
  humanURL: https://docs.thefork.io/B2B-API/introduction
  baseURL: https://api.thefork.io
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/thefork-orders-api-openapi.yml
  - type: Documentation
    url: https://docs.thefork.io/B2B-API/introduction
  - type: APIReference
    url: https://docs.thefork.io/B2B-API/API%20specifications/post-v-1-restaurants-id-reservations
  - type: GettingStarted
    url: https://docs.thefork.io/getting-started
  - type: Authentication
    url: https://docs.thefork.io/B2B-API/authentication
  - type: JSONSchema
    url: json-schema/thefork-b2b-reservation-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-customer-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-review-schema.json
  - type: JSONStructure
    url: json-structure/thefork-b2b-reservation-structure.json
  - type: JSONLD
    url: json-ld/thefork-b2b-context.jsonld
  - type: Examples
    url: examples/thefork-b2b-create-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-get-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-find-customer-by-phone-example.json
  - type: Examples
    url: examples/thefork-b2b-get-review-example.json
  - type: Documentation
    url: https://docs.thefork.io/POS-API/how-it-works
  - type: APIReference
    url: https://docs.thefork.io/POS-API/Flow/create-order
  - type: Authentication
    url: https://docs.thefork.io/preliminary-steps
  - type: JSONSchema
    url: json-schema/thefork-pos-order-schema.json
  - type: JSONStructure
    url: json-structure/thefork-pos-order-structure.json
  - type: Examples
    url: examples/thefork-pos-create-order-example.json
- aid: thefork:thefork-reservations-api
  name: TheFork Reservations API
  description: Create, retrieve, and update reservations.
  humanURL: https://docs.thefork.io/B2B-API/introduction
  baseURL: https://api.thefork.io
  tags:
  - Reservations
  properties:
  - type: OpenAPI
    url: openapi/thefork-reservations-api-openapi.yml
  - type: Documentation
    url: https://docs.thefork.io/B2B-API/introduction
  - type: APIReference
    url: https://docs.thefork.io/B2B-API/API%20specifications/post-v-1-restaurants-id-reservations
  - type: GettingStarted
    url: https://docs.thefork.io/getting-started
  - type: Authentication
    url: https://docs.thefork.io/B2B-API/authentication
  - type: JSONSchema
    url: json-schema/thefork-b2b-reservation-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-customer-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-review-schema.json
  - type: JSONStructure
    url: json-structure/thefork-b2b-reservation-structure.json
  - type: JSONLD
    url: json-ld/thefork-b2b-context.jsonld
  - type: Examples
    url: examples/thefork-b2b-create-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-get-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-find-customer-by-phone-example.json
  - type: Examples
    url: examples/thefork-b2b-get-review-example.json
  - type: Documentation
    url: https://docs.thefork.io/POS-API/how-it-works
  - type: APIReference
    url: https://docs.thefork.io/POS-API/Flow/create-order
  - type: Authentication
    url: https://docs.thefork.io/preliminary-steps
  - type: JSONSchema
    url: json-schema/thefork-pos-order-schema.json
  - type: JSONStructure
    url: json-structure/thefork-pos-order-structure.json
  - type: Examples
    url: examples/thefork-pos-create-order-example.json
- aid: thefork:thefork-reviews-api
  name: TheFork Reviews API
  description: Retrieve guest review details.
  humanURL: https://docs.thefork.io/B2B-API/introduction
  baseURL: https://api.thefork.io
  tags:
  - Reviews
  properties:
  - type: OpenAPI
    url: openapi/thefork-reviews-api-openapi.yml
  - type: Documentation
    url: https://docs.thefork.io/B2B-API/introduction
  - type: APIReference
    url: https://docs.thefork.io/B2B-API/API%20specifications/post-v-1-restaurants-id-reservations
  - type: GettingStarted
    url: https://docs.thefork.io/getting-started
  - type: Authentication
    url: https://docs.thefork.io/B2B-API/authentication
  - type: JSONSchema
    url: json-schema/thefork-b2b-reservation-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-customer-schema.json
  - type: JSONSchema
    url: json-schema/thefork-b2b-review-schema.json
  - type: JSONStructure
    url: json-structure/thefork-b2b-reservation-structure.json
  - type: JSONLD
    url: json-ld/thefork-b2b-context.jsonld
  - type: Examples
    url: examples/thefork-b2b-create-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-get-reservation-example.json
  - type: Examples
    url: examples/thefork-b2b-find-customer-by-phone-example.json
  - type: Examples
    url: examples/thefork-b2b-get-review-example.json
  - type: Documentation
    url: https://docs.thefork.io/POS-API/how-it-works
  - type: APIReference
    url: https://docs.thefork.io/POS-API/Flow/create-order
  - type: Authentication
    url: https://docs.thefork.io/preliminary-steps
  - type: JSONSchema
    url: json-schema/thefork-pos-order-schema.json
  - type: JSONStructure
    url: json-structure/thefork-pos-order-structure.json
  - type: Examples
    url: examples/thefork-pos-create-order-example.json
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/thefork/overview
- type: AgenticAccess
  url: agentic-access/thefork-agentic-access.yml
- type: DomainSecurity
  url: security/thefork-domain-security.yml
- type: Authentication
  url: authentication/thefork-authentication.yml
- type: OAuthScopes
  url: scopes/thefork-scopes.yml
- type: Website
  url: https://www.thefork.com
- type: Documentation
  url: https://docs.thefork.io/
- type: Portal
  url: https://docs.thefork.io/
- type: GettingStarted
  url: https://docs.thefork.io/getting-started
- type: Signup
  url: https://docs.thefork.io/preliminary-steps
- type: TermsOfService
  url: https://docs.thefork.io/pdf/LaFourchette-Partners-API-Licence-2.pdf
- type: Blog
  url: https://medium.com/thefork
- type: GitHubOrganization
  url: https://github.com/lafourchette
- type: SpectralRules
  url: rules/thefork-rules.yml
- type: Vocabulary
  url: vocabulary/thefork-vocabulary.yml
- type: JSONLD
  url: json-ld/thefork-context.jsonld
- type: Plans
  url: plans/thefork-plans-pricing.yml
- type: RateLimits
  url: rate-limits/thefork-rate-limits.yml
- type: FinOps
  url: finops/thefork-finops.yml
- type: Features
  data:
  - name: Custom Booking Funnel
    description: Build a custom booking flow with real-time availability, offers, and preset menus, then create reservations
      directly against a restaurant.
  - name: Reservation Management
    description: Create, retrieve, and update reservations including meal date, party size, and customer data.
  - name: Guest Profiles
    description: Access personalized guest data such as allergies, intolerances, dietary restrictions, and seating preferences.
  - name: Customer Lookup
    description: Find customer details by phone number for a given restaurant.
  - name: Reviews
    description: Retrieve guest review details by review UUID.
  - name: Asynchronous Data Sync
    description: Synchronize data without requiring real-time updates, using webhooks for reservation created and updated
      events.
  - name: POS Order Sync
    description: Open and close point-of-sale orders tied to reservations and sync final amounts back to TheFork Management.
- type: UseCases
  data:
  - name: Restaurant Booking Integration
    description: Restaurants and groups embed TheFork availability and booking into their own websites and apps.
  - name: POS Integration
    description: Point-of-sale vendors connect their systems to reflect seated guests, open tickets, and reconcile spend with
      reservations.
  - name: Guest Personalization
    description: Use allergy, dietary, and seating preferences to personalize the dining experience and pre-service preparation.
  - name: Review Aggregation
    description: Pull guest reviews into restaurant CRM and reputation tooling.
- type: Integrations
  data:
  - name: TheFork Management (TFM)
    description: The restaurant management platform the APIs synchronize with.
  - name: Tripadvisor
    description: Parent company; TheFork is part of the Tripadvisor group.
  - name: Auth0
    description: Identity provider issuing OAuth 2.0 client credentials tokens.
  - name: Kong
    description: API gateway fronting the public API with auth, rate limiting, and IP allowlisting.
- type: Solutions
  data:
  - name: For Restaurants
    description: B2B API for restaurants and groups to manage bookings and guests.
  - name: For POS Providers
    description: POS API for point-of-sale vendors to sync orders and reservations.
  - name: For Partners
    description: Partner API for third-party partners (announced as available soon).
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com