MarketBox API

Reserved slots

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 and deleting reserved slots inside the MarketBox platform.

Create reserved slot

POST

https://api.gomarketbox.com/v1

/resources/reservedslots

Create reserved slot › 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 reserved slot › Request Body

providerId

string · uuid · required

Provider unique identifier

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

serviceId

string · uuid · required

Service unique identifier

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

object · required

Provide either the address object OR a companyLocationId; if both are provided, the companyLocationId will override the address

Example: {"address":{"street":"220 Castlefrank Rd","city":"Stittsville","state":"ON","country":"Canada","postalCode":"K2L 1T5","latitude":45.2867248,"longitude":-75.8836231}}

timezone

string · required

IANA timezone

Example: America/Vancouver

startDateAndTime

string · date-time · required

Booking date and time with timezone offset

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

reservationTimeoutMins

integer · min: 5 · max: 1440 · required

The number of minutes MarketBox will hold the reservation before releasing it.

Create reserved slot › Responses

Reserved slot created successfully

reservedSlotId

string · required

Unique identifier (UUID) for the reserved slot mapping record

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

POST/resources/reservedslots

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'content-type': '<string>',
    'idempotency-key': '<string>'
  },
  body: JSON.stringify({
    providerId: '00000000-0000-0000-0000-000000000000',
    serviceId: '00000000-0000-0000-0000-000000000000',
    serviceLocation: {
      address: {
        street: '602 Victor way',
        city: 'Mountain View',
        state: 'FL',
        country: 'Canada',
        postalCode: '94043',
        latitude: 49.2827,
        longitude: -123.1207
      },
      companyLocationId: '00000000-0000-0000-0000-000000000000'
    },
    timezone: 'America/Vancouver',
    startDateAndTime: '2024-08-25T15:00:00Z',
    reservationTimeoutMins: 0
  })
};

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

Example Request Body

{
  "providerId": "00000000-0000-0000-0000-000000000000",
  "serviceId": "00000000-0000-0000-0000-000000000000",
  "serviceLocation": {
    "address": {
      "street": "602 Victor way",
      "city": "Mountain View",
      "state": "FL",
      "country": "Canada",
      "postalCode": "94043",
      "latitude": 49.2827,
      "longitude": -123.1207
    },
    "companyLocationId": "00000000-0000-0000-0000-000000000000"
  },
  "timezone": "America/Vancouver",
  "startDateAndTime": "2024-08-25T15:00:00Z",
  "reservationTimeoutMins": 0
}

json

Example Responses

{
  "reservedSlotId": "550e8400-e29b-41d4-a716-446655440000"
}

json

application/json

Remove reserved slot

DELETE

https://api.gomarketbox.com/v1

/resources/reservedslots/{reservedSlotId}

Remove reserved slot › path Parameters

reservedSlotId

string · uuid · required

Remove reserved slot › Responses

Reserved slot deleted successfully

No data returned

DELETE/resources/reservedslots/{reservedSlotId}

const options = {method: 'DELETE'};

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

Example Responses

No example specified for this content type

Timeslots Orders

Create reserved slot

POST

https://api.gomarketbox.com/v1

/resources/reservedslots

Create reserved slot › 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 reserved slot › Request Body

providerId

string · uuid · required

Provider unique identifier

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

serviceId

string · uuid · required

Service unique identifier

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

object · required

Provide either the address object OR a companyLocationId; if both are provided, the companyLocationId will override the address

Example: {"address":{"street":"220 Castlefrank Rd","city":"Stittsville","state":"ON","country":"Canada","postalCode":"K2L 1T5","latitude":45.2867248,"longitude":-75.8836231}}

timezone

string · required

IANA timezone

Example: America/Vancouver

startDateAndTime

string · date-time · required

Booking date and time with timezone offset

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

reservationTimeoutMins

integer · min: 5 · max: 1440 · required

The number of minutes MarketBox will hold the reservation before releasing it.

Create reserved slot › Responses

Reserved slot created successfully

reservedSlotId

string · required

Unique identifier (UUID) for the reserved slot mapping record

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

const options = { method: 'POST', headers: { 'Content-Type': 'application/json', 'content-type': '<string>', 'idempotency-key': '<string>' }, body: JSON.stringify({ providerId: '00000000-0000-0000-0000-000000000000', serviceId: '00000000-0000-0000-0000-000000000000', serviceLocation: { address: { street: '602 Victor way', city: 'Mountain View', state: 'FL', country: 'Canada', postalCode: '94043', latitude: 49.2827, longitude: -123.1207 }, companyLocationId: '00000000-0000-0000-0000-000000000000' }, timezone: 'America/Vancouver', startDateAndTime: '2024-08-25T15:00:00Z', reservationTimeoutMins: 0 }) }; fetch('https://api.gomarketbox.com/v1/resources/reservedslots', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));

{ "providerId": "00000000-0000-0000-0000-000000000000", "serviceId": "00000000-0000-0000-0000-000000000000", "serviceLocation": { "address": { "street": "602 Victor way", "city": "Mountain View", "state": "FL", "country": "Canada", "postalCode": "94043", "latitude": 49.2827, "longitude": -123.1207 }, "companyLocationId": "00000000-0000-0000-0000-000000000000" }, "timezone": "America/Vancouver", "startDateAndTime": "2024-08-25T15:00:00Z", "reservationTimeoutMins": 0 }