# TheFork B2B API (slim)

> TheFork's B2B API lets restaurants and their software partners, such as CRM vendors and AI phone agents, read availability and create, change and cancel reservations in TheFork Manager, with webhooks, reviews and customer data.

- Full: https://www.anchorterminal.com/tools/thefork.md (~5,450 tokens) · this version ~1,580 tokens · JSON https://www.anchorterminal.com/tools/thefork.json · canonical https://www.anchorterminal.com/tools/thefork
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-14

**E · 43.6/100 · rank #951 of 1076 · #4 in Restaurant & local bookings · not agent-ready · confidence medium**


Assessment: A venue-side API with a generated OpenAPI 3.1 schema, an llms.txt written for agents and nine OAuth scopes down to read-only availability. It acts for restaurants and their vendors, not diners, needs partner approval, cannot take card guarantees, and has no public status page, changelog or published prices.

## Facts

- Kind: HTTP API · vendor: TheFork (La Fourchette SAS) · category: Restaurant & local bookings · legal entity: La Fourchette SAS · provenance 60/100
- Endpoint: `https://api.thefork.io/manager` (HTTP)
- Auth: OAuth · pricing: Your plan · x402: no · licence: Proprietary service under TheFork Partners API Terms of Use (La Fourchette SAS) and any core agreement with TheFork
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The B2B API (TheFork Manager) at https://api.thefork.io/manager/v1. The separate POS API is not graded. The portal's partner section is marked available soon. No official MCP server was found
- Diner or venue: Venue. The API acts for restaurants and restaurant groups, or for software vendors they authorise, on TheFork Manager
- Endpoints: Booking flow (availabilities, timeslots, party sizes, promotions and set menus, availability override, create, update and cancel reservation), data (reservations and customers), reviews and replies, phone (customer by phone, caller ID, integration status)
- Credentials: OAuth 2.0 client credentials from auth.thefork.io, Bearer token valid 8,600 seconds, nine scopes listed in the schema
- Rate limits: Set by contract and not stated in the docs. The Partners API terms give 200 calls a minute and 10,000 a day by default. 429 with exponential backoff advised
- Errors: Three formats. API errors carry statusCode, error and data.code. Gateway errors (401, 403, 429, 503) carry only a message. Token errors use error and error_description
- Webhooks: Activated by TheFork for a URL you send them. Payloads carry entityType, uuid and eventType for customers, reservations and reviews. Acknowledge with 200 or the event is resent
- Deposits: No payment field on booking. Timeslots that need a payment guarantee return 400 PAYMENT_GUARANTEE_NOT_SUPPORTED
- Versioning: One version (v1) for the whole API. A breaking change creates a new version, and the old one is supported for 6 months

- Scores: Reliability 35, Performance pending, Schema & documentation 87, Agent ergonomics 56, Security & auth 42, Payments & pricing 5, Task success pending, Maintenance & community 15, Transparency & trust 47 · total over the 7 assessed categories
- Why: Reliability, Graded as a hosted API. · Schema & documentation, OpenAPI 3.1.0 schema at api.thefork.io/manager/openapi.json, generated from the deployed code, with 19 operations and the scopes (25). · Agent ergonomics, List endpoints return UUIDs only and need one detail call per item, which keeps lists small but multiplies calls. · Security & auth, OAuth 2.0 client credentials with nine scopes in the schema, from full access down to read-only availability. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, No changelog or dated release notes. · Transparency & trust, Closed service.
- Sources: 8, open questions: 5, both in the full twin
- Capabilities: booking.reservations, booking.availability, booking.venue, crm.records, events.webhooks-send
- JSON: https://www.anchorterminal.com/api/v1/tools/thefork.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/thefork.svg` or a link to https://www.anchorterminal.com/tools/thefork from a page on thefork.io or thefork.com or one of their subdomains, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Read hasPaymentGuaranteeRequirement in the timeslots response before booking, since the API cannot take a card
2. Check the status field after creating a reservation and treat REQUESTED as unconfirmed
3. Send the timeslot datetime unchanged as mealDate, because times are the restaurant's local time
4. Check for an existing reservation before retrying a failed POST, as no idempotency key exists and 409 signals DOUBLE_BOOKING
5. Cache the access token for its 8,600 seconds and do not request a new one while it is valid

## Connect

```bash
curl -X POST https://auth.thefork.io/oauth/token -H 'Content-Type: application/x-www-form-urlencoded' -d 'audience=https://api.thefork.io&grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/thefork

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Eat App Partner API | D | 53.4 | booking.reservations, booking.availability, booking.venue, crm.records, events.webhooks-send | https://www.anchorterminal.com/tools/eat-app.min.md |
| OpenTable APIs | E | 38.6 | booking.availability, booking.reservations, booking.venue, crm.records | https://www.anchorterminal.com/tools/opentable.min.md |
| SevenRooms | F | 17.7 | booking.venue, booking.reservations, booking.availability, crm.records | https://www.anchorterminal.com/tools/sevenrooms.min.md |
| TableCheck API | C | 57.1 | booking.availability, booking.reservations, booking.venue | https://www.anchorterminal.com/tools/tablecheck.min.md |
| Resy | F | 10.3 | booking.reservations, booking.availability, booking.venue | https://www.anchorterminal.com/tools/resy.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)