MarketBox API

Bookings

Endpointhttps://api.gomarketbox.com/v1

The MarketBox API is a modular, API-first platform for building modern scheduling, booking and dispatch workflows for both mobile services and fixed locations. At its core is the Smart Clusters engine, which generates realistic, bookable availability by analyzing provider schedules, existing bookings, travel zones and real-world travel constraints. Instead of relying on static time slots or buffers, MarketBox returns appointment times that are physically feasible, route-aware and optimized to reduce travel, traffic and idle gaps.

Beyond availability intelligence, the API includes a full set of resource endpoints for managing services, providers, schedules, bookings, orders and more. This allows teams to enhance an existing booking flow or build a complete, white-labeled scheduling system end-to-end. MarketBox is designed to be embedded into websites, dispatcher tools, AI chat and voice agents, or third-party platforms, with near real-time responses returned in JSON for seamless integration into any workflow.

To get started, please contact support@gomarketbox.com to get an API key.

Endpoints for updating and managing bookings inside the MarketBox platform. An order may contain multiple bookings.

Update booking

PATCH

https://api.gomarketbox.com/v1

/resources/bookings

Request should include only the fields that need to be updated. The request must include bookingId or externalBookingId.

Update booking › Headers

content-type

string · pattern: ^application\/json · required

idempotency-key

string · uuid · required

Unique identifier for idempotent request handling. Must be a valid UUID. Use the same key to safely retry requests.

Example: 550e8400-e29b-41d4-a716-446655440000

Update booking › Request Body

bookingId

string

MarketBox booking id of the booking to be updated

Example: 550e8400-e29b-41d4-a716-446655440000

externalBookingId

string

This is the unique identifier of the booking inside your system that needs to be updated in MarketBox. You can provide either bookingId or externalBookingId

Example: 1234567879abcdEF_-

startDateAndTime

string · date-time

Booking date and time with timezone offset. Provide this value, if you want to reschedule the booking.

Example: 2025-12-15T16:30:00-05:00

timezone

string

IANA timezone identifier (required if startDateAndTime is provided)

Example: America/New_York

status

string · enum

Booking status. Provide this value when you want to update the status of booking.

Enum values:

SCHEDULED

ARRIVED

COMPLETED

CANCELLED

NOSHOW

Example: SCHEDULED

Update booking › Responses

Booking updated successfully

bookingId

string · required

updatedAt

string · date-time · required

externalBookingId

string

status

string · enum

Enum values:

SCHEDULED

ARRIVED

COMPLETED

CANCELLED

NOSHOW

startDateAndTime

string · date-time

Booking date and time with timezone offset

Example: 2025-12-15T16:30:00-05:00

PATCH/resources/bookings

const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'content-type': '<string>',
    'idempotency-key': '<string>'
  },
  body: JSON.stringify({
    bookingId: '550e8400-e29b-41d4-a716-446655440000',
    externalBookingId: '1234567879abcdEF_-',
    startDateAndTime: '2024-08-25T15:00:00Z',
    timezone: 'America/New_York',
    status: 'SCHEDULED'
  })
};

fetch('https://api.gomarketbox.com/v1/resources/bookings', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Example Request Body

{
  "bookingId": "550e8400-e29b-41d4-a716-446655440000",
  "externalBookingId": "1234567879abcdEF_-",
  "startDateAndTime": "2024-08-25T15:00:00Z",
  "timezone": "America/New_York",
  "status": "SCHEDULED"
}

json

Example Responses

{
  "bookingId": "bookingId",
  "externalBookingId": "externalBookingId",
  "status": "SCHEDULED",
  "startDateAndTime": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Orders Services

Update booking

PATCH

https://api.gomarketbox.com/v1

/resources/bookings

Request should include only the fields that need to be updated. The request must include bookingId or externalBookingId.

Update booking › Headers

content-type

string · pattern: ^application\/json · required

idempotency-key

string · uuid · required

Unique identifier for idempotent request handling. Must be a valid UUID. Use the same key to safely retry requests.

Example: 550e8400-e29b-41d4-a716-446655440000

Update booking › Request Body

bookingId

string

MarketBox booking id of the booking to be updated

Example: 550e8400-e29b-41d4-a716-446655440000

externalBookingId

string

This is the unique identifier of the booking inside your system that needs to be updated in MarketBox. You can provide either bookingId or externalBookingId

Example: 1234567879abcdEF_-

startDateAndTime

string · date-time

Booking date and time with timezone offset. Provide this value, if you want to reschedule the booking.

Example: 2025-12-15T16:30:00-05:00

timezone

string

IANA timezone identifier (required if startDateAndTime is provided)

Example: America/New_York

status

string · enum

Booking status. Provide this value when you want to update the status of booking.

Enum values:

SCHEDULED

ARRIVED

COMPLETED

CANCELLED

NOSHOW

Example: SCHEDULED

Update booking › Responses

Booking updated successfully

bookingId

string · required

updatedAt

string · date-time · required

externalBookingId

string

status

string · enum

Enum values:

SCHEDULED

ARRIVED

COMPLETED

CANCELLED

NOSHOW

startDateAndTime

string · date-time

Booking date and time with timezone offset

Example: 2025-12-15T16:30:00-05:00

const options = { method: 'PATCH', headers: { 'Content-Type': 'application/json', 'content-type': '<string>', 'idempotency-key': '<string>' }, body: JSON.stringify({ bookingId: '550e8400-e29b-41d4-a716-446655440000', externalBookingId: '1234567879abcdEF_-', startDateAndTime: '2024-08-25T15:00:00Z', timezone: 'America/New_York', status: 'SCHEDULED' }) }; fetch('https://api.gomarketbox.com/v1/resources/bookings', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));

{ "bookingId": "550e8400-e29b-41d4-a716-446655440000", "externalBookingId": "1234567879abcdEF_-", "startDateAndTime": "2024-08-25T15:00:00Z", "timezone": "America/New_York", "status": "SCHEDULED" }