Creates an order (a cart/purchase record). For a package, add an item with { skuType: "PACKAGE", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: "SINGLE_SESSION", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.
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
Order data
clientId
string
required
The client placing the order.
Minimum string length: 1
Example:
"cli_01kv8p20m1gnqvxl92xln6awk8"
currency
string
required
ISO 4217 currency you quoted the buyer. Verified against the price the server resolves for this order's region; a mismatch is a 400.
Required string length: 3
Example:
"CAD"
locale
string
The locale your buyer completed this purchase in — typically the language segment of your storefront URL. Normalized to canonical BCP-47 on write, so en-us is stored as en-US. It is copied onto every booking this order funds and saved as the client's default locale.
Example:
"en-US"
attribution
object
Which search and site session this purchase came from: the searchId of the search response the buyer booked from, your opaque sessionKey, and the surface the list was drawn on. Optional. Stored as given and copied onto every booking this order funds; holds and the booking routes never take one of their own. A searchId MarketBox never issued is kept but not counted.
The hold this order funds. Preferred: the hold already knows where the booking happens, so the order and its bookings cannot disagree on price.
Minimum string length: 1
Example:
"resv_01kx16f0a1c7b2sd91xzq3mn5p"
locationId
string
Stored Location for a PHYSICAL booking. Ignored when reservationId is given.
Minimum string length: 1
address
object
Service address for a TRAVEL_ZONE (in-home) booking. Ignored when reservationId or locationId is given.
Show child attributes
items
object[]
Line items to purchase.
Show child attributes
Response
Order created
data
object
required
Show child attributes
{"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/orders/create-a-new-order","slug":"/api-reference/orders/create-a-new-order","pageMetadata":{"title":"Create a new order","description":"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \"PACKAGE\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \"SINGLE_SESSION\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders","href":"/api-reference/orders/create-a-new-order","autogeneratedByOpenApi":true},"description":"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \"PACKAGE\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \"SINGLE_SESSION\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.","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":"Create a new order","description":"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \"PACKAGE\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \"SINGLE_SESSION\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders","href":"/api-reference/orders/create-a-new-order","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Orders"],"summary":"Create a new order","description":"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \"PACKAGE\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \"SINGLE_SESSION\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.","parameters":["75dcd3be-4fd5-459a-aa9a-c71e6d903a4c"],"requestBody":"5b12b086-d9b3-4258-88c8-3c0ec4445c59","responses":{"201":"6bf65033-4129-4e31-b991-f620ae954ba0","400":"7aed2da4-27a8-4326-ad14-746996e4c21d","401":"4fcc9e72-18f8-4161-a6bb-f4b96a7da80c","403":"b1690ef2-dcef-4435-85bd-bd5ee7a0d640","404":"1cb553f2-597e-4162-923c-1344339d9667","422":"7b63fc4b-00ff-4863-9a28-2c025ec7ce94"},"method":"post","type":"path","servers":["7f0c0cfd-7cba-4616-861f-ca7611ae4010"],"security":["db6d1cf6-4a08-4a4c-92da-023445e576e6"],"path":"/v1/projects/{projectId}/orders","baseUrlOptions":["https://apiv2.gomarketbox.com"],"title":"Create a new order","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"75dcd3be-4fd5-459a-aa9a-c71e6d903a4c":{"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":"Order data","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string","minLength":1,"description":"The client placing the order.","example":"cli_01kv8p20m1gnqvxl92xln6awk8","isRequired":true,"uniqueKey":"clientId","typeLabel":"string"},"currency":{"type":"string","minLength":3,"maxLength":3,"description":"ISO 4217 currency you quoted the buyer. Verified against the price the server resolves for this order's region; a mismatch is a 400.","example":"CAD","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"locale":{"type":"string","description":"The locale your buyer completed this purchase in — typically the language segment of your storefront URL. Normalized to canonical BCP-47 on write, so `en-us` is stored as `en-US`. It is copied onto every booking this order funds and saved as the client's default locale.","example":"en-US","uniqueKey":"locale","typeLabel":"string"},"attribution":{"type":"object","properties":{"searchId":{"type":"string","minLength":1,"maxLength":128,"description":"The `searchId` of the MarketBox search response the buyer booked from — the `X-MB-Search-Id` header / body field of every search route. Stored as given; a value MarketBox never issued is kept but not trusted.","example":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","uniqueKey":"attribution.searchId","typeLabel":"string"},"sessionKey":{"type":"string","minLength":1,"maxLength":64,"description":"The same opaque per-session key you send with site events, at most 64 characters. Never an email, IP or user id.","example":"sess-example-01","uniqueKey":"attribution.sessionKey","typeLabel":"string"},"surface":{"type":"string","enum":["home","results","listing","site_search","profile","widget","assistant","other"],"description":"Where on your site the buyer started the purchase.","example":"results","uniqueKey":"attribution.surface","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"description":"Which search and site session this purchase came from: the `searchId` of the search response the buyer booked from, your opaque `sessionKey`, and the `surface` the list was drawn on. Optional. Stored as given and copied onto every booking this order funds; holds and the booking routes never take one of their own. A `searchId` MarketBox never issued is kept but not counted.","example":{"searchId":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","sessionKey":"sess-example-01","surface":"results"},"uniqueKey":"attribution","typeLabel":"object"},"reservationId":{"type":"string","minLength":1,"description":"The hold this order funds. Preferred: the hold already knows where the booking happens, so the order and its bookings cannot disagree on price.","example":"resv_01kx16f0a1c7b2sd91xzq3mn5p","uniqueKey":"reservationId","typeLabel":"string"},"locationId":{"type":"string","minLength":1,"description":"Stored Location for a PHYSICAL booking. Ignored when reservationId is given.","uniqueKey":"locationId","typeLabel":"string"},"address":{"type":"object","properties":{"addressOneLine":{"type":"string","minLength":1,"description":"The whole address on one line, as a person would write it.","example":"10 Main St, Toronto, ON M5V 1A1, Canada","isRequired":true,"uniqueKey":"address.addressOneLine","typeLabel":"string"},"streetNumber":{"type":"string","minLength":1,"description":"The street number.","example":"10","isRequired":true,"uniqueKey":"address.streetNumber","typeLabel":"string"},"streetName":{"type":"string","minLength":1,"description":"The street name.","example":"Main St","isRequired":true,"uniqueKey":"address.streetName","typeLabel":"string"},"city":{"type":"string","minLength":1,"description":"The city or town.","example":"Toronto","isRequired":true,"uniqueKey":"address.city","typeLabel":"string"},"state":{"type":"string","minLength":1,"description":"The state, province or region; an ISO 3166-2 code when one matches.","example":"ON","isRequired":true,"uniqueKey":"address.state","typeLabel":"string"},"country":{"type":"string","minLength":1,"description":"The country; ISO 3166-1 alpha-2, alpha-3 or the English name.","example":"CA","isRequired":true,"uniqueKey":"address.country","typeLabel":"string"},"zipCode":{"type":"string","minLength":1,"description":"The postal or ZIP code, in any national format.","example":"M5V 1A1","isRequired":true,"uniqueKey":"address.zipCode","typeLabel":"string"},"unitNumber":{"oneOf":[{"type":"string","description":"The unit, suite or apartment, if any.","example":"4B","uniqueKey":"address.unitNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"The unit, suite or apartment, if any.","example":"4B","uniqueKey":"address.unitNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.unitNumber","typeLabel":"string | null"}},"required":["addressOneLine","streetNumber","streetName","city","state","country","zipCode"],"description":"Service address for a TRAVEL_ZONE (in-home) booking. Ignored when reservationId or locationId is given.","uniqueKey":"address","typeLabel":"object"},"items":{"type":"array","items":{"type":"object","properties":{"skuType":{"type":"string","enum":["SINGLE_SESSION","PACKAGE","SUBSCRIPTION","MEMBERSHIP","DEPOSIT"],"description":"What kind of line this is: SINGLE_SESSION, PACKAGE, SUBSCRIPTION, MEMBERSHIP, or DEPOSIT.","example":"PACKAGE","isRequired":true,"uniqueKey":"\\items.items.[INDEX].skuType","typeLabel":"enum\u003cstring>"},"packageId":{"type":"string","minLength":1,"description":"Required for PACKAGE items. serviceId, offeringId, session count, price and expiry are all derived from the package.","example":"pkg_01kv7n10k0fnptwk81wkm59vj7","uniqueKey":"\\items.items.[INDEX].packageId","typeLabel":"string"},"serviceId":{"type":"string","minLength":1,"description":"Required for SINGLE_SESSION items.","example":"srv_01kv60qg12e82acr78edfnjhvv","uniqueKey":"\\items.items.[INDEX].serviceId","typeLabel":"string"},"offeringId":{"type":"string","minLength":1,"description":"Required for SINGLE_SESSION items.","example":"off_01kv60qge5eh59ap0gw0pqrrys","uniqueKey":"\\items.items.[INDEX].offeringId","typeLabel":"string"},"quantity":{"type":"integer","minimum":1,"description":"Units to purchase (SINGLE_SESSION).","example":1,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"integer"}},"required":["skuType"],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"default":[],"description":"Line items to purchase.","uniqueKey":"\\items","typeLabel":"object[]"}},"required":["clientId","currency"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"clientId":"cli_01kv8p20m1gnqvxl92xln6awk8","currency":"CAD","locale":"en-US","attribution":{"searchId":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","sessionKey":"sess-example-01","surface":"results"},"reservationId":"resv_01kx16f0a1c7b2sd91xzq3mn5p","locationId":"\u003cstring>","items":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6bf65033-4129-4e31-b991-f620ae954ba0":{"description":"Order created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order":{"type":"object","properties":{"projectId":{"type":"string","isRequired":true,"uniqueKey":"data.order.projectId","typeLabel":"string"},"tenantId":{"type":"string","isRequired":true,"uniqueKey":"data.order.tenantId","typeLabel":"string"},"orderId":{"type":"string","isRequired":true,"uniqueKey":"data.order.orderId","typeLabel":"string"},"clientId":{"type":"string","isRequired":true,"uniqueKey":"data.order.clientId","typeLabel":"string"},"currency":{"type":"string","minLength":3,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.currency","typeLabel":"string"},"subtotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.subtotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.subtotal.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.order.subtotal","typeLabel":"object"},"tax":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.tax.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.tax.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.order.tax","typeLabel":"object"},"total":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.total.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.total.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.order.total","typeLabel":"object"},"amountPaid":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.amountPaid.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.amountPaid.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.order.amountPaid","typeLabel":"object"},"amountRefunded":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.amountRefunded.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.amountRefunded.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.order.amountRefunded","typeLabel":"object"},"status":{"type":"string","enum":["DRAFT","PENDING","PAID","CANCELLED"],"isRequired":true,"uniqueKey":"data.order.status","typeLabel":"enum\u003cstring>"},"statusUpdatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.order.statusUpdatedAt","typeLabel":"string\u003cdate-time>"},"deleted":{"type":"boolean","isRequired":true,"uniqueKey":"data.order.deleted","typeLabel":"boolean"},"version":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.version","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.order.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.order.updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"string","isRequired":true,"uniqueKey":"data.order.createdBy","typeLabel":"string"},"updatedBy":{"type":"string","isRequired":true,"uniqueKey":"data.order.updatedBy","typeLabel":"string"},"feeTotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.feeTotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.feeTotal.currency","typeLabel":"string"}},"required":["amount","currency"],"uniqueKey":"data.order.feeTotal","typeLabel":"object"},"cancellationReason":{"oneOf":[{"type":"string","uniqueKey":"data.order.cancellationReason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.order.cancellationReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.cancellationReason","typeLabel":"string | null"},"cancelledBy":{"oneOf":[{"type":"string","uniqueKey":"data.order.cancelledBy.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.order.cancelledBy.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.cancelledBy","typeLabel":"string | null"},"paymentMethod":{"type":"string","enum":["STRIPE","CASH","EXTERNAL","COMP","MIXED","LEGACY"],"uniqueKey":"data.order.paymentMethod","typeLabel":"enum\u003cstring>"},"settledAt":{"type":"string","format":"date-time","uniqueKey":"data.order.settledAt","typeLabel":"string\u003cdate-time>"},"amountComped":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.order.amountComped.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.order.amountComped.currency","typeLabel":"string"}},"required":["amount","currency"],"uniqueKey":"data.order.amountComped","typeLabel":"object"},"pricingRegion":{"oneOf":[{"type":"object","properties":{"country":{"oneOf":[{"type":"string","uniqueKey":"data.order.pricingRegion.oneOf.0.country.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.order.pricingRegion.oneOf.0.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.pricingRegion.oneOf.0.country","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","uniqueKey":"data.order.pricingRegion.oneOf.0.state.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.order.pricingRegion.oneOf.0.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.pricingRegion.oneOf.0.state","typeLabel":"string | null"},"postalCode":{"oneOf":[{"type":"string","uniqueKey":"data.order.pricingRegion.oneOf.0.postalCode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.order.pricingRegion.oneOf.0.postalCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.pricingRegion.oneOf.0.postalCode","typeLabel":"string | null"}},"uniqueKey":"data.order.pricingRegion.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"state":{"oneOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"oneOf":[{"type":"string"},{"type":"null"}]}},"uniqueKey":"data.order.pricingRegion.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.order.pricingRegion","typeLabel":"object | null"},"locale":{"type":"string","uniqueKey":"data.order.locale","typeLabel":"string"},"attribution":{"type":"object","properties":{"searchId":{"type":"string","minLength":1,"maxLength":128,"description":"The `searchId` of the MarketBox search response the buyer booked from — the `X-MB-Search-Id` header / body field of every search route. Stored as given; a value MarketBox never issued is kept but not trusted.","example":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","uniqueKey":"data.order.attribution.searchId","typeLabel":"string"},"sessionKey":{"type":"string","minLength":1,"maxLength":64,"description":"The same opaque per-session key you send with site events, at most 64 characters. Never an email, IP or user id.","example":"sess-example-01","uniqueKey":"data.order.attribution.sessionKey","typeLabel":"string"},"surface":{"type":"string","enum":["home","results","listing","site_search","profile","widget","assistant","other"],"description":"Where on your site the buyer started the purchase.","example":"results","uniqueKey":"data.order.attribution.surface","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"description":"Which search and site session this purchase came from. Optional; set once on the order and copied onto every booking it funds. See the search-log guide, \"Booking attribution\".","uniqueKey":"data.order.attribution","typeLabel":"object"}},"required":["projectId","tenantId","orderId","clientId","currency","subtotal","tax","total","amountPaid","amountRefunded","status","statusUpdatedAt","deleted","version","createdAt","updatedAt","createdBy","updatedBy"],"isRequired":true,"uniqueKey":"data.order","typeLabel":"object"},"items":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].projectId","typeLabel":"string"},"orderId":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].orderId","typeLabel":"string"},"orderItemId":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].orderItemId","typeLabel":"string"},"skuType":{"type":"string","enum":["SINGLE_SESSION","PACKAGE","SUBSCRIPTION","MEMBERSHIP","DEPOSIT"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].skuType","typeLabel":"enum\u003cstring>"},"serviceId":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].serviceId","typeLabel":"string"},"offeringId":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].offeringId","typeLabel":"string"},"quantity":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].quantity","typeLabel":"integer"},"quantityAllocated":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].quantityAllocated","typeLabel":"integer"},"quantityRemaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].quantityRemaining","typeLabel":"integer"},"unitPrice":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].unitPrice.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].unitPrice.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].unitPrice","typeLabel":"object"},"lineTotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].lineTotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].lineTotal.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].lineTotal","typeLabel":"object"},"deleted":{"type":"boolean","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].deleted","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].createdBy","typeLabel":"string"},"updatedBy":{"type":"string","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].updatedBy","typeLabel":"string"},"packageId":{"oneOf":[{"type":"string","uniqueKey":"data.\\items.items.[INDEX].packageId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.\\items.items.[INDEX].packageId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].packageId","typeLabel":"string | null"},"taxSnapshot":{"oneOf":[{"type":"object","properties":{"taxable":{"type":"boolean","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].taxSnapshot.oneOf.0.taxable","typeLabel":"boolean"},"taxPercentage":{"type":"number","minimum":0,"uniqueKey":"data.\\items.items.[INDEX].taxSnapshot.oneOf.0.taxPercentage","typeLabel":"number"}},"required":["taxable"],"uniqueKey":"data.\\items.items.[INDEX].taxSnapshot.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"taxable":{"type":"boolean"},"taxPercentage":{"type":"number","minimum":0}},"required":["taxable"],"uniqueKey":"data.\\items.items.[INDEX].taxSnapshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].taxSnapshot","typeLabel":"object | null"},"feeSnapshot":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feeId":{"type":"string","minLength":1,"description":"Stable identifier for this fee, unique within the business model.","example":"fee_booking","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].feeId","typeLabel":"string"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].name.additionalProperties","typeLabel":"string"},"description":"Buyer-facing label, rendered as its own line on the order summary.","example":{"en":"Booking fee"},"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].name","typeLabel":"object"},"calculation":{"type":"string","enum":["FLAT","PERCENT"],"description":"How a service fee is calculated. FLAT charges a fixed amount; PERCENT charges a percentage of the pre-tax total of the lines the fee governs.","example":"FLAT","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].calculation","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","minimum":0,"description":"FLAT fees only. Integer minor units, charged in whatever currency the order is placed in — 2500 is CA$25.00 on a CAD order and US$25.00 on a USD one. Use a PERCENT fee if you need it to scale.","example":2500,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].amount","typeLabel":"integer"},"percentage":{"type":"number","minimum":0,"maximum":100,"description":"PERCENT fees only. Applied to the pre-tax total of this business model's lines on the order.","example":5,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].percentage","typeLabel":"number"},"taxable":{"type":"boolean","default":false,"description":"When true, the fee is taxed at the rate of the order lines it is charged alongside (sessions or packages sold under this business model) that are taxed at a positive rate. Lines that are not taxable or taxed at 0% lend no rate; if none of the lines is taxed, the fee is not taxed either.","example":false,"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX].taxable","typeLabel":"boolean"}},"required":["feeId","name","calculation"],"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"feeId":{"type":"string","minLength":1,"description":"Stable identifier for this fee, unique within the business model.","example":"fee_booking"},"name":{"type":"object","additionalProperties":{"type":"string"},"description":"Buyer-facing label, rendered as its own line on the order summary.","example":{"en":"Booking fee"}},"calculation":{"type":"string","enum":["FLAT","PERCENT"],"description":"How a service fee is calculated. FLAT charges a fixed amount; PERCENT charges a percentage of the pre-tax total of the lines the fee governs.","example":"FLAT"},"amount":{"type":"integer","minimum":0,"description":"FLAT fees only. Integer minor units, charged in whatever currency the order is placed in — 2500 is CA$25.00 on a CAD order and US$25.00 on a USD one. Use a PERCENT fee if you need it to scale.","example":2500},"percentage":{"type":"number","minimum":0,"maximum":100,"description":"PERCENT fees only. Applied to the pre-tax total of this business model's lines on the order.","example":5},"taxable":{"type":"boolean","default":false,"description":"When true, the fee is taxed at the rate of the order lines it is charged alongside (sessions or packages sold under this business model) that are taxed at a positive rate. Lines that are not taxable or taxed at 0% lend no rate; if none of the lines is taxed, the fee is not taxed either.","example":false}},"required":["feeId","name","calculation"]},"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].feeSnapshot","typeLabel":"object[] | null"},"businessModelId":{"oneOf":[{"type":"string","uniqueKey":"data.\\items.items.[INDEX].businessModelId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.\\items.items.[INDEX].businessModelId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].businessModelId","typeLabel":"string | null"},"label":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.\\items.items.[INDEX].label.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"data.\\items.items.[INDEX].label.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"data.\\items.items.[INDEX].label.oneOf.1.additionalProperties","typeLabel":"string"},"uniqueKey":"data.\\items.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].label","typeLabel":"object | null"},"priceRuleId":{"oneOf":[{"type":"string","description":"Which regional price rule this line resolved to. Compare against the offering/package `pricing[]` to see exactly which price was applied.","uniqueKey":"data.\\items.items.[INDEX].priceRuleId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which regional price rule this line resolved to. Compare against the offering/package `pricing[]` to see exactly which price was applied.","uniqueKey":"data.\\items.items.[INDEX].priceRuleId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].priceRuleId","typeLabel":"string | null"},"priceScope":{"oneOf":[{"type":"string","enum":["DEFAULT","COUNTRY","STATE","POSTAL",null],"description":"Specificity of the matched rule: DEFAULT, COUNTRY, STATE or POSTAL. DEFAULT means no regional rule matched and the fallback price was used.","uniqueKey":"data.\\items.items.[INDEX].priceScope.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["DEFAULT","COUNTRY","STATE","POSTAL",null],"description":"Specificity of the matched rule: DEFAULT, COUNTRY, STATE or POSTAL. DEFAULT means no regional rule matched and the fallback price was used.","uniqueKey":"data.\\items.items.[INDEX].priceScope.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].priceScope","typeLabel":"enum\u003cstring> | null"},"priceSource":{"type":"string","enum":["RULE","MANUAL"],"description":"Where this line’s price came from. RULE: resolved from the offering or package `pricing[]` (see `priceRuleId`). MANUAL: set by staff when the order was created, in place of the rule price; `priceRuleId` is null and `unitPrice` will not match any rule. Absent on items written before this field existed.","uniqueKey":"data.\\items.items.[INDEX].priceSource","typeLabel":"enum\u003cstring>"},"taxExemptReason":{"type":"string","enum":["NO_RATE","NOT_TAXABLE","ZERO_RATE","MIGRATED_V1","PACKAGE_EXEMPT_LEGACY"],"description":"Why this line carries no tax. NO_RATE: neither the matched price rule, its parent rules, nor the service set a rate. NOT_TAXABLE: the resolved tax settings mark it not taxable. ZERO_RATE: taxable at 0%. MIGRATED_V1: imported from MarketBox v1, which recorded tax on the order rather than per line. PACKAGE_EXEMPT_LEGACY: a package line written while package purchases were untaxed (June–September 2026). Absent when the line is taxed at a positive rate, and on lines written before this field existed.","uniqueKey":"data.\\items.items.[INDEX].taxExemptReason","typeLabel":"enum\u003cstring>"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.\\items.items.[INDEX].expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.\\items.items.[INDEX].expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.\\items.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time> | null"}},"required":["projectId","orderId","orderItemId","skuType","serviceId","offeringId","quantity","quantityAllocated","quantityRemaining","unitPrice","lineTotal","deleted","createdAt","updatedAt","createdBy","updatedBy"],"uniqueKey":"data.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.\\items","typeLabel":"object[]"},"summary":{"type":"object","properties":{"currency":{"type":"string","isRequired":true,"uniqueKey":"data.summary.currency","typeLabel":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"orderItemId":{"type":"string","isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].orderItemId","typeLabel":"string"},"label":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.summary.lines.items.[INDEX].label.oneOf.0.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].label.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"data.summary.lines.items.[INDEX].label.oneOf.1.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].label","typeLabel":"object | null"},"skuType":{"type":"string","enum":["SINGLE_SESSION","PACKAGE","SUBSCRIPTION","MEMBERSHIP","DEPOSIT"],"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].skuType","typeLabel":"enum\u003cstring>"},"quantity":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].quantity","typeLabel":"integer"},"unitPrice":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].unitPrice.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].unitPrice.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].unitPrice","typeLabel":"object"},"lineTotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].lineTotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].lineTotal.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].lineTotal","typeLabel":"object"},"tax":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].tax.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].tax.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].tax","typeLabel":"object"},"taxable":{"type":"boolean","isRequired":true,"uniqueKey":"data.summary.lines.items.[INDEX].taxable","typeLabel":"boolean"},"priceRuleId":{"oneOf":[{"type":"string","description":"Which regional price rule this line resolved to. Compare against the offering/package `pricing[]` to see exactly which price was applied.","uniqueKey":"data.summary.lines.items.[INDEX].priceRuleId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which regional price rule this line resolved to. Compare against the offering/package `pricing[]` to see exactly which price was applied.","uniqueKey":"data.summary.lines.items.[INDEX].priceRuleId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.summary.lines.items.[INDEX].priceRuleId","typeLabel":"string | null"},"priceScope":{"oneOf":[{"type":"string","enum":["DEFAULT","COUNTRY","STATE","POSTAL",null],"description":"Specificity of the matched rule: DEFAULT, COUNTRY, STATE or POSTAL. DEFAULT means no regional rule matched and the fallback price was used.","uniqueKey":"data.summary.lines.items.[INDEX].priceScope.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["DEFAULT","COUNTRY","STATE","POSTAL",null],"description":"Specificity of the matched rule: DEFAULT, COUNTRY, STATE or POSTAL. DEFAULT means no regional rule matched and the fallback price was used.","uniqueKey":"data.summary.lines.items.[INDEX].priceScope.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.summary.lines.items.[INDEX].priceScope","typeLabel":"enum\u003cstring> | null"}},"required":["orderItemId","label","skuType","quantity","unitPrice","lineTotal","tax","taxable"],"uniqueKey":"data.summary.lines.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.summary.lines","typeLabel":"object[]"},"fees":{"type":"array","items":{"type":"object","properties":{"feeId":{"type":"string","description":"The fee as configured on the business model.","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].feeId","typeLabel":"string"},"businessModelId":{"type":"string","description":"The business model that levied this fee — the commercial definition the charge belongs to.","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].businessModelId","typeLabel":"string"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.summary.fees.items.[INDEX].name.additionalProperties","typeLabel":"string"},"description":"Buyer-facing label, snapshotted at purchase time.","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].name","typeLabel":"object"},"calculation":{"type":"string","enum":["FLAT","PERCENT"],"description":"How a service fee is calculated. FLAT charges a fixed amount; PERCENT charges a percentage of the pre-tax total of the lines the fee governs.","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].calculation","typeLabel":"enum\u003cstring>"},"basis":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].basis.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].basis.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Pre-tax total of this business model's lines — what a PERCENT fee was calculated against. Reported for FLAT fees too, so the figure is auditable.","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].basis","typeLabel":"object"},"amount":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].amount.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].amount.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].amount","typeLabel":"object"},"tax":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].tax.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].tax.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Tax on this fee, at the rate of its governing lines that are taxed at a positive rate. Zero when the fee is not taxable, or when none of those lines is taxed (each untaxed line says why in its taxExemptReason).","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].tax","typeLabel":"object"},"taxable":{"type":"boolean","isRequired":true,"uniqueKey":"data.summary.fees.items.[INDEX].taxable","typeLabel":"boolean"},"percentage":{"oneOf":[{"type":"number","description":"Echoed for PERCENT fees so the buyer can be shown the rate that applied (e.g. \"Admin fee (5%)\"). Absent for FLAT fees.","uniqueKey":"data.summary.fees.items.[INDEX].percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Echoed for PERCENT fees so the buyer can be shown the rate that applied (e.g. \"Admin fee (5%)\"). Absent for FLAT fees.","uniqueKey":"data.summary.fees.items.[INDEX].percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.summary.fees.items.[INDEX].percentage","typeLabel":"number | null"}},"required":["feeId","businessModelId","name","calculation","basis","amount","tax","taxable"],"uniqueKey":"data.summary.fees.items.[INDEX]","typeLabel":"object"},"description":"Service fees levied by the business models on this order. Each is a discrete charge in its own right. The fee amounts are NOT in `subtotal` or `taxTotal`, but tax charged on a fee IS added to `taxTotal`. Applied once per fee however many lines it governs.","isRequired":true,"uniqueKey":"data.summary.fees","typeLabel":"object[]"},"feeTotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.feeTotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.feeTotal.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Sum of `fees[].amount`. Sits outside `subtotal`, so `total = subtotal + feeTotal + taxTotal`.","isRequired":true,"uniqueKey":"data.summary.feeTotal","typeLabel":"object"},"subtotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.subtotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.subtotal.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.subtotal","typeLabel":"object"},"taxTotal":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.taxTotal.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.taxTotal.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.taxTotal","typeLabel":"object"},"total":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.total.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.total.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.total","typeLabel":"object"},"amountPaid":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.amountPaid.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.amountPaid.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.amountPaid","typeLabel":"object"},"amountRefunded":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.amountRefunded.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.amountRefunded.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.amountRefunded","typeLabel":"object"},"amountDue":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.summary.amountDue.amount","typeLabel":"integer"},"currency":{"type":"string","minLength":1,"maxLength":3,"isRequired":true,"uniqueKey":"data.summary.amountDue.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"data.summary.amountDue","typeLabel":"object"}},"required":["currency","lines","fees","feeTotal","subtotal","taxTotal","total","amountPaid","amountRefunded","amountDue"],"isRequired":true,"uniqueKey":"data.summary","typeLabel":"object"}},"required":["order","items","summary"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"order":{"projectId":"\u003cstring>","tenantId":"\u003cstring>","orderId":"\u003cstring>","clientId":"\u003cstring>","currency":"\u003cstring>","subtotal":{"amount":1,"currency":"\u003cstring>"},"tax":{"amount":1,"currency":"\u003cstring>"},"total":{"amount":1,"currency":"\u003cstring>"},"amountPaid":{"amount":1,"currency":"\u003cstring>"},"amountRefunded":{"amount":1,"currency":"\u003cstring>"},"status":"DRAFT","statusUpdatedAt":"2023-11-07T05:31:56Z","deleted":true,"version":1,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","createdBy":"\u003cstring>","updatedBy":"\u003cstring>","feeTotal":{"amount":1,"currency":"\u003cstring>"},"cancellationReason":"\u003cstring>","cancelledBy":"\u003cstring>","paymentMethod":"STRIPE","settledAt":"2023-11-07T05:31:56Z","amountComped":{"amount":1,"currency":"\u003cstring>"},"pricingRegion":{"country":"\u003cstring>","state":"\u003cstring>","postalCode":"\u003cstring>"},"locale":"\u003cstring>","attribution":{"searchId":"srch_01k7q3x9h4e8rb2d6m0z5a7c1n","sessionKey":"sess-example-01","surface":"results"}},"items":[{"projectId":"\u003cstring>","orderId":"\u003cstring>","orderItemId":"\u003cstring>","skuType":"SINGLE_SESSION","serviceId":"\u003cstring>","offeringId":"\u003cstring>","quantity":1,"quantityAllocated":1,"quantityRemaining":1,"unitPrice":{"amount":1,"currency":"\u003cstring>"},"lineTotal":{"amount":1,"currency":"\u003cstring>"},"deleted":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","createdBy":"\u003cstring>","updatedBy":"\u003cstring>","packageId":"\u003cstring>","taxSnapshot":{"taxable":true,"taxPercentage":1},"feeSnapshot":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"percentage":5,"taxable":false}],"businessModelId":"\u003cstring>","label":{},"priceRuleId":"\u003cstring>","priceScope":"DEFAULT","priceSource":"RULE","taxExemptReason":"NO_RATE","expiresAt":"2023-11-07T05:31:56Z"}],"summary":{"currency":"\u003cstring>","lines":[{"orderItemId":"\u003cstring>","label":{},"skuType":"SINGLE_SESSION","quantity":1,"unitPrice":{"amount":1,"currency":"\u003cstring>"},"lineTotal":{"amount":1,"currency":"\u003cstring>"},"tax":{"amount":1,"currency":"\u003cstring>"},"taxable":true,"priceRuleId":"\u003cstring>","priceScope":"DEFAULT"}],"fees":[{"feeId":"\u003cstring>","businessModelId":"\u003cstring>","name":{},"calculation":"FLAT","basis":{"amount":1,"currency":"\u003cstring>"},"amount":{"amount":1,"currency":"\u003cstring>"},"tax":{"amount":1,"currency":"\u003cstring>"},"taxable":true,"percentage":123}],"feeTotal":{"amount":1,"currency":"\u003cstring>"},"subtotal":{"amount":1,"currency":"\u003cstring>"},"taxTotal":{"amount":1,"currency":"\u003cstring>"},"total":{"amount":1,"currency":"\u003cstring>"},"amountPaid":{"amount":1,"currency":"\u003cstring>"},"amountRefunded":{"amount":1,"currency":"\u003cstring>"},"amountDue":{"amount":1,"currency":"\u003cstring>"}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7aed2da4-27a8-4326-ad14-746996e4c21d":{"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"},"4fcc9e72-18f8-4161-a6bb-f4b96a7da80c":{"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"},"b1690ef2-dcef-4435-85bd-bd5ee7a0d640":{"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"},"1cb553f2-597e-4162-923c-1344339d9667":{"description":"Client, offering, project, reservation, or location not found (including a caller-supplied clientId/reservationId/locationId that does not resolve in 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"},"7b63fc4b-00ff-4863-9a28-2c025ec7ce94":{"description":"The service has no active rate of the kind the line implies, e.g. a SINGLE_SESSION line on a service with no active SINGLE_BOOKING rate (SERVICE_NOT_SOLD_AS); a line names a service that is not LIVE or was deleted, or an offering that is not ACTIVE (NOT_SELLABLE); or a PACKAGE line names a DRAFT or ARCHIVED package (PACKAGE_NOT_ACTIVE)","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":"Create a new order - MarketBox API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T15:10:26.909Z","originalFileLocation":"api-reference/orders/create-a-new-order.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=\"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \u0026quot;PACKAGE\u0026quot;, packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \u0026quot;SINGLE_SESSION\u0026quot;, serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.\">\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=\"Create a new order - MarketBox API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \u0026quot;PACKAGE\u0026quot;, packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \u0026quot;SINGLE_SESSION\u0026quot;, serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.\">\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/orders/create-a-new-order\">\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=Orders\u0026amp;title=Create+a+new+order\u0026amp;description=Creates+an+order+%28a+cart%2Fpurchase+record%29.+For+a+package%2C+add+an+item+with+%7B+skuType%3A+%22PACKAGE%22%2C+packageId+%7D+%E2%80%94+the+server+derives+service%2C+offering%2C+session+cou\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=96721f683512e13d630254fce8e5f2dc70083bdcff9e5003d4c52e5310d3e294\">\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=\"Create a new order - MarketBox API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \u0026quot;PACKAGE\u0026quot;, packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \u0026quot;SINGLE_SESSION\u0026quot;, serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=Orders\u0026amp;title=Create+a+new+order\u0026amp;description=Creates+an+order+%28a+cart%2Fpurchase+record%29.+For+a+package%2C+add+an+item+with+%7B+skuType%3A+%22PACKAGE%22%2C+packageId+%7D+%E2%80%94+the+server+derives+service%2C+offering%2C+session+cou\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=96721f683512e13d630254fce8e5f2dc70083bdcff9e5003d4c52e5310d3e294\">\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/orders/create-a-new-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/orders/create-a-new-order.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/orders/create-a-new-order#webpage\",\"url\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order\",\"name\":\"Create a new order\",\"description\":\"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \\\"PACKAGE\\\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \\\"SINGLE_SESSION\\\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.\",\"dateModified\":\"2026-11-19T15:10:26.909Z\",\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order#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\":\"Orders\",\"item\":\"https://docs.gomarketbox.com/api-reference/orders/list-orders-by-status-by-payment-method-or-every-order-in-a-date-range\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a new order\",\"item\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order#apireference\",\"headline\":\"Create a new order\",\"name\":\"Create a new order\",\"description\":\"Creates an order (a cart/purchase record). For a package, add an item with { skuType: \\\"PACKAGE\\\", packageId } — the server derives service, offering, session count (creditCount), price and expiry from the package. For a single session use { skuType: \\\"SINGLE_SESSION\\\", serviceId, offeringId, quantity }. The order item is the credit ledger: its quantityRemaining is what bookings draw down. Currency is fixed at creation.\",\"url\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/orders/create-a-new-order#webpage\"},\"dateModified\":\"2026-11-19T15:10:26.909Z\",\"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/orders/create-a-new-order.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","description":"Exactly one listing mode per request, chosen by which filter you send:\n\n- `status` — orders in that status, narrowed by `startCreatedAt`/`endCreatedAt`.\n- `paymentMethod` — how orders were settled (`STRIPE`, `CASH`, `EXTERNAL`, `COMP`, `MIXED`, `LEGACY`), narrowed by `startSettledAt`/`endSettledAt`. This is the reconciliation read: \"what did we take in cash last month\".\n- neither — every order, narrowed by `startCreatedAt`/`endCreatedAt`.\n\nSending both `status` and `paymentMethod` is a 400, as is a date range belonging to the other mode (`startSettledAt` without `paymentMethod`, or `startCreatedAt` with it) — each index carries only one date, so the pairing is not a preference.\n\n⚠️ The no-filter mode reads an index whose key attributes are written only when an order is created, so every order created before this feature shipped, and every order migrated from MarketBox v1, is MISSING from it until a backfill runs. An empty or short page there does not mean the project has no orders — list by `status` when you need completeness over historical data.\n\nPaginate with `limit` and `cursor`; `nextCursor: null` is the last page. A cursor belongs to the filter set that minted it — replaying one after switching listing mode is rejected with a 400 `BAD_REQUEST` (\"Invalid cursor\") rather than silently returning the wrong page, so start a fresh request instead. To list one client's orders, use `GET /projects/{projectId}/clients/{clientId}/orders`.","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","description":"Returns the order header only — totals, currency, status and the `pricingRegion` it resolved at create time. It does NOT include line items; use the `/aggregate` variant when you need the items too, rather than calling this and then listing items separately.","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","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","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":"Create a new order - 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"]}