Find suppliers + suggested/open slots for a service, location and window
The main “when can this be booked” call. Returns two parallel, slot-centric arrays: timeSlots, the engine’s ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a “more times” view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering’s own duration.
Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability.
Setting bookingType: "recurring" changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. “FREQ=WEEKLY;BYDAY=TU;COUNT=3”). lookAheadStartDate is any ISO-8601 instant: a “Z” suffix and a numeric offset like “-04:00” are equally valid.
Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).
POST
/
v1
/
projects
/
{projectId}
/
availability
/
search
Find suppliers + suggested/open slots for a service, location and window
API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.
Path Parameters
projectId
string
required
The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.
Minimum string length: 1
Example:
"prj_01kv60qgnef2kt3pvqgwmkbzfr"
Body
application/json
Service + location + window
serviceId
string
required
Minimum string length: 1
offeringId
string
required
Minimum string length: 1
locationId
string
lat
stringnumber
lng
stringnumber
durationMinutes
integer
Required range: x > 0
lookAheadStartDate
string
lookAheadDays
integer
Required range: x > 0
timezone
string
Minimum string length: 1
distanceUnit
enum<string>
Available options:
km,
mi
order
enum<string> | null
Available options:
mustBeFirst,
mustBeLast,
null
preferredDays
integer[] | null
preferredTimes
object[] | null
Show child attributes
emptyDayAnchorTime
string | null
maxNumberOfBookingsPerDay
integer | null
Required range: x > 0
preferredTimeSlotThresholdMins
integer
Required range: x >= 0
timeSuggestionsLimit
integer
Required range: x > 0
sortBy
enum<string>
Available options:
leastTravelTime,
nearestDate
skills
string[]
Supplier skill IDs. A supplier must hold ALL of them to be considered. Omit for no skill filter.
Minimum string length: 1
Example:
["skl_01kv60qg12e82acr78edfnjhvv"]
interval
integer
Required range: x > 0
language
string
Preferred language for localized skill and offering NAMES. Not a filter — it never affects which suppliers or services match, and has no effect on this response.
bookingType
enum<string>
default:single
Available options:
single,
recurring
rrule
string
endDate
string
daysOfWeek
integer[]
Required range: 0 <= x <= 6
package
boolean
consistencyAsPercentage
boolean
fromMb
boolean
Response
Suggested slots + open slots
searchId
string
required
The id of this search, also returned as the X-MB-Search-Id header. Every page of a paginated search carries the same id (the cursor keeps it). Keep it for the session if you want attribution: pass it back as searchId when the client books, and in the search.rendered event when you report what you showed.
Example:
"srch_01k7q3x9h4e8rb2d6m0z5a7c1n"
status
string
required
timeSlots
null[]
required
Suggested slots, or recurring time patterns when bookingType=recurring. Each entry carries timeSlotDateAndTime (the slot instant rendered in the response timezone, with that zone's offset at that instant — R-30) and timeSlotStartUtc (the same instant in UTC, Z — R-31, always present, always the same instant as timeSlotDateAndTime). Prefer timeSlotStartUtc as the booking anchor.
openSlots
null[]
required
Every free interval at interval granularity, unranked. Each entry carries timeSlotDateAndTime (the slot instant rendered in the response timezone, with that zone's offset at that instant — R-30) and timeSlotStartUtc (the same instant in UTC, Z — R-31, always present, always the same instant as timeSlotDateAndTime). Prefer timeSlotStartUtc as the booking anchor.
suppliers
object[]
required
Show child attributes
errors
string[]
required
timezone
string
The IANA timezone actually used to render timeSlotDateAndTime and bucket days (R-32) — the request timezone, or the project default.
Example:
"America/Chicago"
supplierZones
object
IANA profile zone of each supplier that appears in timeSlots/openSlots, keyed by supplierId. Use it as the R-10 fallback for bookingTz on a virtual booking (location zone wins when there is one). Absent key = the supplier has no profile zone; use the project default.
Show child attributes
Example:
{ "sup_01abc": "America/Toronto" }
engineEnabled
boolean
False when Smart Clusters is switched off for this project. The engine then does not run, so timeSlots is empty because it was not computed, not because nobody is free; openSlots is unaffected. Check it before telling a client there is no availability.
Example:
true
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MarketBox API","description":"Reference and guides for the MarketBox public API","colors":{"primary":"#0087EE","light":"#0087EE","dark":"#0087EE"},"logo":{"light":"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/light.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=655948ee6454a1e06bfe0dffda47c7cc","dark":"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/dark.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=54826a391e30ee9c27adf963d88a61eb"},"favicon":"https://mintcdn.com/marketboxinc/oL3tvBLJ_yQtNXOS/favicon.svg?fit=max\u0026auto=format\u0026n=oL3tvBLJ_yQtNXOS\u0026q=85\u0026s=01ed3064e8e10cbf6c9a05fae050a805","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.gomarketbox.com/dashboard"}},"footer":{"socials":{"x":"https://x.com/marketboxio","linkedin":"https://linkedin.com/company/marketbox"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"marketboxinc","hasAudioNarration":false,"actualSubdomain":"marketboxinc","customDomains":["docs.gomarketbox.com"],"gitSource":{"type":"github","owner":"gomarketbox","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff115945eb182701d43e97","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":139},{"language":"default","tag":"Endpoints","count":138},{"language":"default","tag":"Guides","count":89},{"language":"default","tag":"Supplier plane","count":38},{"language":"default","tag":"Bookings","count":20},{"language":"default","tag":"Core concepts","count":14},{"language":"default","tag":"Orders","count":13},{"language":"default","tag":"Resources","count":12},{"language":"default","tag":"Suppliers","count":12},{"language":"default","tag":"Build a supplier portal","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window","slug":"/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window","pageMetadata":{"title":"Find suppliers + suggested/open slots for a service, location and window","description":"The main \"when can this be booked\" call. Returns two parallel, slot-centric arrays: `timeSlots`, the engine's ranked suggestions with travel between jobs taken into account, and `openSlots`, every free interval at `interval` granularity with no ranking. Show `timeSlots` to clients and keep `openSlots` for a \"more times\" view; they overlap by design. Identify the place with `locationId`, or with both `lat` and `lng` for in-home and travel-zone discovery — one or the other is required. `durationMinutes` is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering's own duration.\n\nFailures come back inside a 200. The body carries `status` and an `errors` array, so an empty `timeSlots` with a non-empty `errors` means the search broke, not that nobody is free — check `errors` before telling a client there is no availability.\n\nSetting `bookingType: \"recurring\"` changes what `timeSlots` contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — `rrule` is required, and it must carry a bounded positive COUNT (e.g. \"FREQ=WEEKLY;BYDAY=TU;COUNT=3\"). `lookAheadStartDate` is any ISO-8601 instant: a \"Z\" suffix and a numeric offset like \"-04:00\" are equally valid.\n\nEvery response carries a `searchId` (also the `X-MB-Search-Id` header) and `suppliers`, each supplier that appears in the slots with its 0-based `position` by first appearance. Keep `searchId` for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: `X-MB-Session-Key` (an opaque key you choose, up to 64 characters) and `X-MB-Client-Kind` (`browser`, `server`, `monitor` or `loadtest`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/search","href":"/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"The main “when can this be booked” call. Returns two parallel, slot-centric arrays: \", _jsx(_components.code, {\n children: \"timeSlots\"\n }), \", the engine’s ranked suggestions with travel between jobs taken into account, and \", _jsx(_components.code, {\n children: \"openSlots\"\n }), \", every free interval at \", _jsx(_components.code, {\n children: \"interval\"\n }), \" granularity with no ranking. Show \", _jsx(_components.code, {\n children: \"timeSlots\"\n }), \" to clients and keep \", _jsx(_components.code, {\n children: \"openSlots\"\n }), \" for a “more times” view; they overlap by design. Identify the place with \", _jsx(_components.code, {\n children: \"locationId\"\n }), \", or with both \", _jsx(_components.code, {\n children: \"lat\"\n }), \" and \", _jsx(_components.code, {\n children: \"lng\"\n }), \" for in-home and travel-zone discovery — one or the other is required. \", _jsx(_components.code, {\n children: \"durationMinutes\"\n }), \" is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering’s own duration.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Failures come back inside a 200. The body carries \", _jsx(_components.code, {\n children: \"status\"\n }), \" and an \", _jsx(_components.code, {\n children: \"errors\"\n }), \" array, so an empty \", _jsx(_components.code, {\n children: \"timeSlots\"\n }), \" with a non-empty \", _jsx(_components.code, {\n children: \"errors\"\n }), \" means the search broke, not that nobody is free — check \", _jsx(_components.code, {\n children: \"errors\"\n }), \" before telling a client there is no availability.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Setting \", _jsx(_components.code, {\n children: \"bookingType: \\\"recurring\\\"\"\n }), \" changes what \", _jsx(_components.code, {\n children: \"timeSlots\"\n }), \" contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — \", _jsx(_components.code, {\n children: \"rrule\"\n }), \" is required, and it must carry a bounded positive COUNT (e.g. “FREQ=WEEKLY;BYDAY=TU;COUNT=3”). \", _jsx(_components.code, {\n children: \"lookAheadStartDate\"\n }), \" is any ISO-8601 instant: a “Z” suffix and a numeric offset like “-04:00” are equally valid.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Every response carries a \", _jsx(_components.code, {\n children: \"searchId\"\n }), \" (also the \", _jsx(_components.code, {\n children: \"X-MB-Search-Id\"\n }), \" header) and \", _jsx(_components.code, {\n children: \"suppliers\"\n }), \", each supplier that appears in the slots with its 0-based \", _jsx(_components.code, {\n children: \"position\"\n }), \" by first appearance. Keep \", _jsx(_components.code, {\n children: \"searchId\"\n }), \" for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: \", _jsx(_components.code, {\n children: \"X-MB-Session-Key\"\n }), \" (an opaque key you choose, up to 64 characters) and \", _jsx(_components.code, {\n children: \"X-MB-Client-Kind\"\n }), \" (\", _jsx(_components.code, {\n children: \"browser\"\n }), \", \", _jsx(_components.code, {\n children: \"server\"\n }), \", \", _jsx(_components.code, {\n children: \"monitor\"\n }), \" or \", _jsx(_components.code, {\n children: \"loadtest\"\n }), \").\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Find suppliers + suggested/open slots for a service, location and window","description":"The main \"when can this be booked\" call. Returns two parallel, slot-centric arrays: `timeSlots`, the engine's ranked suggestions with travel between jobs taken into account, and `openSlots`, every free interval at `interval` granularity with no ranking. Show `timeSlots` to clients and keep `openSlots` for a \"more times\" view; they overlap by design. Identify the place with `locationId`, or with both `lat` and `lng` for in-home and travel-zone discovery — one or the other is required. `durationMinutes` is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering's own duration.\n\nFailures come back inside a 200. The body carries `status` and an `errors` array, so an empty `timeSlots` with a non-empty `errors` means the search broke, not that nobody is free — check `errors` before telling a client there is no availability.\n\nSetting `bookingType: \"recurring\"` changes what `timeSlots` contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — `rrule` is required, and it must carry a bounded positive COUNT (e.g. \"FREQ=WEEKLY;BYDAY=TU;COUNT=3\"). `lookAheadStartDate` is any ISO-8601 instant: a \"Z\" suffix and a numeric offset like \"-04:00\" are equally valid.\n\nEvery response carries a `searchId` (also the `X-MB-Search-Id` header) and `suppliers`, each supplier that appears in the slots with its 0-based `position` by first appearance. Keep `searchId` for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: `X-MB-Session-Key` (an opaque key you choose, up to 64 characters) and `X-MB-Client-Kind` (`browser`, `server`, `monitor` or `loadtest`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/search","href":"/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Availability"],"summary":"Find suppliers + suggested/open slots for a service, location and window","description":"The main \"when can this be booked\" call. Returns two parallel, slot-centric arrays: `timeSlots`, the engine's ranked suggestions with travel between jobs taken into account, and `openSlots`, every free interval at `interval` granularity with no ranking. Show `timeSlots` to clients and keep `openSlots` for a \"more times\" view; they overlap by design. Identify the place with `locationId`, or with both `lat` and `lng` for in-home and travel-zone discovery — one or the other is required. `durationMinutes` is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering's own duration.\n\nFailures come back inside a 200. The body carries `status` and an `errors` array, so an empty `timeSlots` with a non-empty `errors` means the search broke, not that nobody is free — check `errors` before telling a client there is no availability.\n\nSetting `bookingType: \"recurring\"` changes what `timeSlots` contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — `rrule` is required, and it must carry a bounded positive COUNT (e.g. \"FREQ=WEEKLY;BYDAY=TU;COUNT=3\"). `lookAheadStartDate` is any ISO-8601 instant: a \"Z\" suffix and a numeric offset like \"-04:00\" are equally valid.\n\nEvery response carries a `searchId` (also the `X-MB-Search-Id` header) and `suppliers`, each supplier that appears in the slots with its 0-based `position` by first appearance. Keep `searchId` for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: `X-MB-Session-Key` (an opaque key you choose, up to 64 characters) and `X-MB-Client-Kind` (`browser`, `server`, `monitor` or `loadtest`).","parameters":["0018beae-2673-433c-9484-7bf0e361f376"],"requestBody":"12c64d92-f279-4284-9fda-2ec44685ff01","responses":{"200":"37c165d8-14b7-4671-9d0a-f181c17b7dfc","400":"ab3d8fe3-ac27-4b47-b059-fa59c44e4095","401":"8ae54e01-54c8-4967-b8ee-0e73ac0b9fff","403":"273d6d6a-e2b3-4513-8e0c-ae42fd3d339e","404":"a8d9cb5c-3766-483e-b878-d46e637c0b4e"},"method":"post","type":"path","servers":["7f0c0cfd-7cba-4616-861f-ca7611ae4010"],"security":["db6d1cf6-4a08-4a4c-92da-023445e576e6"],"path":"/v1/projects/{projectId}/availability/search","baseUrlOptions":["https://apiv2.gomarketbox.com"],"title":"Find suppliers + suggested/open slots for a service, location and window","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0018beae-2673-433c-9484-7bf0e361f376":{"schema":{"type":"string","minLength":1,"description":"The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.","example":"prj_01kv60qgnef2kt3pvqgwmkbzfr","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.","name":"projectId","in":"path"}},"requestBody":{"description":"Service + location + window","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"serviceId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"serviceId","typeLabel":"string"},"offeringId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"offeringId","typeLabel":"string"},"locationId":{"type":"string","uniqueKey":"locationId","typeLabel":"string"},"lat":{"oneOf":[{"type":"string","uniqueKey":"lat.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"lat.oneOf.1","typeLabel":"number"}],"uniqueKey":"lat","typeLabel":"string | number"},"lng":{"oneOf":[{"type":"string","uniqueKey":"lng.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"lng.oneOf.1","typeLabel":"number"}],"uniqueKey":"lng","typeLabel":"string | number"},"durationMinutes":{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"durationMinutes","typeLabel":"integer"},"lookAheadStartDate":{"type":"string","uniqueKey":"lookAheadStartDate","typeLabel":"string"},"lookAheadDays":{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"lookAheadDays","typeLabel":"integer"},"timezone":{"type":"string","minLength":1,"uniqueKey":"timezone","typeLabel":"string"},"distanceUnit":{"type":"string","enum":["km","mi"],"uniqueKey":"distanceUnit","typeLabel":"enum\u003cstring>"},"order":{"oneOf":[{"type":"string","enum":["mustBeFirst","mustBeLast",null],"uniqueKey":"order.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["mustBeFirst","mustBeLast",null],"uniqueKey":"order.oneOf.1","typeLabel":"null"}],"uniqueKey":"order","typeLabel":"enum\u003cstring> | null"},"preferredDays":{"oneOf":[{"type":"array","items":{"type":"integer","uniqueKey":"preferredDays.oneOf.0.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"preferredDays.oneOf.0","typeLabel":"integer[]"},{"type":"null","items":{"type":"integer"},"uniqueKey":"preferredDays.oneOf.1","typeLabel":"null"}],"uniqueKey":"preferredDays","typeLabel":"integer[] | null"},"preferredTimes":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","isRequired":true,"uniqueKey":"preferredTimes.oneOf.0.items.[INDEX].startTime","typeLabel":"string"},"endTime":{"type":"string","isRequired":true,"uniqueKey":"preferredTimes.oneOf.0.items.[INDEX].endTime","typeLabel":"string"}},"required":["startTime","endTime"],"uniqueKey":"preferredTimes.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"preferredTimes.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["startTime","endTime"]},"uniqueKey":"preferredTimes.oneOf.1","typeLabel":"null"}],"uniqueKey":"preferredTimes","typeLabel":"object[] | null"},"emptyDayAnchorTime":{"oneOf":[{"type":"string","uniqueKey":"emptyDayAnchorTime.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"emptyDayAnchorTime.oneOf.1","typeLabel":"null"}],"uniqueKey":"emptyDayAnchorTime","typeLabel":"string | null"},"maxNumberOfBookingsPerDay":{"oneOf":[{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"maxNumberOfBookingsPerDay.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"exclusiveMinimum":true,"uniqueKey":"maxNumberOfBookingsPerDay.oneOf.1","typeLabel":"null"}],"uniqueKey":"maxNumberOfBookingsPerDay","typeLabel":"integer | null"},"preferredTimeSlotThresholdMins":{"type":"integer","minimum":0,"uniqueKey":"preferredTimeSlotThresholdMins","typeLabel":"integer"},"timeSuggestionsLimit":{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"timeSuggestionsLimit","typeLabel":"integer"},"sortBy":{"type":"string","enum":["leastTravelTime","nearestDate"],"uniqueKey":"sortBy","typeLabel":"enum\u003cstring>"},"skills":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"skills.items.[INDEX]","typeLabel":"string"},"description":"Supplier skill IDs. A supplier must hold ALL of them to be considered. Omit for no skill filter.","example":["skl_01kv60qg12e82acr78edfnjhvv"],"uniqueKey":"skills","typeLabel":"string[]"},"interval":{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"interval","typeLabel":"integer"},"language":{"type":"string","description":"Preferred language for localized skill and offering NAMES. Not a filter — it never affects which suppliers or services match, and has no effect on this response.","uniqueKey":"language","typeLabel":"string"},"bookingType":{"type":"string","enum":["single","recurring"],"default":"single","uniqueKey":"bookingType","typeLabel":"enum\u003cstring>"},"rrule":{"type":"string","uniqueKey":"rrule","typeLabel":"string"},"endDate":{"type":"string","uniqueKey":"endDate","typeLabel":"string"},"daysOfWeek":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6,"uniqueKey":"daysOfWeek.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"daysOfWeek","typeLabel":"integer[]"},"package":{"type":"boolean","uniqueKey":"package","typeLabel":"boolean"},"consistencyAsPercentage":{"type":"boolean","uniqueKey":"consistencyAsPercentage","typeLabel":"boolean"},"fromMb":{"type":"boolean","uniqueKey":"fromMb","typeLabel":"boolean"}},"required":["serviceId","offeringId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"serviceId":"\u003cstring>","offeringId":"\u003cstring>","locationId":"\u003cstring>","lat":"\u003cstring>","lng":"\u003cstring>","durationMinutes":1,"lookAheadStartDate":"\u003cstring>","lookAheadDays":1,"timezone":"\u003cstring>","preferredDays":[123],"preferredTimes":[{"startTime":"\u003cstring>","endTime":"\u003cstring>"}],"emptyDayAnchorTime":"\u003cstring>","maxNumberOfBookingsPerDay":1,"preferredTimeSlotThresholdMins":1,"timeSuggestionsLimit":1,"skills":["skl_01kv60qg12e82acr78edfnjhvv"],"interval":1,"language":"\u003cstring>","bookingType":"single","rrule":"\u003cstring>","endDate":"\u003cstring>","daysOfWeek":[3],"package":true,"consistencyAsPercentage":true,"fromMb":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"37c165d8-14b7-4671-9d0a-f181c17b7dfc":{"description":"Suggested slots + open slots","content":{"application/json":{"schema":{"type":"object","properties":{"searchId":{"type":"string","description":"The id of this search, also returned as the `X-MB-Search-Id` header. Every page of a paginated search carries the same id (the cursor keeps it). Keep it for the session if you want attribution: pass it back as `searchId` when the client books, and in the `search.rendered` event when you report what you showed.","example":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","isRequired":true,"uniqueKey":"searchId","typeLabel":"string"},"status":{"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"timeSlots":{"type":"array","items":{"oneOf":[{},{"type":"null","uniqueKey":"timeSlots.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"timeSlots.items.[INDEX]","typeLabel":"null"},"description":"Suggested slots, or recurring time patterns when bookingType=recurring. Each entry carries `timeSlotDateAndTime` (the slot instant rendered in the response `timezone`, with that zone's offset at that instant — R-30) and `timeSlotStartUtc` (the same instant in UTC, `Z` — R-31, always present, always the same instant as `timeSlotDateAndTime`). Prefer `timeSlotStartUtc` as the booking anchor.","isRequired":true,"uniqueKey":"timeSlots","typeLabel":"null[]"},"openSlots":{"type":"array","items":{"oneOf":[{},{"type":"null","uniqueKey":"openSlots.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"openSlots.items.[INDEX]","typeLabel":"null"},"description":"Every free interval at `interval` granularity, unranked. Each entry carries `timeSlotDateAndTime` (the slot instant rendered in the response `timezone`, with that zone's offset at that instant — R-30) and `timeSlotStartUtc` (the same instant in UTC, `Z` — R-31, always present, always the same instant as `timeSlotDateAndTime`). Prefer `timeSlotStartUtc` as the booking anchor.","isRequired":true,"uniqueKey":"openSlots","typeLabel":"null[]"},"suppliers":{"type":"array","items":{"type":"object","properties":{"supplierId":{"type":"string","example":"sup_01kv60qh3m7wznp8s0d2rk9abc","isRequired":true,"uniqueKey":"suppliers.items.[INDEX].supplierId","typeLabel":"string"},"position":{"type":"integer","minimum":0,"description":"0-based rank of this entry in the order the response returned it. Paged results continue the count across pages of the same `searchId`, so the first entry of page 2 is numbered after the last of page 1.","example":0,"isRequired":true,"uniqueKey":"suppliers.items.[INDEX].position","typeLabel":"integer"}},"required":["supplierId","position"],"description":"Each supplier that appears in `timeSlots` or `openSlots`, with its `position` — the 0-based rank of its FIRST slot in the returned order (`timeSlots` first, then `openSlots`). Ordered by position. The shape `search.rendered` takes.","uniqueKey":"suppliers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"suppliers","typeLabel":"object[]"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errors","typeLabel":"string[]"},"timezone":{"type":"string","description":"The IANA timezone actually used to render `timeSlotDateAndTime` and bucket days (R-32) — the request `timezone`, or the project default.","example":"America/Chicago","uniqueKey":"timezone","typeLabel":"string"},"supplierZones":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"supplierZones.additionalProperties","typeLabel":"string"},"description":"IANA profile zone of each supplier that appears in `timeSlots`/`openSlots`, keyed by supplierId. Use it as the R-10 fallback for `bookingTz` on a virtual booking (location zone wins when there is one). Absent key = the supplier has no profile zone; use the project default.","example":{"sup_01abc":"America/Toronto"},"uniqueKey":"supplierZones","typeLabel":"object"},"engineEnabled":{"type":"boolean","description":"False when Smart Clusters is switched off for this project. The engine then does not run, so `timeSlots` is empty because it was not computed, not because nobody is free; `openSlots` is unaffected. Check it before telling a client there is no availability.","example":true,"uniqueKey":"engineEnabled","typeLabel":"boolean"}},"required":["searchId","status","timeSlots","openSlots","suppliers","errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"searchId":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","status":"\u003cstring>","timeSlots":["\u003cunknown>"],"openSlots":["\u003cunknown>"],"suppliers":[{"supplierId":"sup_01kv60qh3m7wznp8s0d2rk9abc","position":0}],"errors":["\u003cstring>"],"timezone":"America/Chicago","supplierZones":{"sup_01abc":"America/Toronto"},"engineEnabled":true}}},"exampleType":"generated"}},"exampleType":"generated"},"ab3d8fe3-ac27-4b47-b059-fa59c44e4095":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"8ae54e01-54c8-4967-b8ee-0e73ac0b9fff":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"273d6d6a-e2b3-4513-8e0c-ae42fd3d339e":{"description":"API key cannot access this project","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"},"a8d9cb5c-3766-483e-b878-d46e637c0b4e":{"description":"No offering for this serviceId/offeringId, or no location for this locationId (sent without lat/lng); the message names the id","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code, e.g. NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of what went wrong.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","description":"The HTTP status code of this response.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"requestId":{"type":"string","description":"The id of this request, also returned as the X-Request-Id header. Quote it in a support ticket.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["code","message","statusCode","requestId"],"example":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Booking not found","statusCode":404,"requestId":"a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"db6d1cf6-4a08-4a4c-92da-023445e576e6":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"7f0c0cfd-7cba-4616-861f-ca7611ae4010":{"url":"https://apiv2.gomarketbox.com","description":"MarketBox Open API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (`*`) except `POST /v1/projects/{projectId}/events`, which needs `events:write`; a key without `*` is refused with 403 `CAPABILITY_NOT_GRANTED`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"marketboxinc","siteName":"MarketBox API","title":"Find suppliers + suggested/open slots for a service, location and window - MarketBox API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T15:10:27.371Z","originalFileLocation":"api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The main \u0026quot;when can this be booked\u0026quot; call. Returns two parallel, slot-centric arrays: timeSlots, the engine\u0026#x27;s ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a \u0026quot;more times\u0026quot; view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering\u0026#x27;s own duration. Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability. Setting bookingType: \u0026quot;recurring\u0026quot; changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. \u0026quot;FREQ=WEEKLY;BYDAY=TU;COUNT=3\u0026quot;). lookAheadStartDate is any ISO-8601 instant: a \u0026quot;Z\u0026quot; suffix and a numeric offset like \u0026quot;-04:00\u0026quot; are equally valid. Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).\">\u003cmeta data-mint-head name=\"application-name\" content=\"MarketBox API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Find suppliers + suggested/open slots for a service, location and window - MarketBox API\">\u003cmeta data-mint-head property=\"og:description\" content=\"The main \u0026quot;when can this be booked\u0026quot; call. Returns two parallel, slot-centric arrays: timeSlots, the engine\u0026#x27;s ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a \u0026quot;more times\u0026quot; view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering\u0026#x27;s own duration. Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability. Setting bookingType: \u0026quot;recurring\u0026quot; changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. \u0026quot;FREQ=WEEKLY;BYDAY=TU;COUNT=3\u0026quot;). lookAheadStartDate is any ISO-8601 instant: a \u0026quot;Z\u0026quot; suffix and a numeric offset like \u0026quot;-04:00\u0026quot; are equally valid. Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MarketBox API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=Availability\u0026amp;title=Find+suppliers+%2B+suggested%2Fopen+slots+for+a+service%2C+location+and+window\u0026amp;description=The+main+%22when+can+this+be+booked%22+call.+Returns+two+parallel%2C+slot-centric+arrays%3A+%60timeSlots%60%2C+the+engine%27s+ranked+suggestions+with+travel+between+jobs+taken+\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=2b06342636e7848ee629751d5c7f3b978447748dd5d0893975616d3a0941743a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Find suppliers + suggested/open slots for a service, location and window - MarketBox API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The main \u0026quot;when can this be booked\u0026quot; call. Returns two parallel, slot-centric arrays: timeSlots, the engine\u0026#x27;s ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a \u0026quot;more times\u0026quot; view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering\u0026#x27;s own duration. Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability. Setting bookingType: \u0026quot;recurring\u0026quot; changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. \u0026quot;FREQ=WEEKLY;BYDAY=TU;COUNT=3\u0026quot;). lookAheadStartDate is any ISO-8601 instant: a \u0026quot;Z\u0026quot; suffix and a numeric offset like \u0026quot;-04:00\u0026quot; are equally valid. Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=Availability\u0026amp;title=Find+suppliers+%2B+suggested%2Fopen+slots+for+a+service%2C+location+and+window\u0026amp;description=The+main+%22when+can+this+be+booked%22+call.+Returns+two+parallel%2C+slot-centric+arrays%3A+%60timeSlots%60%2C+the+engine%27s+ranked+suggestions+with+travel+between+jobs+taken+\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=2b06342636e7848ee629751d5c7f3b978447748dd5d0893975616d3a0941743a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/marketboxinc/etccUjaGielLGJIh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MarketBox API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0087EE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/availability/find-suppliers-%2B-suggestedopen-slots-for-a-service-location-and-window.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gomarketbox.com/#organization\",\"name\":\"MarketBox API\",\"url\":\"https://docs.gomarketbox.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/marketboxinc/ajdEqdrEaJkvfx4T/logo/light.svg?fit=max\u0026auto=format\u0026n=ajdEqdrEaJkvfx4T\u0026q=85\u0026s=655948ee6454a1e06bfe0dffda47c7cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gomarketbox.com#website\",\"name\":\"MarketBox API\",\"url\":\"https://docs.gomarketbox.com\",\"publisher\":{\"@id\":\"https://docs.gomarketbox.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window#webpage\",\"url\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window\",\"name\":\"Find suppliers + suggested/open slots for a service, location and window\",\"description\":\"The main \\\"when can this be booked\\\" call. Returns two parallel, slot-centric arrays: timeSlots, the engine's ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a \\\"more times\\\" view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering's own duration. Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability. Setting bookingType: \\\"recurring\\\" changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. \\\"FREQ=WEEKLY;BYDAY=TU;COUNT=3\\\"). lookAheadStartDate is any ISO-8601 instant: a \\\"Z\\\" suffix and a numeric offset like \\\"-04:00\\\" are equally valid. Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).\",\"dateModified\":\"2026-11-19T15:10:27.371Z\",\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.gomarketbox.com/api-reference/events/report-site-events-straight-from-the-browser-publishable-key-no-response-body\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Find suppliers + suggested/open slots for a service, location and window\",\"item\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window#apireference\",\"headline\":\"Find suppliers + suggested/open slots for a service, location and window\",\"name\":\"Find suppliers + suggested/open slots for a service, location and window\",\"description\":\"The main \\\"when can this be booked\\\" call. Returns two parallel, slot-centric arrays: timeSlots, the engine's ranked suggestions with travel between jobs taken into account, and openSlots, every free interval at interval granularity with no ranking. Show timeSlots to clients and keep openSlots for a \\\"more times\\\" view; they overlap by design. Identify the place with locationId, or with both lat and lng for in-home and travel-zone discovery — one or the other is required. durationMinutes is honoured only for FLEXIBLE offerings and is otherwise ignored in favour of the offering's own duration. Failures come back inside a 200. The body carries status and an errors array, so an empty timeSlots with a non-empty errors means the search broke, not that nobody is free — check errors before telling a client there is no availability. Setting bookingType: \\\"recurring\\\" changes what timeSlots contains: recurring time patterns rather than individual slots, so do not parse the two the same way. That branch adds two requirements, each a 400 and each guarding an input that used to return silence instead of an error — rrule is required, and it must carry a bounded positive COUNT (e.g. \\\"FREQ=WEEKLY;BYDAY=TU;COUNT=3\\\"). lookAheadStartDate is any ISO-8601 instant: a \\\"Z\\\" suffix and a numeric offset like \\\"-04:00\\\" are equally valid. Every response carries a searchId (also the X-MB-Search-Id header) and suppliers, each supplier that appears in the slots with its 0-based position by first appearance. Keep searchId for the session if you want attribution. Two optional request headers tag the search for insights and are never acted on: X-MB-Session-Key (an opaque key you choose, up to 64 characters) and X-MB-Client-Kind (browser, server, monitor or loadtest).\",\"url\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window#webpage\"},\"dateModified\":\"2026-11-19T15:10:27.371Z\",\"publisher\":{\"@id\":\"https://docs.gomarketbox.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MarketBox API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MarketBox API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/availability/find-suppliers-%2B-suggestedopen-slots-for-a-service-location-and-window.md","siteName":"MarketBox API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Events","pages":[{"title":"Report site events straight from the browser (publishable key, no response body)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events/beacon","href":"/api-reference/events/report-site-events-straight-from-the-browser-publishable-key-no-response-body"},{"title":"Report what your site showed: rendered searches, lists, impressions, clicks, profile views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events","href":"/api-reference/events/report-what-your-site-showed:-rendered-searches-lists-impressions-clicks-profile-views"}]},{"group":"Supplier plane","pages":[{"title":"Whether the signed-in person may use the supplier plane, and why not","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/access","href":"/api-reference/supplier-plane/whether-the-signed-in-person-may-use-the-supplier-plane-and-why-not"},{"title":"List the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-bookings"},{"title":"One of the signed-in supplier’s bookings, with services and participants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/one-of-the-signed-in-supplier’s-bookings-with-services-and-participants"},{"title":"Move one of the signed-in supplier’s bookings to another time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/move-one-of-the-signed-in-supplier’s-bookings-to-another-time"},{"title":"The signed-in supplier’s own attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-attendance-report-on-one-of-their-bookings"},{"title":"File the signed-in supplier’s attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/file-the-signed-in-supplier’s-attendance-report-on-one-of-their-bookings"},{"title":"Cancel one of the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/cancel","href":"/api-reference/supplier-plane/cancel-one-of-the-signed-in-supplier’s-bookings"},{"title":"List the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-schedules"},{"title":"Create a schedule for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/create-a-schedule-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-schedules"},{"title":"Delete one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-schedules"},{"title":"Update one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-schedules"},{"title":"Clone one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}/clone","href":"/api-reference/supplier-plane/clone-one-of-the-signed-in-supplier’s-schedules"},{"title":"Move the signed-in supplier’s schedules and blocked times to their profile zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/availability-timezone/apply-profile","href":"/api-reference/supplier-plane/move-the-signed-in-supplier’s-schedules-and-blocked-times-to-their-profile-zone"},{"title":"List the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-blocked-times"},{"title":"Create a blocked time for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/create-a-blocked-time-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Delete one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Update one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"The signed-in supplier’s Week \u0026 demand view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/demand","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-week-\u0026-demand-view"},{"title":"Dismiss one of the signed-in supplier’s demand suggestions for 90 days","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/dismiss-one-of-the-signed-in-supplier’s-demand-suggestions-for-90-days"},{"title":"Undo a dismissal: the suggestion shows again when the data still supports it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/undo-a-dismissal:-the-suggestion-shows-again-when-the-data-still-supports-it"},{"title":"The signed-in supplier’s Search insights","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/search-insights","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-search-insights"},{"title":"The signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-profile"},{"title":"Update the signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/update-the-signed-in-supplier’s-own-profile"},{"title":"Get a presigned URL to upload the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/avatar/upload-url","href":"/api-reference/supplier-plane/get-a-presigned-url-to-upload-the-signed-in-supplier’s-photo"},{"title":"Attach the uploaded photo to the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/attach-the-uploaded-photo-to-the-signed-in-supplier"},{"title":"Remove the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/remove-the-signed-in-supplier’s-photo"},{"title":"List the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-travel-zones"},{"title":"Create a travel zone for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/create-a-travel-zone-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Delete one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Update one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"List the venues the signed-in supplier may be scheduled at","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/locations","href":"/api-reference/supplier-plane/list-the-venues-the-signed-in-supplier-may-be-scheduled-at"},{"title":"List the signed-in supplier’s alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-alerts"},{"title":"The signed-in supplier’s unread count and open conditions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts/summary","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-unread-count-and-open-conditions"},{"title":"Mark all of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/read-all","href":"/api-reference/supplier-plane/mark-all-of-the-signed-in-supplier’s-alerts-read"},{"title":"Mark one of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/{alertId}/read","href":"/api-reference/supplier-plane/mark-one-of-the-signed-in-supplier’s-alerts-read"}]},{"group":"Bookings","pages":[{"title":"List bookings for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-project"},{"title":"Create a new booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/create-a-new-booking"},{"title":"Get a booking by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/get-a-booking-by-id"},{"title":"Soft-delete a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/soft-delete-a-booking"},{"title":"Reschedule or update a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/reschedule-or-update-a-booking"},{"title":"Get a booking with its services, participants, notes, reports and party names","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/aggregate","href":"/api-reference/bookings/get-a-booking-with-its-services-participants-notes-reports-and-party-names"},{"title":"Change a booking status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/status","href":"/api-reference/bookings/change-a-booking-status"},{"title":"List bookings for a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-supplier"},{"title":"List bookings for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-client"},{"title":"List participants on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/list-participants-on-a-booking"},{"title":"Register a participant on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/register-a-participant-on-a-booking"},{"title":"Get a single booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/get-a-single-booking-participant"},{"title":"Cancel a booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/cancel-a-booking-participant"},{"title":"Check in a participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}/check-in","href":"/api-reference/bookings/check-in-a-participant"},{"title":"List booking notes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/list-booking-notes"},{"title":"Create a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/create-a-booking-note"},{"title":"Delete a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/delete-a-booking-note"},{"title":"Update a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/update-a-booking-note"},{"title":"List the reports filed on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/list-the-reports-filed-on-a-booking"},{"title":"File one side's report on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/file-one-sides-report-on-a-booking"}]},{"group":"Reviews","pages":[{"title":"List every review linked to a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/list-every-review-linked-to-a-booking"},{"title":"Review a booking, in either direction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/review-a-booking-in-either-direction"},{"title":"List reviews for a project (newest first); filter by supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/list-reviews-for-a-project-newest-first;-filter-by-supplier"},{"title":"Create a supplier review (1–5 star rating with optional comment)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/create-a-supplier-review-1–5-star-rating-with-optional-comment"},{"title":"List the reviews written about a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/reviews","href":"/api-reference/reviews/list-the-reviews-written-about-a-client"},{"title":"Get a client's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/review-summary","href":"/api-reference/reviews/get-a-clients-average-rating-and-review-count"},{"title":"Get a supplier's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/review-summary","href":"/api-reference/reviews/get-a-suppliers-average-rating-and-review-count"}]},{"group":"Orders","pages":[{"title":"List orders by status, by payment method, or every order in a date range","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders","href":"/api-reference/orders/list-orders-by-status-by-payment-method-or-every-order-in-a-date-range"},{"title":"Create a new order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders","href":"/api-reference/orders/create-a-new-order"},{"title":"Get an order by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/get-an-order-by-id"},{"title":"Soft-delete an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/soft-delete-an-order"},{"title":"Update an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/update-an-order"},{"title":"Get an order with its items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/aggregate","href":"/api-reference/orders/get-an-order-with-its-items"},{"title":"List orders for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/orders","href":"/api-reference/orders/list-orders-for-a-client"},{"title":"Change order status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/status","href":"/api-reference/orders/change-order-status"},{"title":"Add an item to an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/items","href":"/api-reference/orders/add-an-item-to-an-order"},{"title":"Remove an order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/remove-an-order-item"},{"title":"Update an order item quantity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/update-an-order-item-quantity"},{"title":"List the bookings created for a PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/list-the-bookings-created-for-a-package-order-item"},{"title":"Create N package sessions atomically (or best-effort) from one PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/create-n-package-sessions-atomically-or-best-effort-from-one-package-order-item"}]},{"group":"Suppliers","pages":[{"title":"List suppliers for a project, enriched with services and skills; filter by service/skill/region/point","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/list-suppliers-for-a-project-enriched-with-services-and-skills;-filter-by-serviceskillregionpoint"},{"title":"Create a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/create-a-supplier"},{"title":"One supplier in full: profile, services, skills, locations, rating and working hours","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/one-supplier-in-full:-profile-services-skills-locations-rating-and-working-hours"},{"title":"Update a supplier; sync its service/skill mappings when arrays are supplied","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/update-a-supplier;-sync-its-serviceskill-mappings-when-arrays-are-supplied"},{"title":"Soft-delete a supplier (cascade-removes its mappings and avatar)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/soft-delete-a-supplier-cascade-removes-its-mappings-and-avatar"},{"title":"Add a service to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/add-a-service-to-a-supplier"},{"title":"Remove a service from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/remove-a-service-from-a-supplier"},{"title":"Add a skill to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/add-a-skill-to-a-supplier"},{"title":"Remove a skill from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/remove-a-skill-from-a-supplier"},{"title":"Get a presigned URL to upload a supplier avatar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/avatar/upload-url","href":"/api-reference/suppliers/get-a-presigned-url-to-upload-a-supplier-avatar"},{"title":"Confirm an uploaded avatar and attach it to the supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}/avatar","href":"/api-reference/suppliers/confirm-an-uploaded-avatar-and-attach-it-to-the-supplier"},{"title":"Remove a supplier's avatar","description":"Clears the avatar reference and deletes the stored image variants. Both the reference and the images are gone for good, so restoring the same picture means uploading it again through the presign flow. Returns 204 whether or not the supplier had an avatar, so use it freely without a prior read — but do not read the 204 as proof one was removed. To swap an avatar, skip this and confirm the new one directly; that replaces the old image in a single step and leaves no window where the supplier has none.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/avatar","href":"/api-reference/suppliers/remove-a-suppliers-avatar"}]},{"group":"Availability","pages":[{"title":"Find suppliers + suggested/open slots for a service, location and window","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/search","href":"/api-reference/availability/find-suppliers-+-suggestedopen-slots-for-a-service-location-and-window"},{"title":"Generate clustered time slots from suppliers + engine config","description":"Runs the clustering engine directly on suppliers and a config YOU supply. Nothing is read from the project — not the catalogue, not the supplier roster, not existing bookings — so this answers \"what would the engine do with these inputs\", not \"when is this bookable\". The supplier availability you pass is taken at face value, which means it will happily return slots for people who are already booked; never drive a booking flow from it. Use /availability/search, or /availability/suppliers for a supplier-centric view, for anything a client sees.\n\nIt exists for tuning and diagnosis: `metrics` and `kpis` in the response let you compare configs against a fixed input set, and replaying a captured payload reproduces a result (see the note on `metrics` below for when it does not). `config` is passed through to the engine largely unvalidated, so a malformed knob tends to surface as poor output or an entry in `errors` rather than a 400 — and as with the other availability routes, `errors` arrives inside a 200.\n\n`metrics.totalTravelTimeRequestsMade` is the number of distinct drives (direction, place) answered for this request, shared across all suppliers; a failed or unroutable drive is not counted.\n\nHistory: counts and slot distances changed on 2026-11-12 (routing in shared rounds). A payload captured before then can replay with different counts, distances and labels, and can gain slots.\n\nThe response carries a `searchId` (also the `X-MB-Search-Id` header) like every search route, but nothing is logged for insights: the suppliers and config are yours, not the project's.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/time-slots","href":"/api-reference/availability/generate-clustered-time-slots-from-suppliers-+-engine-config"},{"title":"Supplier-centric availability: paginated suppliers, each with open slots grouped by day","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/suppliers","href":"/api-reference/availability/supplier-centric-availability:-paginated-suppliers-each-with-open-slots-grouped-by-day"},{"title":"Build a single-supplier N-session package slate (policy-driven), persisting suggestions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/package-slate","href":"/api-reference/availability/build-a-single-supplier-n-session-package-slate-policy-driven-persisting-suggestions"},{"title":"List a service's packages, each with a ready-to-book slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/availability/package-options","href":"/api-reference/availability/list-a-services-packages-each-with-a-ready-to-book-slate"}]},{"group":"Suggestions","pages":[{"title":"Reschedule a suggested slot to a new time (server-validated), refreshing its slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suggestions/slots/{slotId}/reschedule","href":"/api-reference/suggestions/reschedule-a-suggested-slot-to-a-new-time-server-validated-refreshing-its-slate"}]},{"group":"Holds","pages":[{"title":"Hold supplier time during checkout — a single session, or a whole package slate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds","href":"/api-reference/holds/hold-supplier-time-during-checkout-—-a-single-session-or-a-whole-package-slate"},{"title":"Read a hold — its status, its heldUntil, and the supplier time it claims","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/holds/{reservationId}","href":"/api-reference/holds/read-a-hold-—-its-status-its-helduntil-and-the-supplier-time-it-claims"},{"title":"Release a hold (HELD → RELEASED) — idempotent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds/{reservationId}/release","href":"/api-reference/holds/release-a-hold-held-→-released-—-idempotent"},{"title":"Convert a hold into confirmed bookings (the idempotent purchase hook)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/holds/{reservationId}/convert","href":"/api-reference/holds/convert-a-hold-into-confirmed-bookings-the-idempotent-purchase-hook"}]},{"group":"Clients","pages":[{"title":"Onboard the authenticated client to a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me","href":"/api-reference/clients/onboard-the-authenticated-client-to-a-project"},{"title":"Update the authenticated client's contact details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/clients/me","href":"/api-reference/clients/update-the-authenticated-clients-contact-details"},{"title":"Get the authenticated client's package credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/me/credits","href":"/api-reference/clients/get-the-authenticated-clients-package-credits"},{"title":"Book sessions from the authenticated client's own package credit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me/orders/{orderId}/package-bookings","href":"/api-reference/clients/book-sessions-from-the-authenticated-clients-own-package-credit"},{"title":"Add a service address to the caller's client profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/clients/me/addresses","href":"/api-reference/clients/add-a-service-address-to-the-callers-client-profile"},{"title":"Remove one of the caller's addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/clients/me/addresses/{addressId}","href":"/api-reference/clients/remove-one-of-the-callers-addresses"},{"title":"Update one of the caller's addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/clients/me/addresses/{addressId}","href":"/api-reference/clients/update-one-of-the-callers-addresses"},{"title":"Set the caller's default address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/clients/me/addresses/{addressId}/default","href":"/api-reference/clients/set-the-callers-default-address"}]},{"group":"Services","pages":[{"title":"List services for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services","href":"/api-reference/services/list-services-for-a-project"},{"title":"Create a new service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services","href":"/api-reference/services/create-a-new-service"},{"title":"Get a service by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/get-a-service-by-id"},{"title":"Update a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/update-a-service"},{"title":"Soft delete a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/services/{serviceId}","href":"/api-reference/services/soft-delete-a-service"},{"title":"Change service status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/status","href":"/api-reference/services/change-service-status"}]},{"group":"ServiceBusinessModels","pages":[{"title":"List business models for a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/business-models","href":"/api-reference/servicebusinessmodels/list-business-models-for-a-service"},{"title":"Add a business model to a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/business-models","href":"/api-reference/servicebusinessmodels/add-a-business-model-to-a-service"},{"title":"Update a business model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}/business-models/{businessModelId}","href":"/api-reference/servicebusinessmodels/update-a-business-model"},{"title":"Toggle business model active status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/business-models/{businessModelId}/status","href":"/api-reference/servicebusinessmodels/toggle-business-model-active-status"}]},{"group":"ServiceOfferings","pages":[{"title":"List offerings for a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings","href":"/api-reference/serviceofferings/list-offerings-for-a-service"},{"title":"Add an offering to a service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings","href":"/api-reference/serviceofferings/add-an-offering-to-a-service"},{"title":"Get an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/get-an-offering"},{"title":"Update an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/update-an-offering"},{"title":"Soft delete an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}","href":"/api-reference/serviceofferings/soft-delete-an-offering"},{"title":"Change offering status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/status","href":"/api-reference/serviceofferings/change-offering-status"}]},{"group":"ServicePackages","pages":[{"title":"List packages for an offering (storefront)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/packages","href":"/api-reference/servicepackages/list-packages-for-an-offering-storefront"},{"title":"Create a sellable package (bundle) for an offering","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/services/{serviceId}/offerings/{offeringId}/packages","href":"/api-reference/servicepackages/create-a-sellable-package-bundle-for-an-offering"},{"title":"List every package for a service (storefront discovery)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/services/{serviceId}/packages","href":"/api-reference/servicepackages/list-every-package-for-a-service-storefront-discovery"},{"title":"Get a package by id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/packages/{packageId}","href":"/api-reference/servicepackages/get-a-package-by-id"},{"title":"Update a package","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/packages/{packageId}","href":"/api-reference/servicepackages/update-a-package"},{"title":"Change package status (rewrites the storefront sort key)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/packages/{packageId}/status","href":"/api-reference/servicepackages/change-package-status-rewrites-the-storefront-sort-key"}]},{"group":"Locations","pages":[{"title":"List locations for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/locations","href":"/api-reference/locations/list-locations-for-a-project"},{"title":"Get a location by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/locations/{locationId}","href":"/api-reference/locations/get-a-location-by-id"}]},{"group":"Skills","pages":[{"title":"List skills for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/skills","href":"/api-reference/skills/list-skills-for-a-project"}]},{"group":"Transactions","pages":[{"title":"Record a manual (cash/external/comp) transaction against an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/transactions","href":"/api-reference/transactions/record-a-manual-cashexternalcomp-transaction-against-an-order"},{"title":"List transactions (filter by order, client, or status)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/transactions","href":"/api-reference/transactions/list-transactions-filter-by-order-client-or-status"},{"title":"Create a Stripe PaymentIntent for an order (client-side confirmation)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/payment-intent","href":"/api-reference/transactions/create-a-stripe-paymentintent-for-an-order-client-side-confirmation"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Find suppliers + suggested/open slots for a service, location and window - MarketBox API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}