> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eat-now.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Check a single reservation slot

> Checks whether one exact slot is bookable for the requested `party_size` and optional room or shift filters. This endpoint returns a boolean result for one slot instead of listing all bookable slots.



## OpenAPI

````yaml https://app.eat-now.io/api/partner/v1/openapi.json post /api/partner/v1/availability/check
openapi: 3.0.3
info:
  title: EatNow Partner API
  version: v1
  description: >-
    Version 1 of the EatNow partner API.


    This API is designed for trusted partner integrations that need
    restaurant-scoped access to availability, reservation management, and
    operational reference data.


    Authentication

    - Use `Authorization: Bearer <token>` with a partner API token created from
    the EatNow dashboard.

    - Access is controlled by credential scopes and each request is resolved to
    a single restaurant.


    Base URL

    - The server URL in this document is the canonical base URL for the current
    environment.


    Errors

    - Errors follow a consistent envelope with `error.code`, `error.message`,
    and `error.request_id`.

    - Validation, authentication, authorization, conflicts, and not-found cases
    all use the same top-level error shape.


    Rate limits

    - Partner API traffic is rate limited. Clients should treat `429` responses
    as retryable and back off accordingly.


    Public endpoints

    - `GET /api/partner/v1` and `GET /api/partner/v1/openapi.json` are public.

    - All business endpoints require Bearer authentication.
servers:
  - url: https://app.eat-now.io
security: []
tags:
  - name: Meta
    description: Platform metadata and schema endpoints
  - name: Authentication
    description: Credential validation and auth context endpoints
  - name: Availability
    description: Bookable slot search and exact slot validation
  - name: Catalog
    description: Reference data for restaurant tables, rooms, prescribers, and discounts
  - name: Reservations
    description: Reservation lookup, search, update, and cancellation
  - name: Missed Calls
    description: Report missed calls and trigger WhatsApp follow-up templates
paths:
  /api/partner/v1/availability/check:
    post:
      tags:
        - Availability
      summary: Check a single reservation slot
      description: >-
        Checks whether one exact slot is bookable for the requested `party_size`
        and optional room or shift filters. This endpoint returns a boolean
        result for one slot instead of listing all bookable slots.
      operationId: checkPartnerAvailability
      requestBody:
        required: true
        description: >-
          Exact-slot availability validation payload. Send a JSON body, not
          query parameters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerApiAvailabilityCheckRequest'
      responses:
        '200':
          description: Availability status for the requested slot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerApiAvailabilityCheckResponse'
              examples:
                available:
                  summary: Requested slot is bookable
                  value:
                    data:
                      available: true
                      failure_reason: null
                unavailable:
                  summary: Requested slot is not bookable
                  value:
                    data:
                      available: false
                      failure_reason: SLOT_UNAVAILABLE
        '400':
          description: Request validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerApiError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerApiError'
        '403':
          description: Scope is insufficient
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerApiError'
      security:
        - PartnerBearerToken: []
components:
  schemas:
    PartnerApiAvailabilityCheckRequest:
      type: object
      properties:
        start_at:
          type: string
          format: date-time
          description: Exact slot start datetime to validate.
        party_size:
          type: integer
          minimum: 1
          description: Party size used to validate the slot.
        room_id:
          type: string
          minLength: 1
          description: >-
            Optional room to validate when the shift requires room-specific
            booking.
        shift_id:
          type: string
          minLength: 1
          description: Optional shift to validate.
      required:
        - start_at
        - party_size
    PartnerApiAvailabilityCheckResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            available:
              type: boolean
            failure_reason:
              $ref: '#/components/schemas/PartnerApiAvailabilityFailureReason'
          required:
            - available
            - failure_reason
      required:
        - data
    PartnerApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              $ref: '#/components/schemas/PartnerApiErrorCode'
            message:
              type: string
            request_id:
              type: string
            details:
              type: object
              additionalProperties:
                nullable: true
          required:
            - code
            - message
            - request_id
      required:
        - error
    PartnerApiAvailabilityFailureReason:
      type: string
      nullable: true
      enum:
        - SHIFT_NOT_FOUND
        - ROOM_UNAVAILABLE
        - PARTY_SIZE_UNSUPPORTED
        - SLOT_UNAVAILABLE
        - null
    PartnerApiErrorCode:
      type: string
      enum:
        - AUTHENTICATION_REQUIRED
        - INVALID_AUTHENTICATION
        - INSUFFICIENT_SCOPE
        - VALIDATION_ERROR
        - RESOURCE_NOT_FOUND
        - RESOURCE_CONFLICT
        - RATE_LIMITED
        - INTERNAL_ERROR
  securitySchemes:
    PartnerBearerToken:
      type: http
      scheme: bearer
      bearerFormat: API Token
      description: >-
        Restaurant-scoped partner API token passed as `Authorization: Bearer
        <token>`.
      x-default: your_token_here

````