G-Guest

G-Guest API

G-Guest API as documented publicly: 6 operations. Contract generated from the documentation by API Evangelist (2026-11-09); not the provider's own document.

Documentation GitHub OpenAPI

Operations 6

GET /api/cal/v1/bookings/{id} check_booking One booking, by its id and manage token. #

POST /api/cal/v1/demo/availability POST /api/cal/v1/demo/availability #

GET /api/cal/v1/{slug} fetch One venue in full: services, hours, timezone, how to book it. #

GET /api/cal/v1/{slug}/availability check_availability Real slots for a date and a party size. #

POST /api/cal/v1/{slug}/bookings create_booking A confirmed reservation, with the guest's own name, email and phone. #

POST /api/mcp streamable http · json-rpc 2.0 · no auth Two calls, start to finish #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/g-guest-app/openapi/_ae-authored/g-guest-app-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-cal-v1-slug-bookings-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-cal-v1-demo-availability-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-cal-v1-demo-availability-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-mcp-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-cal-v1-slug-bookings-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/g-guest-app/json-schema/g-guest-app-post-api-mcp-response-schema.json

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/g-guest-app:g-guest-app-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.1.0
info:
  title: G-Guest API
  version: '2026-11-09'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-09: 6 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; G-Guest has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 5
    pages-with-code: 1
    pages-read: 5
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-09'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://g-guest.app/developers
  - https://g-guest.app/llms.txt
  - https://g-guest.app/book/demo
  - https://g-guest.app/book/demo-salon
  - https://g-guest.app/book/demo-studio
paths:
  /api/cal/v1/bookings/{id}:
    get:
      operationId: get_api_cal_v1_bookings_id
      tags:
      - Api
      summary: check_booking One booking, by its id and manage token.
      x-source: https://g-guest.app/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: query
        required: true
        schema:
          type: string
        description: Manage token for the booking
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiCalV1BookingsIdResponse'
      x-evidence:
        kind: documentation
  /api/cal/v1/demo/availability:
    post:
      operationId: post_api_cal_v1_demo_availability
      tags:
      - Api
      summary: POST /api/cal/v1/demo/availability
      x-source: https://g-guest.app/developers
      parameters:
      - name: date
        in: query
        required: false
        schema:
          type: string
      - name: party
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiCalV1DemoAvailabilityRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiCalV1DemoAvailabilityResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://g-guest.app/api/cal/v1/demo/availability?date=2026-09-12&party=2\" 200 OK {\n \"business\": \"Marea Vivo (Demo)\"\
          ,\n \"date\": \"2026-09-12\",\n \"timezone\": \"Europe/Lisbon\",\n \"service\": { \"id\": 1, \"name\": \"Dinner table\", \"durationMinutes\"\
          : 90 },\n \"party_size\": 2,\n \"slots\": [\n { \"time\": \"18:00\", \"start_utc\": \"2026-09-12T17:00:00.000Z\", \"available\": true,\
          \ \"left\": 4 },\n { \"time\": \"18:30\", \"start_ut"
  /api/cal/v1/{slug}:
    get:
      operationId: get_api_cal_v1_slug
      tags:
      - Api
      summary: 'fetch One venue in full: services, hours, timezone, how to book it.'
      x-source: https://g-guest.app/developers
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/cal/v1/{slug}/availability:
    get:
      operationId: get_api_cal_v1_slug_availability
      tags:
      - Api
      summary: check_availability Real slots for a date and a party size.
      x-source: https://g-guest.app/developers
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: date
        in: query
        required: true
        schema:
          type: string
        description: Date to check availability (YYYY-MM-DD)
      - name: party
        in: query
        required: true
        schema:
          type: string
        description: Party size
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiCalV1SlugAvailabilityResponse'
      x-evidence:
        kind: documentation
  /api/cal/v1/{slug}/bookings:
    post:
      operationId: post_api_cal_v1_slug_bookings
      tags:
      - Api
      summary: create_booking A confirmed reservation, with the guest's own name, email and phone.
      x-source: https://g-guest.app/developers
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiCalV1SlugBookingsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiCalV1SlugBookingsResponse'
      x-evidence:
        kind: documentation
  /api/mcp:
    post:
      operationId: post_api_mcp
      tags:
      - Api
      summary: streamable http · json-rpc 2.0 · no auth Two calls, start to finish
      x-source: https://g-guest.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiMcpResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiCalV1BookingsIdResponse:
      type: object
      properties:
        status:
          type: string
        booking_id:
          type: string
        when:
          type: string
        party_size:
          type: integer
        business:
          type: string
    PostApiCalV1DemoAvailabilityRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            name:
              type: string
            arguments:
              type: object
              properties:
                slug:
                  type: string
                start:
                  type: string
                  format: date-time
                party_size:
                  type: integer
                name:
                  type: string
                email:
                  type: string
                phone:
                  type: string
                language:
                  type: string
                idempotency_key:
                  type: string
    PostApiCalV1DemoAvailabilityResponse:
      type: object
      properties:
        business:
          type: string
        date:
          type: string
          format: date
        timezone:
          type: string
        service:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
            durationMinutes:
              type: integer
        party_size:
          type: integer
        slots:
          type: array
          items:
            type: object
            properties:
              time:
                type: string
              start_utc:
                type: string
                format: date-time
              available:
                type: boolean
              left:
                type: integer
    GetApiCalV1SlugAvailabilityResponse:
      type: object
      properties:
        business:
          type: string
        date:
          type: string
        timezone:
          type: string
        service:
          type: object
        party_size:
          type: integer
        slots:
          type: array
    PostApiCalV1SlugBookingsRequest:
      type: object
      properties:
        start:
          type: string
          description: ISO‑8601 UTC start time
        party_size:
          type: integer
          description: Number of guests
        name:
          type: string
          description: Guest name
        email:
          type: string
          description: Guest email
        phone:
          type: string
          description: Guest phone
        language:
          type: string
          description: Guest language code
        idempotency_key:
          type: string
          description: Unique key to deduplicate requests
      required:
      - start
      - party_size
      - name
      - email
      - phone
    PostApiCalV1SlugBookingsResponse:
      type: object
      properties:
        status:
          type: string
        booking_id:
          type: string
        when:
          type: string
        party_size:
          type: integer
        business:
          type: string
        manage_url:
          type: string
    PostApiMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version, always "2.0"
        id:
          type: integer
          description: Request id
        method:
          type: string
          description: Method name, e.g. "tools/call"
        params:
          type: object
          description: Parameters object containing name and arguments
      required:
      - jsonrpc
      - id
      - method
      - params
    PostApiMcpResponse:
      type: object
      properties:
        status:
          type: string
        booking_id:
          type: string
        when:
          type: string
        party_size:
          type: integer
        business:
          type: string
        manage_url:
          type: string
tags:
- name: Api