MarketBox API

Orders

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 creating orders inside the MarketBox platform. An order may contain multiple bookings.

Create order

POST

https://api.gomarketbox.com/v1

/resources/orders

Create order › 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

Create order › Request Body

reservedSlotId

string · required

Reserved slot ID obtained from POST /reservedslots endpoint

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

serviceId

string · uuid · required

Service unique identifier

Example: 123e4567-e89b-12d3-a456-426614174000

object · required

object

externalOrderId

string

This is the unique identifier of the order inside your system – MarketBox will store and map this internally. If your system does not have a distinction between orders and bookings, then send the same booking or order ID in both externalBookingId and externalOrderId fields

Example: 1234567879abcdEF_-

externalBookingId

string

This is the unique identifier of the booking inside your system – MarketBox will store and map this internally

Example: 1234567879abcdEF_-

object

Additional external data for the order

Example: {"source":"external-system","customField":"value","syncedAt":"2026-01-09"}

object

Additional external data for the booking

Example: {"source":"external-system","customField":"value","syncedAt":"2026-01-09"}

sendProviderEmailNotification

boolean

Default: true

Create order › Responses

Order created successfully

object · required

POST/resources/orders

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'content-type': '<string>',
    'idempotency-key': '<string>'
  },
  body: JSON.stringify({
    reservedSlotId: '550e8400-e29b-41d4-a716-446655440000',
    serviceId: '00000000-0000-0000-0000-000000000000',
    client: {
      firstName: 'firstName',
      lastName: 'lastName',
      email: 'test@example.com',
      phone: '+17069805493'
    },
    paymentDetails: {orderTotal: 0, currency: 'USD'},
    externalOrderId: '1234567879abcdEF_-',
    externalBookingId: '1234567879abcdEF_-',
    externalOrderData: {source: 'external-system', customField: 'value', syncedAt: '2026-01-09'},
    externalBookingData: {source: 'external-system', customField: 'value', syncedAt: '2026-01-09'},
    sendProviderEmailNotification: true
  })
};

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

Example Request Body

{
  "reservedSlotId": "550e8400-e29b-41d4-a716-446655440000",
  "serviceId": "00000000-0000-0000-0000-000000000000",
  "client": {
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "test@example.com",
    "phone": "+17069805493"
  },
  "paymentDetails": {
    "orderTotal": 0,
    "currency": "USD"
  },
  "externalOrderId": "1234567879abcdEF_-",
  "externalBookingId": "1234567879abcdEF_-",
  "externalOrderData": {
    "source": "external-system",
    "customField": "value",
    "syncedAt": "2026-01-09"
  },
  "externalBookingData": {
    "source": "external-system",
    "customField": "value",
    "syncedAt": "2026-01-09"
  },
  "sendProviderEmailNotification": true
}

json

Example Responses

{
  "order": {
    "orderId": "00000000-0000-0000-0000-000000000000",
    "serviceName": "serviceName",
    "type": "SINGLE",
    "orderNumber": 0,
    "clientId": "clientId",
    "providerId": "providerId",
    "currency": "currency",
    "status": "CONFIRMED",
    "address": {
      "addressOneLine": "100 Yonge street, Toronto, ON M1T 3N3, Canada",
      "state": "FL",
      "country": "Canada",
      "countryCode": "CA",
      "postalCode": "94043",
      "latitude": 49.2827,
      "longitude": -123.1207
    },
    "externalOrderId": "externalOrderId",
    "externalOrderData": {
      "source": "external-system",
      "customField": "value",
      "syncedAt": "2026-01-09"
    },
    "orderTotal": 0,
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z"
  },
  "booking": {
    "bookingId": "00000000-0000-0000-0000-000000000000",
    "serviceName": "serviceName",
    "orderId": "orderId",
    "serviceId": "serviceId",
    "providerId": "providerId",
    "clientId": "clientId",
    "startDateAndTime": "2024-08-25T15:00:00Z",
    "durationMins": 0,
    "serviceLocation": "serviceLocation",
    "status": "SCHEDULED",
    "timezone": "timezone",
    "orderType": "SINGLE",
    "externalBookingId": "externalBookingId",
    "externalBookingData": {
      "source": "external-system",
      "customField": "value",
      "syncedAt": "2026-01-09"
    },
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Reserved slots Bookings

Create order

POST

https://api.gomarketbox.com/v1

/resources/orders

Create order › 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

Create order › Request Body

reservedSlotId

string · required

Reserved slot ID obtained from POST /reservedslots endpoint

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

serviceId

string · uuid · required

Service unique identifier

Example: 123e4567-e89b-12d3-a456-426614174000

object · required

object

externalOrderId

string

Example: 1234567879abcdEF_-

externalBookingId

string

This is the unique identifier of the booking inside your system – MarketBox will store and map this internally

Example: 1234567879abcdEF_-

object

Additional external data for the order

Example: {"source":"external-system","customField":"value","syncedAt":"2026-01-09"}

object

Additional external data for the booking

Example: {"source":"external-system","customField":"value","syncedAt":"2026-01-09"}

sendProviderEmailNotification

boolean

Default: true

Create order › Responses

Order created successfully

object · required

const options = { method: 'POST', headers: { 'Content-Type': 'application/json', 'content-type': '<string>', 'idempotency-key': '<string>' }, body: JSON.stringify({ reservedSlotId: '550e8400-e29b-41d4-a716-446655440000', serviceId: '00000000-0000-0000-0000-000000000000', client: { firstName: 'firstName', lastName: 'lastName', email: 'test@example.com', phone: '+17069805493' }, paymentDetails: {orderTotal: 0, currency: 'USD'}, externalOrderId: '1234567879abcdEF_-', externalBookingId: '1234567879abcdEF_-', externalOrderData: {source: 'external-system', customField: 'value', syncedAt: '2026-01-09'}, externalBookingData: {source: 'external-system', customField: 'value', syncedAt: '2026-01-09'}, sendProviderEmailNotification: true }) }; fetch('https://api.gomarketbox.com/v1/resources/orders', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));

{ "reservedSlotId": "550e8400-e29b-41d4-a716-446655440000", "serviceId": "00000000-0000-0000-0000-000000000000", "client": { "firstName": "firstName", "lastName": "lastName", "email": "test@example.com", "phone": "+17069805493" }, "paymentDetails": { "orderTotal": 0, "currency": "USD" }, "externalOrderId": "1234567879abcdEF_-", "externalBookingId": "1234567879abcdEF_-", "externalOrderData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "externalBookingData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "sendProviderEmailNotification": true }

{ "order": { "orderId": "00000000-0000-0000-0000-000000000000", "serviceName": "serviceName", "type": "SINGLE", "orderNumber": 0, "clientId": "clientId", "providerId": "providerId", "currency": "currency", "status": "CONFIRMED", "address": { "addressOneLine": "100 Yonge street, Toronto, ON M1T 3N3, Canada", "state": "FL", "country": "Canada", "countryCode": "CA", "postalCode": "94043", "latitude": 49.2827, "longitude": -123.1207 }, "externalOrderId": "externalOrderId", "externalOrderData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "orderTotal": 0, "createdAt": "2024-08-25T15:00:00Z", "updatedAt": "2024-08-25T15:00:00Z" }, "booking": { "bookingId": "00000000-0000-0000-0000-000000000000", "serviceName": "serviceName", "orderId": "orderId", "serviceId": "serviceId", "providerId": "providerId", "clientId": "clientId", "startDateAndTime": "2024-08-25T15:00:00Z", "durationMins": 0, "serviceLocation": "serviceLocation", "status": "SCHEDULED", "timezone": "timezone", "orderType": "SINGLE", "externalBookingId": "externalBookingId", "externalBookingData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "createdAt": "2024-08-25T15:00:00Z", "updatedAt": "2024-08-25T15:00:00Z" } }