MarketBox API

Providers

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 reading Providers from the MarketBox platform.

Get Providers

GET

https://api.gomarketbox.com/v1

/resources/providers

Use this endpoint to get all your proividers. You may also use query params to get the providers within a specific country, or state or city.

Get Providers › query Parameters

limit

string · pattern: ^\d+$

Maximum number of items to return per page (default: 20, max: 100). Note: The actual number of items returned may be less than this value due to DynamoDB pagination, server-side filtering, or data availability. Always check 'pagination.nextCursor' to determine if more results are available.

Example: 20

Default: 100

nextCursor

string

Pagination cursor from a previous response. Pass the 'nextCursor' value from the previous response here to fetch the next page of results. Omit this parameter for the first page.

Example: eyJpZCI6IjEyMyIsInNrIjoiYWJjIn0=

country

string · minLength: 2 · maxLength: 2

ISO-3166-1 alpha-2 country code.

Example: US

state

string · minLength: 1

State or province code. Query param 'country' must also be passed in if 'state' is being passed in.

Example: TX

city

string · minLength: 1

City name. Query params 'country' and 'state' must also be passed in if 'city' is being passed in.

Example: Austin

Get Providers › Responses

The list of providers

success

boolean · enum · required

Indicates the request was successful

Enum values:

object[] · required

Array of items for the current page. The length may be less than the requested 'limit' due to filtering or data availability.

object · required

GET/resources/providers

const options = {method: 'GET'};

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

Example Responses

{
  "success": true,
  "data": [
    {
      "providerId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "firstname": "John",
      "lastname": "Doe",
      "emailaddress": "test@example.com",
      "phone": "+1234567890",
      "timezone": "America/New_York",
      "bio": "Experienced professional with 10 years of service",
      "picture": {
        "url": "https://www.example.com/path/to/resource",
        "expiresAt": "2024-08-25T15:00:00Z"
      },
      "offersMobileServices": true,
      "active": true,
      "deleted": false,
      "ratingstarsavg": 4.35,
      "numberofratings": 142,
      "offersVirtualServices": false,
      "maxTravelTime": 30,
      "externalId": "ext-12345",
      "externalData": {
        "source": "external-system",
        "customField": "value",
        "syncedAt": "2026-01-09"
      },
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "services": [
        {
          "id": "service-uuid-1",
          "name": "Haircut",
          "locations": [
            {
              "id": "location-id-1",
              "name": "Downtown Office"
            }
          ]
        }
      ],
      "skills": [
        {
          "id": "skill-uuid-123",
          "name": "Advanced Color Techniques"
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6IjEyMyIsInNrIjoiYWJjIn0="
  }
}

json

application/json

Get Provider

GET

https://api.gomarketbox.com/v1

/resources/providers/{id}

Get Provider › path Parameters

id

string · required

Get Provider › Responses

The provider details

providerId

string · required

createdAt

string · date-time · required

updatedAt

string · date-time · required

firstname

string

lastname

string

emailaddress

string · email

phone

string

timezone

string

bio

string

object

Signed URL for profile picture with expiration

offersMobileServices

boolean

active

boolean

deleted

boolean

ratingstarsavg

number

Average rating in stars (formatted to 2 decimal places)

Example: 4.35

numberofratings

integer

offersVirtualServices

boolean

maxTravelTime

integer

Maximum travel time allowed between bookings in minutes

Example: 30

externalId

string

External system identifier

Example: ext-12345

object

Additional external data as key-value pairs

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

object[]

Serivces provided by the provider

Example: [{"id":"service-uuid-1","name":"Haircut","locations":[{"id":"loc-1","name":"Downtown Office"}]}]

object[]

Skills of the provider

Example: [{"id":"skill-1","name":"Advanced Color Techniques"},{"id":"skill-2","name":"Balayage Specialist"}]

GET/resources/providers/{id}

const options = {method: 'GET'};

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

Example Responses

{
  "providerId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "firstname": "John",
  "lastname": "Doe",
  "emailaddress": "test@example.com",
  "phone": "+1234567890",
  "timezone": "America/New_York",
  "bio": "Experienced professional with 10 years of service",
  "picture": {
    "url": "https://www.example.com/path/to/resource",
    "expiresAt": "2024-08-25T15:00:00Z"
  },
  "offersMobileServices": true,
  "active": true,
  "deleted": false,
  "ratingstarsavg": 4.35,
  "numberofratings": 142,
  "offersVirtualServices": false,
  "maxTravelTime": 30,
  "externalId": "ext-12345",
  "externalData": {
    "source": "external-system",
    "customField": "value",
    "syncedAt": "2026-01-09"
  },
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z",
  "services": [
    {
      "id": "service-uuid-1",
      "name": "Haircut",
      "locations": [
        {
          "id": "location-id-1",
          "name": "Downtown Office"
        }
      ]
    }
  ],
  "skills": [
    {
      "id": "skill-uuid-123",
      "name": "Advanced Color Techniques"
    }
  ]
}

json

application/json

Services Clients

Get Providers

GET

https://api.gomarketbox.com/v1

/resources/providers

Use this endpoint to get all your proividers. You may also use query params to get the providers within a specific country, or state or city.

Get Providers › query Parameters

limit

string · pattern: ^\d+$

Example: 20

Default: 100

nextCursor

string

Pagination cursor from a previous response. Pass the 'nextCursor' value from the previous response here to fetch the next page of results. Omit this parameter for the first page.

Example: eyJpZCI6IjEyMyIsInNrIjoiYWJjIn0=

country

string · minLength: 2 · maxLength: 2

ISO-3166-1 alpha-2 country code.

Example: US

state

string · minLength: 1

State or province code. Query param 'country' must also be passed in if 'state' is being passed in.

Example: TX

city

string · minLength: 1

City name. Query params 'country' and 'state' must also be passed in if 'city' is being passed in.

Example: Austin

Get Providers › Responses

The list of providers

success

boolean · enum · required

Indicates the request was successful

Enum values:

object[] · required

Array of items for the current page. The length may be less than the requested 'limit' due to filtering or data availability.

object · required

const options = {method: 'GET'}; fetch('https://api.gomarketbox.com/v1/resources/providers', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));

{ "success": true, "data": [ { "providerId": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "firstname": "John", "lastname": "Doe", "emailaddress": "test@example.com", "phone": "+1234567890", "timezone": "America/New_York", "bio": "Experienced professional with 10 years of service", "picture": { "url": "https://www.example.com/path/to/resource", "expiresAt": "2024-08-25T15:00:00Z" }, "offersMobileServices": true, "active": true, "deleted": false, "ratingstarsavg": 4.35, "numberofratings": 142, "offersVirtualServices": false, "maxTravelTime": 30, "externalId": "ext-12345", "externalData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "createdAt": "2024-08-25T15:00:00Z", "updatedAt": "2024-08-25T15:00:00Z", "services": [ { "id": "service-uuid-1", "name": "Haircut", "locations": [ { "id": "location-id-1", "name": "Downtown Office" } ] } ], "skills": [ { "id": "skill-uuid-123", "name": "Advanced Color Techniques" } ] } ], "pagination": { "nextCursor": "eyJpZCI6IjEyMyIsInNrIjoiYWJjIn0=" } }

Get Provider

GET

https://api.gomarketbox.com/v1

/resources/providers/{id}

Get Provider › path Parameters

id

string · required

Get Provider › Responses

The provider details

providerId

string · required

createdAt

string · date-time · required

updatedAt

string · date-time · required

firstname

string

lastname

string

emailaddress

string · email

phone

string

timezone

string

bio

string

object

Signed URL for profile picture with expiration

offersMobileServices

boolean

active

boolean

deleted

boolean

ratingstarsavg

number

Average rating in stars (formatted to 2 decimal places)

Example: 4.35

numberofratings

integer

offersVirtualServices

boolean

maxTravelTime

integer

Maximum travel time allowed between bookings in minutes

Example: 30

externalId

string

External system identifier

Example: ext-12345

object

Additional external data as key-value pairs

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

object[]

Serivces provided by the provider

Example: [{"id":"service-uuid-1","name":"Haircut","locations":[{"id":"loc-1","name":"Downtown Office"}]}]

object[]

Skills of the provider

Example: [{"id":"skill-1","name":"Advanced Color Techniques"},{"id":"skill-2","name":"Balayage Specialist"}]

const options = {method: 'GET'}; fetch('https://api.gomarketbox.com/v1/resources/providers/:id', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));

{ "providerId": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "firstname": "John", "lastname": "Doe", "emailaddress": "test@example.com", "phone": "+1234567890", "timezone": "America/New_York", "bio": "Experienced professional with 10 years of service", "picture": { "url": "https://www.example.com/path/to/resource", "expiresAt": "2024-08-25T15:00:00Z" }, "offersMobileServices": true, "active": true, "deleted": false, "ratingstarsavg": 4.35, "numberofratings": 142, "offersVirtualServices": false, "maxTravelTime": 30, "externalId": "ext-12345", "externalData": { "source": "external-system", "customField": "value", "syncedAt": "2026-01-09" }, "createdAt": "2024-08-25T15:00:00Z", "updatedAt": "2024-08-25T15:00:00Z", "services": [ { "id": "service-uuid-1", "name": "Haircut", "locations": [ { "id": "location-id-1", "name": "Downtown Office" } ] } ], "skills": [ { "id": "skill-uuid-123", "name": "Advanced Color Techniques" } ] }