{"info":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","description":"

The Favouritetable Web Booking API provides a comprehensive solution for managing restaurant table bookings. This RESTful API enables you to check availability, create bookings, manage reservations, and handle customer information.

\n

Getting Started

\n

Base URL

\n
{{base_url}}\n\n

Authentication

\n

This API uses Bearer Token authentication combined with an API Key header.

\n

Authorization Header

\n
Authorization: Bearer {{auth_token}}\n\n
\n

API Key Header

\n
ApiKey: {{api_key}}\n\n

Note: The collection automatically adds the ApiKey header using a pre-request script. Ensure your environment has the following variables configured:

\n\n

API Endpoints

\n

Availability

\n

Check table availability and retrieve shift/timeslot information.

\n

GetShiftList

\n

Retrieves available shifts for booking.

\n\n

GetTimeslotList

\n

Retrieves available timeslots within shifts.

\n\n

Booking Management

\n

Complete booking lifecycle management including creation, updates, cancellations, and searches.

\n

Insert

\n

Creates a new booking reservation.

\n\n

Update

\n

Updates an existing booking with new details.

\n\n

Cancel

\n

Cancels an existing booking.

\n\n

Attach

\n

Attaches existing booking to hotel room

\n\n

Detach

\n

Removes attached booking from hotel room.

\n\n

GetBookingDetailByGUID

\n

Retrieves detailed information for a specific booking using its GUID.

\n\n

Search

\n

Searches for bookings using email, reference number, or company code.

\n\n

Common Workflows

\n

Creating a New Booking

\n
    \n

  1. Call GetShiftList to retrieve available shifts

    \n
    2. \n

  2. Call GetTimeslotList to get specific timeslots

    \n
    3. \n

  3. Call Insert to create the booking

    \n
    4. \n

  4. Optionally call Attach to add additional details

    \n
    5. \n
\n

Modifying an Existing Booking

\n
    \n

  1. Call Search or GetBookingDetailByGUID to retrieve booking details

    \n
    2. \n

  2. Call Update with modified information

    \n
    3. \n

  3. Or call Cancel to cancel the booking

    \n
    4. \n
\n

Finding a Booking

\n
    \n

  1. Use Search with email or booking reference number

    \n
    2. \n

  2. Use GetBookingDetailByGUID if you have the booking GUID

    \n
    3. \n
\n

Environment Variables

\n

Configure these variables in your Postman environment:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariableDescription
base_urlAPI base URL
auth_tokenBearer authentication token
api_keyAPI key for authentication
company_codeYour company identifier
site_codeYour site identifier
\n

Support

\n

For API support, authentication setup, or additional documentation, please contact the Favouritetable development team.

\n

Version Information

\n

This collection uses Bearer token authentication and requires both an authorization token and API key for all requests.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"18027074","collectionId":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","publishedId":"2sBXcAJ32S","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-06T16:26:55.000Z"},"item":[{"name":"Booking","item":[{"name":"Insert","id":"941ecef7-0fb2-4f42-b646-676c5d7b3183","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"BookingCode\": 0,\r\n \"Booking\": {\r\n \"SiteCode\": {{site_code}},\r\n \"BookingDate\": \"\",\r\n \"GuestCount\": ,\r\n \"ShiftCode\": ,\r\n \"BookingTime\": ,\r\n \"Title\": \"\",\r\n \"FirstName\": \"\",\r\n \"LastName\": \"\",\r\n \"Tel\": \"\",\r\n \"Email\": \"\",\r\n \"SpecialRequest\": \"\",\r\n \"PostCode\": \"\",\r\n \"SaleSourceCode\": ,\r\n \"SpecialOfferEmail\": ,\r\n \"SpecialOfferMobile\": ,\r\n \"InterfaceTypeCode\": ,\r\n \"RoomNo\": \"\"\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/Insert","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Insert"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"941ecef7-0fb2-4f42-b646-676c5d7b3183"},{"name":"Update","id":"fd5d59c6-984a-4637-8c0a-0f9f638b45d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"BookingCode\": , \r\n \"ShiftCode\": ,\r\n \"GuestCount\": ,\r\n \"BookingDate\": ,\r\n \"BookingTime\": ,\r\n \"Duration\": , \r\n \"Title\": ,\r\n \"FirstName\": ,\r\n \"LastName\": ,\r\n \"Tel\": ,\r\n \"Email\": , \r\n \"SpecialRequest\": , \r\n \"SpecialOfferEmail\": ,\r\n \"SpecialOfferMobile\": , \r\n \"OfferCode\": ,\r\n \"LocationCode\": \r\n }","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/Update","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Update"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fd5d59c6-984a-4637-8c0a-0f9f638b45d5"},{"name":"Cancel","id":"f867c3a4-0fa3-48e9-be84-89d72d28b503","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \r\n \"CompanyCode\": {{company_code}},\r\n \"BookingGuidCode\": \"\",\r\n \"Email\": \"\", \r\n \"BookingRefNo\": \"\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/Cancel","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Cancel"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f867c3a4-0fa3-48e9-be84-89d72d28b503"},{"name":"Attach","id":"9606a22d-c0d5-45b1-a88a-f9bc59531845","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"BookingCode\": ,\r\n \"SiteCode\": {{site_code}},\r\n \"InterfaceTypeCode\": ,\r\n \"RoomNo\": \"\"\r\n} \r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/Attach","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Attach"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"9606a22d-c0d5-45b1-a88a-f9bc59531845"},{"name":"Detach","id":"7ba5ea7e-5410-4a90-ad4f-dbe2df8122fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"BookingCode\": ,\r\n \"SiteCode\": {{site_code}},\r\n \"InterfaceTypeCode\": ,\r\n \"RoomNo\": \"\"\r\n} \r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/Detach","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Detach"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"7ba5ea7e-5410-4a90-ad4f-dbe2df8122fd"},{"name":"GetBookingDetailByGUID","id":"78455329-f592-469f-8b65-8ea82782f8ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{webapi_base_url}}/Booking/GetBookingDetailByGUID?bookingGUID=","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","GetBookingDetailByGUID"],"host":["{{webapi_base_url}}"],"query":[{"key":"bookingGUID","value":""}],"variable":[]}},"response":[],"_postman_id":"78455329-f592-469f-8b65-8ea82782f8ea"},{"name":"Search","id":"c0241fcf-50e5-4381-8983-64bdd0320429","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{webapi_base_url}}/Booking/Search?email=&bookingRefNo=&companyCode={{company_code}}","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","Search"],"host":["{{webapi_base_url}}"],"query":[{"key":"email","value":""},{"key":"bookingRefNo","value":""},{"key":"companyCode","value":"{{company_code}}"}],"variable":[]}},"response":[],"_postman_id":"c0241fcf-50e5-4381-8983-64bdd0320429"}],"id":"ca74e659-f776-4989-b6e6-4c2fa780a6a9","event":[{"listen":"prerequest","script":{"id":"847afbb5-7f03-4245-9747-a401f26b5942","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"2e46d794-90e5-4ae0-82b6-f8d1ef81c8f5","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"ca74e659-f776-4989-b6e6-4c2fa780a6a9","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}}},{"name":"Availability","item":[{"name":"GetShiftList","id":"431e6c0d-c9fa-4c21-acfd-b08ec26622bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"SiteCode\": {{site_code}},\r\n \"BookingDate\": \"\",\r\n \"OfferCode\": ,\r\n \"IsShowOnlyOffer\": \r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/GetShiftList","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","GetShiftList"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"431e6c0d-c9fa-4c21-acfd-b08ec26622bf"},{"name":"GetOfferList","id":"a81528ce-bf97-487e-b288-566ec1cdff6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"SiteCode\": {{site_code}},\r\n \"ShiftCode\": ,\r\n \"BookingDate\": \"\",\r\n \"GuestCount\": ,\r\n \"OfferCode\": ,\r\n \"IsShowOnlyOffer\": \r\n}","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/GetOfferList","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","GetOfferList"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a81528ce-bf97-487e-b288-566ec1cdff6b"},{"name":"GetTimeslotList","id":"60371ef9-758c-46e1-88d9-35e6f42e9fde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"SiteCode\": {{site_code}},\r\n \"BookingDate\": \"\",\r\n \"OfferCode\": ,\r\n \"IsShowOnlyOffer\": \r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{webapi_base_url}}/Booking/GetShiftList","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["Booking","GetShiftList"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"60371ef9-758c-46e1-88d9-35e6f42e9fde"}],"id":"1889f195-da9b-4202-ac57-e7de8125f279","_postman_id":"1889f195-da9b-4202-ac57-e7de8125f279","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}}},{"name":"Subscriber","item":[{"name":"Insert","id":"1ca1859b-ee54-4978-8735-4311fecbffd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\"CompanyCode\":{{company_code}}, \r\n\"SiteCode\":{{site_code}}, \r\n\"Title\":\"\", \r\n\"FirstName\":\"\", \r\n\"LastName\":\"\", \r\n\"Phone\":\"\", \r\n\"Email\":\"\", \r\n\"EmailOptIn\":{{email_opt_in}}, \r\n\"SMSOptIn\":{{sms_opt_in}} \r\n} "},"url":"{{webapi_base_url}}/subscriber/Insert","description":"

Use this method to push subscribers to favouritetable system.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}},"urlObject":{"path":["subscriber","Insert"],"host":["{{webapi_base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1ca1859b-ee54-4978-8735-4311fecbffd1"}],"id":"b615c936-5fee-441c-85f1-913b8925bd37","_postman_id":"b615c936-5fee-441c-85f1-913b8925bd37","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}}},{"name":"Appendix","item":[],"id":"7e624ddc-4a03-42e7-a68e-30f9d4b08f9c","description":"
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Error CodeDescription
9999Unknown Error
2001Invalid AuthToken passed
2002AuthToken has expired
3001Invalid CompanyCode
3002Both Email and Tel are blank
3003Both firstname and lastname are blank
1005You are not authorized to access this company
1007You are not authorized to access this site!
\n
","_postman_id":"7e624ddc-4a03-42e7-a68e-30f9d4b08f9c","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":true,"source":{"_postman_id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","id":"21ce269d-b1c1-4e7f-bb0e-f19a98d53203","name":"Favouritetable - Web Booking API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]}},"event":[{"listen":"prerequest","script":{"id":"045cadce-3b1b-4786-b46a-89a49e2946b6","type":"text/javascript","packages":{},"requests":{},"exec":["// Remove existing header if already present\r","pm.request.headers.remove(\"x-api-key\");\r","pm.request.headers.add({\r"," key: \"ApiKey\",\r"," value: pm.environment.get(\"api_key\")\r","});"]}},{"listen":"test","script":{"id":"a180a679-38c8-46aa-b09c-026ac5a13cc8","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"booking_date","value":""},{"key":"guest_count","value":""},{"key":"shift_code","value":""},{"key":"booking_time","value":""},{"key":"title","value":""},{"key":"first_name","value":""},{"key":"last_name","value":""},{"key":"phone","value":""},{"key":"email","value":""},{"key":"special_request","value":""},{"key":"sale_source_code","value":""},{"key":"postcode","value":""},{"key":"special_offer_email","value":""},{"key":"special_offer_mobile","value":""},{"key":"booking_code","value":""},{"key":"duration","value":""},{"key":"offer_code","value":""},{"key":"location_code","value":""},{"key":"booking_guid","value":""},{"key":"booking_ref_no","value":""},{"key":"room_no","value":""},{"key":"interface_type_code","value":""},{"key":"is_show_only_offer","value":""},{"key":"is_require_disable_access","value":""},{"key":"is_require_pet_friendly","value":""},{"key":"bearer_token_0b1z","secret":true}]}