1. Booking
Jicoo Developer Potal
  • Errors
  • Versioning
  • Types
  • Authentication
  • Quick start
  • API Reference Overview
  • Create powerful apps with Jicoo's API
  • Guide
    • How to use webhook
    • How to use Account integration
    • Jicoo MCP Server Setup Guide
    • Add the Jicoo MCP Server to Claude
    • Add the Jicoo MCP Server to Claude Code
    • Add the Jicoo MCP Server to Codex
    • Add the Jicoo MCP Server to Gemini CLI
  • Guide(Japanese)
    • アカウント連携の使い方
    • Webhookの使い方
    • ホストの優先度を更新する方法
    • Jicoo MCP Serverの使い方
    • Jicoo MCP サーバ セットアップガイド
    • Jicoo MCP サーバを Claude に追加する
    • Jicoo MCP サーバを Claude Code に追加する
    • Jicoo MCP サーバを Codex に追加する
    • Jicoo MCP サーバを Gemini CLI に追加する
  • API Reference
    • Jicoo API
    • Webhook Schema
      • Webhook schema
      • event property
      • createdAt property
      • object property
      • contact property
      • answers property
      • answers items property
      • tracking property
    • Booking
      • List Bookings
        GET
      • Get Booking
        GET
      • Cancel Booking
        POST
      • Reschedule Booking
        POST
      • Create Booking
        POST
      • Update Booking
        PATCH
      • Get Booking Contacts
        GET
      • Confirm booking request
        POST
      • Decline booking request
        POST
      • Automatically reassign booking host
        POST
      • Reassign booking host
        POST
      • Get Booking Operation Status
        GET
    • Schedule
      • Update Schedule
      • Create Schedule
      • List Schedules
      • Delete Schedule
    • Availability
      • List User Availability Calendars
      • Get User Availability Calendar
    • Organization
      • User
        • List Organization Users
        • Delete Organization User
        • Get Organization User
        • Update Organization User
      • Invitation
        • Create Organization Invitation
        • List Organization Invitations
        • Get Organization Invitation
        • Delete Organization Invitation
      • Get Organization Team
    • Event Types
      • Get Event Type
      • List Event Types
      • List Event Type Hosts
      • Get Event Type Available Schedules
      • Account Integration
      • Update Event Type Host
      • Delete Event Type Host
      • Create Event Type Host
      • Delete Event Type Host Assign Rule
      • Update Event Type Host Assign Rule
      • Create Event Type Host Assign Rule
      • List Event Type Host Assign Rules
      • Update an event type
      • Create an event type
      • Delete an event type
      • Get Event Type Notification
      • Update Event Type Notification
      • Get Event Type Available Schedules (v2)
    • Webhook Endpoints
      • List webhook endpoints
      • Create a webhook endpoint
      • Get a webhook endpoint
      • Update a webhook endpoint
      • Delete a webhook endpoint
    • Booking Meeting Intelligence
      • List recordings for a booking
      • List transcripts for a booking
      • List recaps for a booking
    • Routing Form
      • List routing forms
      • Get routing form
      • Create routing form response
      • Update routing form response
  • User
    • Busy Times (v2)
    • Busy Times
    • Check Calendar Connection (v2)
    • Get current user profile
    • Update current user profile
    • Update current user profile image
    • Get current user settings
    • Update current user settings
    • List user busy times
  • Schemas
    • Booking
    • OrganizationUser
    • OrganizationInvitation
    • UserAvailabilityCalendar
    • OrganizationTeam
    • EventType
    • Host
    • Pagination
    • AvailableSchedule
    • BookingTranscriptSpeakerTimelineSegment
    • EventTypeUpdateRequest
    • EventTypeCreateRequest
    • BookingRecapSummary
    • BookingRecording
    • EventTypeDetail
    • GeneratedEventTypeUpdateRequest
    • EventTypeUpdateLocation
    • EventTypeCreateEventType
    • BookingRecordingResponse
    • BookingRecapRisk
    • BookingTranscript
    • BookingTranscriptResponse
    • EventTypeCreateLocation
    • BookingRecap
    • ErrorEnvelope
    • EventTypeUserUpdate
    • BookingRecapResponse
    • EventTypeUpdateForm
    • EventTypeUserCreate
    • WebhookEndpointCreateResponse
    • EventTypeNotification
    • WebhookEndpoint
    • WebhookEndpointPublicCreateBody
    • WebhookEndpointPublicUpdateBody
    • EventTypeCalendarCreateBody
    • EventTypeUpdateHostAssignRule
    • EventTypeUpdateWorkflow
    • EventTypeCalendarCreate
    • EventTypeSettingCreateBody
    • EventFormCreateBody
    • EventTypeTransparencyKeywordCreateBody
    • EventTypeCreateHostAssignRule
    • Schedule
    • EmptySuccessResponse
    • ErrorResponse
    • Booking Contact
    • HostAssignRule
    • ConferencingProvider
    • BookingReassignParams
    • ConferencingConnectBody
    • ConferencingConnectResponse
    • ConferencingConnectionItem
    • RoutingFormPublicDetailItem
    • RoutingFormPublicListItem
    • RoutingFormPublicWorkflowItem
    • RoutingFormResponseAnswerInput
    • RoutingFormResponseBody
    • RoutingFormResponseResult
    • RoutingFormResponseUpdateBody
    • UsersMeProfile
    • UsersMeProfilePatchBody
    • UsersMeSettings
    • UsersMeSettingsPatchBody
  1. Booking

Get Booking Operation Status

GET
/v1/booking_operations/{id}
Returns the progress of a booking created by POST /v1/bookings with an Idempotency-Key header. Use the operation ID from the Location header (/v1/booking_operations/{id}) or data.reference.operationId of that response as id.
This endpoint only reads the status. It does not create or change a booking. It returns only operations of the authenticated team. An operation of another team, or an operation that does not exist, returns 404. An id that is not a positive integer returns 400. Error responses of this endpoint have no errorMessage.
When you use an OIDC access token, the token needs the bookings.read scope.

Response fields#

FieldDescription
data.statepending, processing, completed or recovery_required. completed means all processing after the booking is finished. recovery_required means Jicoo needs to check the request. pending and processing can also mean that the booking is not created yet.
data.responseStatepending (the first response is not saved yet), available (POST with the same key returns the saved first response) or expired (the saved first response expired after 24 hours).
data.codeThe reason when the whole operation needs to be checked. Otherwise null. When a step needs to be checked, see failedSteps[].code.
data.referenceoperationId, bookingUid and statusPath. After the booking is created, use bookingUid with GET /v1/bookings/{uid}. Before that, GET /v1/bookings/{uid} returns 404.
data.failedStepsSteps that need to be checked. Each item has sequence, kind and code. Empty when there are none.
data.stepsAll steps in order. Each item has sequence, kind, status, attempts, dispatchAttempts and lastErrorCode.
steps[].status is pending, enqueued, processing, completed or recovery_required.
A step with kind external_queue_transfer also has externalDeliveryState: queue_accepted or unconfirmed. queue_accepted means the request was accepted by the delivery queue (for example, a webhook). It does not mean that it reached the recipient.
kind and code values may be added in the future. Do not stop processing on unknown values.

Request

Authorization
Add parameter in header
X-Jicoo-Api-Key
Example:
X-Jicoo-Api-Key: ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/booking_operations/123' \
--header 'X-Jicoo-Api-Key: <api-key>'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "data": {
        "state": "pending",
        "responseState": "pending",
        "code": null,
        "reference": {
            "operationId": 123,
            "bookingUid": "mzgdPJVBb7RE",
            "statusPath": "/v1/booking_operations/123"
        },
        "failedSteps": [],
        "steps": [
            {
                "sequence": 1,
                "kind": "external_queue_transfer",
                "status": "pending",
                "attempts": 0,
                "dispatchAttempts": 0,
                "lastErrorCode": null,
                "externalDeliveryState": "unconfirmed"
            }
        ]
    },
    "errors": {}
}
Modified at 2026-11-20 06:01:12
Previous
Reassign booking host
Next
Update Schedule
Built with