LaFourchette

LaFourchette Phone API

The Phone API from LaFourchette — 3 operation(s) for phone.

GitHub OpenAPI

Operations 3

POST /v1/callCenter/callRecognitions #
PATCH /v1/integrationStatus #
GET /v1/restaurants/{id}/customers/phone/{phoneNumber} #

Documentation

📖
Documentation
https://docs.thefork.io/B2B-API/introduction
📖
APIReference
https://docs.thefork.io/B2B-API/API%20specifications/get-v-1-customers
📖
Authentication
https://docs.thefork.io/B2B-API/authentication
📖
Documentation
https://docs.thefork.io/POS-API/introduction
📖
APIReference
https://docs.thefork.io/POS-API/API%20specifications/tfm-pos-api-v-1
📖
GettingStarted
https://docs.thefork.io/POS-API/how-it-works

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lafourchette/refs/heads/main/openapi/lafourchette-phone-api-openapi.yml

Other Resources

🔗
Webhooks
https://docs.thefork.io/B2B-API/event-webhook-flow
🔗
Webhooks
https://docs.thefork.io/POS-API/Flow/create-order

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lafourchette-phone-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lafourchette-phone-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TheFork B2B Phone API
  version: 1.0.0
  description: TheFork (LA FOURCHETTE SAS) B2B / Partners API for TheFork Manager (TFM). Lets restaurant groups, CRM platforms and third-party partners read customers, reservations and reviews, drive the booking funnel (availabilities, offers, party sizes, timeslots, create/update/cancel reservations), reply to reviews, and run call-centre caller recognition. Access is granted by TheFork; authentication is an Auth0 client-credentials access token presented as a bearer token (audience https://api.thefork.io).
  contact:
    name: TheFork integrations team
    email: integrations@thefork.com
    url: https://docs.thefork.io/
  termsOfService: https://docs.thefork.io/pdf/LaFourchette-Partners-API-Licence-2.pdf
  x-provenance: Reconstructed by API Evangelist from the OpenAPI operation objects TheFork itself publishes in the compiled assets of its Docusaurus developer portal (docs.thefork.io, docusaurus-plugin-openapi-docs). TheFork does not serve a single downloadable OpenAPI document at any probed URL; every path, operationId, parameter, request body, response and schema below is verbatim provider content decoded from those published page bundles. Nothing here was authored by API Evangelist.
  x-source-title: B2B-API specifications
servers:
- url: https://api.thefork.io/manager
tags:
- name: Phone
paths:
  /v1/callCenter/callRecognitions:
    post:
      operationId: postV1CallCenterCallRecognitions
      tags:
      - Phone
      description: Create new phone call or mark an ongoing phone call as finished.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                callId:
                  type: string
                  format: uuid
                  description: phone call Uuid
                  example: c564869f-225a-4cb6-b124-2214a6216ec1
                callCallerId:
                  type: string
                  description: Caller's phone number is provided in the local format - the client
                  example: '0601020304'
                callCallerIdValidPhone:
                  type: boolean
                  example: true
                callPhoneNumber:
                  type: string
                  format: phone
                  pattern: ^\+[1-9]\d{1,14}$
                  description: phone number of the one calling - the client
                  example: '+33601020304'
                callCurrentStatus:
                  type: string
                  enum:
                  - SONNERIE
                  - DECROCHE
                  - RACCROCHE
                  - ABANDON
                  - incoming
                  - missed
                  - answered
                  - ended
                callDateMillis:
                  type: string
                  example: '1686073178976'
                theForkID:
                  type: string
                  format: uuid
                  description: restaurant uuid corresponding to the toPhoneNumber
                  example: c564869f-225a-4cb6-b124-2214a6216ec1
                sendAllEvents:
                  type: boolean
                  example: false
              required:
              - callCallerId
              - callCallerIdValidPhone
              - callCurrentStatus
              - callDateMillis
              - theForkID
              additionalProperties: false
      responses:
        '200':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    example: 200
        '401':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                        - ''
                    required:
                    - code
                  error:
                    type: string
                    enum:
                    - Unauthorized
                  statusCode:
                    type: number
                    enum:
                    - 401
                required:
                - data
                - error
                - statusCode
      x-source-page: https://docs.thefork.io/B2B-API/API specifications/post-v-1-call-center-call-recognitions-1b7
      x-source-asset: https://docs.thefork.io/assets/js/7640361e.b6bc1108.js
  /v1/integrationStatus:
    patch:
      operationId: patchV1IntegrationStatus
      tags:
      - Phone
      description: Update integration status for a restaurant
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                restaurantUuid:
                  type: string
                  format: uuid
                  description: Restaurant UUID
                  example: cf5946cc-bde0-4cb1-bca5-7b59f66a5c94
                status:
                  type: string
                  enum:
                  - LeadReceived
                  - DiscoveryOngoing
                  - TypeformSent
                  - FailedDiscovery
                  - HardwareInTransit
                  - FailedDelivery
                  - HardwareToBeInstalled
                  - FailedInstallation
                  - InstallationCompleted
                  description: integration status
                  example: LeadReceived
              required:
              - restaurantUuid
              - status
              additionalProperties: false
      responses:
        '200':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                required:
                - statusCode
                additionalProperties: false
        '401':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                        - ''
                    required:
                    - code
                  error:
                    type: string
                    enum:
                    - Unauthorized
                  statusCode:
                    type: number
                    enum:
                    - 401
                required:
                - data
                - error
                - statusCode
      x-source-page: https://docs.thefork.io/B2B-API/API specifications/patch-v-1-integration-status-a97
      x-source-asset: https://docs.thefork.io/assets/js/caabd68a.f984be41.js
  /v1/restaurants/{id}/customers/phone/{phoneNumber}:
    get:
      operationId: getV1RestaurantsIdCustomersPhonePhoneNumber
      tags:
      - Phone
      description: Get the customer details for a given customer phone number.
      parameters:
      - schema:
          type: string
          format: uuid
          description: restaurant uuid that needs to be considered for filter
          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        required: true
        description: restaurant uuid that needs to be considered for filter
        name: id
        in: path
      - schema:
          type: string
          format: phone
          pattern: ^\+[1-9]\d{1,14}$
          description: customer phone number that needs to be considered for filter
          example: '+33612345678'
        required: true
        description: customer phone number that needs to be considered for filter
        name: phoneNumber
        in: path
      responses:
        '200':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  customerUuid:
                    type:
                    - string
                    - 'null'
                    format: uuid
                    description: Customer UUID
                    example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  firstName:
                    type:
                    - string
                    - 'null'
                    example: Doe
                  lastName:
                    type:
                    - string
                    - 'null'
                    example: John
                  phone:
                    type: string
                    example: '+33612345678'
                  email:
                    type:
                    - string
                    - 'null'
                    example: john@example.com
                  nextReservationsList:
                    type: array
                    items:
                      type: object
                      properties:
                        reservationUuid:
                          type: string
                          format: uuid
                          description: 'reservation uuid '
                          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                        mealDate:
                          type:
                          - string
                          - 'null'
                          description: Reservation meal date
                          example: '2022-01-03T18:10:17.269Z'
                        status:
                          type: string
                          enum:
                          - RECORDED
                          - CANCELED
                          - NO_SHOW
                          - REQUESTED
                          - REFUSED
                          description: Reservation status
                          example: RECORDED
                      required:
                      - reservationUuid
                      - mealDate
                      - status
                      additionalProperties: false
                required:
                - customerUuid
                - phone
                - nextReservationsList
                additionalProperties: false
        '401':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                        - ''
                    required:
                    - code
                  error:
                    type: string
                    enum:
                    - Unauthorized
                  statusCode:
                    type: number
                    enum:
                    - 401
                required:
                - data
                - error
                - statusCode
        '404':
          description: Object with user data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                        - PHONE_NUMBER_NOT_FOUND
                    required:
                    - code
                  error:
                    type: string
                    enum:
                    - Not Found
                  statusCode:
                    type: number
                    enum:
                    - 404
                required:
                - data
                - error
                - statusCode
      x-source-page: https://docs.thefork.io/B2B-API/API specifications/get-v-1-restaurants-id-customers-phone-phone-number-22f
      x-source-asset: https://docs.thefork.io/assets/js/eadad500.93a4a9bd.js