# Get your TheFork Manager reservations through an API

> Read the reservation list for any date and restaurant in TheFork Manager, or add a booking, with one API call. A workflow can send each restaurant's list before the service starts and hand the billing history to accounting every month.

Page: https://fous.com/automate/thefork-manager
Updated: 2026-11-12

Works with your own TheFork Manager account. Fous is an independent product.

## What you can build on TheFork Manager

### Get the reservation list for a date

Reads the reservation list for one restaurant and one date, with each booking's time, guest, party size and status.

- Takes: Restaurant, date
- Returns: Time, guest name, number of guests, status, phone, notes

### List users and their roles

Reads Settings > Users > User management: who has an account, their email and their role, from SuperAdministrator to Viewer.

- Takes: Nothing
- Returns: User name, email, role, restaurants they can reach

### Get the billing history

Reads the list of transactions in the billing history of the Billing section.

- Takes: Restaurant, from date (optional)
- Returns: Date, description, amount, currency

### Add a reservation

Creates a booking in the reservation list for a restaurant, with the date, time, party size and the guest's details.

- Takes: Restaurant, date, time, number of guests, guest name, phone, email, notes
- Returns: Date, time, guest name, number of guests, status

## Automate TheFork Manager with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Each restaurant's reservation list before service

Starts: Every day at 10:00

1. For each restaurant you name, get the reservation list for today.
2. Group the bookings by lunch and dinner, with notes kept.
3. Email you one list per restaurant with time, guest, party size and notes.

### Changes to who can sign in to TheFork Manager

Starts: Every Monday at 8:00

1. List the users and their roles in User management.
2. Keep the users who are new or whose role changed since the last run.
3. Email you each one with name, email, role and restaurants.

### Monthly billing history for accounting

Starts: On the 2nd of every month at 9:00

1. For each restaurant, get the billing history since the 1st of last month.
2. Keep the transactions not sent on the last run.
3. Post restaurant, date, description, amount and currency to your accounting webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the reservation list for a date” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "manager.thefork.com/get_reservation_list",
    "input": {
      "restaurant": "Acme Bistro",
      "date": "2026-11-14"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "restaurant": "Acme Bistro",
    "date": "2026-11-14",
    "reservations": [
      {
        "time": "12:30",
        "guest_name": "Jordan Rivers",
        "guests": 4,
        "status": "Confirmed",
        "phone": "+44 20 7946 0123",
        "notes": "Window table if possible"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## TheFork Manager’s own options

TheFork documents a B2B API for restaurants, groups and partners: availability, reservation events and details, customer details and the booking lifecycle. Credentials come from TheFork's integrations team, and rate limits follow your contract. In TheFork Manager itself, exporting the customer and reservation databases is part of the Pro+ plan.

| Option | What it covers | What it takes |
| --- | --- | --- |
| B2B API | Real-time availability, webhook events when reservations are created or updated, reservation and customer details, the booking lifecycle. | A client_id and client_secret from TheFork's integrations team, after you send your company name and use case. Rate limit set by contract. |
| POS API | Connects a point-of-sale system to TheFork, with each restaurant identified by a CustomerId. | For POS providers: an API key from the integrations team. |
| Customer and reservation database export | Import and export of the customer and reservation databases from TheFork Manager. | The Pro+ plan, done by a SuperAdministrator or Administrator. |
| TheFork Manager by hand | The reservation list and calendar, services and availability, Special Offers, users and the Billing section, on the web or in the app. | A TheFork Manager account under your restaurant's contract. |

Read on November 12, 2026: [TheFork B2B API introduction](https://docs.thefork.io/B2B-API/introduction), [TheFork API preliminary steps](https://docs.thefork.io/preliminary-steps), [What types of users are there in TheFork Manager?](https://support.theforkmanager.com/s/article/What-types-of-users-are-there-in-TheFork-Manager?language=en_GB).

## Signing in to TheFork Manager

TheFork Manager signs you in with the email address and password of your user account. The first time you connect from a new device or browser, it sends a verification code by email. With Fous you sign in once through TheFork Manager's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Exports belong to Pro+ and to admins**: Importing and exporting the customer and reservation databases is only in the Pro+ version, and only SuperAdministrators and Administrators can do it. On other plans, a method you build can read the same records from the screens.
- **The role decides what a method can do**: A Viewer can only consult the reservation list and calendar. Waiters manage bookings and walk-ins but not services, and Managers have no access to the Billing section.
- **Groups: one account, several restaurants**: The SuperAdministrator of a group reaches every restaurant in it, while an Administrator may see only some. A method takes the restaurant as an input, and a workflow can loop over them.
- **New devices get an emailed code**: TheFork Manager sends a verification code by email the first time a user connects from a new device or browser, so the account's mailbox must be reachable when you first sign in.

## More in Food service, restaurants and alcohol

- [SGWS Proof](https://fous.com/automate/sgws-proof.md)
- [Provi](https://fous.com/automate/provi.md)
- [myCoke](https://fous.com/automate/mycoke.md)
- [BEES](https://fous.com/automate/bees.md)
- [METRO Online-Kundenkonto](https://fous.com/automate/metro-online-kundenkonto.md)
- [Sligro](https://fous.com/automate/sligro.md)
- [Deliveroo Partner Hub](https://fous.com/automate/deliveroo-partner-hub.md)
- [DoorDash Merchant Portal](https://fous.com/automate/doordash-merchant-portal.md)
- [foodpanda Partner Portal](https://fous.com/automate/foodpanda-partner-portal.md)
- [Glovo Manager Portal](https://fous.com/automate/glovo-manager-portal.md)
- [GrabMerchant](https://fous.com/automate/grabmerchant.md)
- [Grubhub for Restaurants](https://fous.com/automate/grubhub-for-restaurants.md)
- [iFood Portal do Parceiro](https://fous.com/automate/ifood-portal-do-parceiro.md)
- [Just Eat Partner Hub](https://fous.com/automate/just-eat-partner-hub.md)
- [PedidosYa Partner Portal](https://fous.com/automate/pedidosya-partner-portal.md)
- [Rappi Aliados](https://fous.com/automate/rappi-aliados.md)
- [Swiggy Partner](https://fous.com/automate/swiggy-partner.md)
- [Uber Eats Manager](https://fous.com/automate/uber-eats-manager.md)
- [Wolt Merchant Portal](https://fous.com/automate/wolt-merchant-portal.md)
- [Zomato Restaurant Partner](https://fous.com/automate/zomato-restaurant-partner.md)
- [饿了么商家版](https://fous.com/automate/ele-me-merchant-backend.md)
- [배민셀프서비스](https://fous.com/automate/baemin-self-service.md)
- [Gordon Ordering](https://fous.com/automate/gordon-ordering.md)
- [PFG CustomerFirst](https://fous.com/automate/pfg-customerfirst.md)
- [Sysco Shop](https://fous.com/automate/sysco-shop.md)
- [US Foods MOXē](https://fous.com/automate/us-foods-moxe.md)
- [Bidfood Direct](https://fous.com/automate/bidfood-direct.md)
- [Brakes](https://fous.com/automate/brakes.md)
- [Transgourmet Webshop](https://fous.com/automate/transgourmet-webshop.md)
- [レストランボード](https://fous.com/automate/restaurant-board.md)
- [OpenTable GuestCenter](https://fous.com/automate/opentable-guestcenter.md)
- [Restaurant365](https://fous.com/automate/restaurant365.md)
- [食べログ店舗管理画面](https://fous.com/automate/tabelog-owner-admin.md)
- [Oracle MICROS Simphony Reporting & Analytics](https://fous.com/automate/oracle-micros-simphony-reporting-and-analytics.md)
- [Toast Web](https://fous.com/automate/toast-web.md)
- [Insights C3M](https://fous.com/automate/insights-c3m.md)

Other industries: [PINACLE](/automate/pinacle), [e-OSCAR](/automate/e-oscar), [Coretax DJP](/automate/coretax-djp), [Income Tax e-Filing Portal](/automate/income-tax-e-filing-portal), [My ARC](/automate/my-arc), [Facturación Electrónica DIAN](/automate/facturacion-electronica-dian).

## Frequently asked questions

### Does TheFork Manager have an API?

TheFork has a B2B API for restaurants, groups and partners, covering availability, reservations, customer details and the booking lifecycle. You ask its integrations team for credentials with your company name and use case, and rate limits follow your contract. There is also a POS API for point-of-sale providers.

### Can I export my reservations and customers from TheFork Manager?

Yes, on the Pro+ plan. A SuperAdministrator or Administrator can import and export the customer and reservation databases. On any plan, a method you build with Fous can read the reservation list for a date, as far as your account's role allows.

### Which TheFork Manager user should sign in for automation?

The one whose role covers the task. A Viewer is enough to read the reservation list and calendar. Adding bookings needs at least a Waiter, and the Billing section needs an Administrator or SuperAdministrator.

### Can one workflow cover all the restaurants in my group?

Yes, if your account reaches them. A SuperAdministrator has access to every restaurant in the group. A workflow can run on a schedule, loop over the restaurants and send each one's reservation list by email or webhook.

### Is Fous affiliated with TheFork?

No. Fous is an independent product. You use it with your own TheFork Manager account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of TheFork Manager (TheFork). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.