Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.
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"
serviceId
string
required
The service — the sellable thing (a lesson, a treatment). Offerings hang off a service and carry the duration and price.
Minimum string length: 1
Example:
"srv_01kv60qg12e82acr78edfnjhvv"
Body
application/json
Business model data
type
enum<string>
required
How the service is sold. SINGLE_BOOKING is one booking at a time; PACKAGE sells prepaid credits drawn down by later bookings; the SCHEDULED_* and FLEXIBLE_* variants add recurrence and subscription billing. This drives which order item skuType applies.
Available options:
SINGLE_BOOKING,
PACKAGE,
SCHEDULED_PACKAGE,
SCHEDULED_SUBSCRIPTION,
FLEXIBLE_SUBSCRIPTION
paymentOptions
enum<string>[]
required
Minimum array length: 1
Available options:
PAY_WHILE_BOOKING,
PAY_AFTER_SERVICE_DELIVERED,
NO_PAYMENT,
PAY_FULL_PRICE_WHILE_PURCHASING,
PAY_BEGINNING_OF_MONTH,
PAY_END_OF_MONTH
fees
object[]
Service fees — additional charges attached to this business model, applied to any order line sold under it. Each fee applies once per order regardless of how many lines it governs, and appears as its own entry on the order summary rather than being folded into tax.
{"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/servicebusinessmodels/add-a-business-model-to-a-service","slug":"/api-reference/servicebusinessmodels/add-a-business-model-to-a-service","pageMetadata":{"title":"Add a business model to a service","description":"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same `type` twice leaves two rows, both live, so list before you add. `type` cannot be changed afterwards, only deactivated, so pick it deliberately. `paymentOptions` sets when money is taken and must hold at least one option. `fees` are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same \", _jsx(_components.code, {\n children: \"type\"\n }), \" twice leaves two rows, both live, so list before you add. \", _jsx(_components.code, {\n children: \"type\"\n }), \" cannot be changed afterwards, only deactivated, so pick it deliberately. \", _jsx(_components.code, {\n children: \"paymentOptions\"\n }), \" sets when money is taken and must hold at least one option. \", _jsx(_components.code, {\n children: \"fees\"\n }), \" are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add a business model to a service","description":"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same `type` twice leaves two rows, both live, so list before you add. `type` cannot be changed afterwards, only deactivated, so pick it deliberately. `paymentOptions` sets when money is taken and must hold at least one option. `fees` are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["ServiceBusinessModels"],"summary":"Add a business model to a service","description":"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same `type` twice leaves two rows, both live, so list before you add. `type` cannot be changed afterwards, only deactivated, so pick it deliberately. `paymentOptions` sets when money is taken and must hold at least one option. `fees` are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.","parameters":["2973ef00-b4e5-4e86-92e0-b00ed412cc98","3de4809f-db41-43b5-9c00-d8fdcc667acd"],"requestBody":"cdcf08cd-a506-44c3-9053-e646cb067572","responses":{"201":"8969ff58-c87b-4e76-9058-e60cf09b6bcd","400":"ca08d579-e802-451e-9440-f18f2fed1b93","401":"38c48c42-3de2-4d6b-bc31-7666e6dda08e","403":"ddbf457b-e076-4c83-8d40-1fc2fb355ba6"},"method":"post","type":"path","servers":["7f0c0cfd-7cba-4616-861f-ca7611ae4010"],"security":["db6d1cf6-4a08-4a4c-92da-023445e576e6"],"path":"/v1/projects/{projectId}/services/{serviceId}/business-models","baseUrlOptions":["https://apiv2.gomarketbox.com"],"title":"Add a business model to a service","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2973ef00-b4e5-4e86-92e0-b00ed412cc98":{"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"},"3de4809f-db41-43b5-9c00-d8fdcc667acd":{"schema":{"type":"string","minLength":1,"description":"The service — the sellable thing (a lesson, a treatment). Offerings hang off a service and carry the duration and price.","example":"srv_01kv60qg12e82acr78edfnjhvv","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The service — the sellable thing (a lesson, a treatment). Offerings hang off a service and carry the duration and price.","name":"serviceId","in":"path"}},"requestBody":{"description":"Business model data","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["SINGLE_BOOKING","PACKAGE","SCHEDULED_PACKAGE","SCHEDULED_SUBSCRIPTION","FLEXIBLE_SUBSCRIPTION"],"description":"How the service is sold. SINGLE_BOOKING is one booking at a time; PACKAGE sells prepaid credits drawn down by later bookings; the SCHEDULED_* and FLEXIBLE_* variants add recurrence and subscription billing. This drives which order item skuType applies.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"paymentOptions":{"type":"array","items":{"type":"string","enum":["PAY_WHILE_BOOKING","PAY_AFTER_SERVICE_DELIVERED","NO_PAYMENT","PAY_FULL_PRICE_WHILE_PURCHASING","PAY_BEGINNING_OF_MONTH","PAY_END_OF_MONTH"],"uniqueKey":"paymentOptions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"isRequired":true,"uniqueKey":"paymentOptions","typeLabel":"enum\u003cstring>[]"},"fees":{"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":"fees.items.[INDEX].feeId","typeLabel":"string"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"fees.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":"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.","example":"FLAT","isRequired":true,"uniqueKey":"fees.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":"fees.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":"fees.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":"fees.items.[INDEX].taxable","typeLabel":"boolean"}},"required":["feeId","name","calculation"],"uniqueKey":"fees.items.[INDEX]","typeLabel":"object"},"maxItems":20,"default":[],"description":"Service fees — additional charges attached to this business model, applied to any order line sold under it. Each fee applies once per order regardless of how many lines it governs, and appears as its own entry on the order summary rather than being folded into tax.","example":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"taxable":false},{"feeId":"fee_admin","name":{"en":"Admin fee"},"calculation":"PERCENT","percentage":5,"taxable":true}],"uniqueKey":"fees","typeLabel":"object[]"},"config":{"type":"object","properties":{},"default":{},"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"config.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"config.additionalProperties","typeLabel":"null"},"uniqueKey":"config","typeLabel":"object"}},"required":["type","paymentOptions"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"paymentOptions":[],"fees":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"taxable":false},{"feeId":"fee_admin","name":{"en":"Admin fee"},"calculation":"PERCENT","percentage":5,"taxable":true}],"config":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8969ff58-c87b-4e76-9058-e60cf09b6bcd":{"description":"Business model created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entityType":{"type":"string","enum":["SERVICE_BUSINESS_MODEL"],"isRequired":true,"uniqueKey":"data.entityType","typeLabel":"enum\u003cstring>"},"projectId":{"type":"string","isRequired":true,"uniqueKey":"data.projectId","typeLabel":"string"},"serviceId":{"type":"string","isRequired":true,"uniqueKey":"data.serviceId","typeLabel":"string"},"businessModelId":{"type":"string","isRequired":true,"uniqueKey":"data.businessModelId","typeLabel":"string"},"type":{"type":"string","enum":["SINGLE_BOOKING","PACKAGE","SCHEDULED_PACKAGE","SCHEDULED_SUBSCRIPTION","FLEXIBLE_SUBSCRIPTION"],"description":"How the service is sold. SINGLE_BOOKING is one booking at a time; PACKAGE sells prepaid credits drawn down by later bookings; the SCHEDULED_* and FLEXIBLE_* variants add recurrence and subscription billing. This drives which order item skuType applies.","isRequired":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"paymentOptions":{"type":"array","items":{"type":"string","enum":["PAY_WHILE_BOOKING","PAY_AFTER_SERVICE_DELIVERED","NO_PAYMENT","PAY_FULL_PRICE_WHILE_PURCHASING","PAY_BEGINNING_OF_MONTH","PAY_END_OF_MONTH"],"uniqueKey":"data.paymentOptions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"data.paymentOptions","typeLabel":"enum\u003cstring>[]"},"config":{"type":"object","properties":{},"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"data.config.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.config.additionalProperties","typeLabel":"null"},"isRequired":true,"uniqueKey":"data.config","typeLabel":"object"},"active":{"type":"boolean","isRequired":true,"uniqueKey":"data.active","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"string","isRequired":true,"uniqueKey":"data.createdBy","typeLabel":"string"},"updatedBy":{"type":"string","isRequired":true,"uniqueKey":"data.updatedBy","typeLabel":"string"},"fees":{"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.fees.items.[INDEX].feeId","typeLabel":"string"},"name":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.fees.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.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.","example":"FLAT","isRequired":true,"uniqueKey":"data.fees.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.fees.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.fees.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.fees.items.[INDEX].taxable","typeLabel":"boolean"}},"required":["feeId","name","calculation"],"uniqueKey":"data.fees.items.[INDEX]","typeLabel":"object"},"maxItems":20,"description":"Service fees — additional charges attached to this business model, applied to any order line sold under it. Each fee applies once per order regardless of how many lines it governs, and appears as its own entry on the order summary rather than being folded into tax.","example":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"taxable":false},{"feeId":"fee_admin","name":{"en":"Admin fee"},"calculation":"PERCENT","percentage":5,"taxable":true}],"uniqueKey":"data.fees","typeLabel":"object[]"}},"required":["entityType","projectId","serviceId","businessModelId","type","paymentOptions","config","active","createdAt","updatedAt","createdBy","updatedBy"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"entityType":"SERVICE_BUSINESS_MODEL","projectId":"\u003cstring>","serviceId":"\u003cstring>","businessModelId":"\u003cstring>","type":"SINGLE_BOOKING","paymentOptions":["PAY_WHILE_BOOKING"],"config":{},"active":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","createdBy":"\u003cstring>","updatedBy":"\u003cstring>","fees":[{"feeId":"fee_booking","name":{"en":"Booking fee"},"calculation":"FLAT","amount":2500,"taxable":false},{"feeId":"fee_admin","name":{"en":"Admin fee"},"calculation":"PERCENT","percentage":5,"taxable":true}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"ca08d579-e802-451e-9440-f18f2fed1b93":{"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"},"38c48c42-3de2-4d6b-bc31-7666e6dda08e":{"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"},"ddbf457b-e076-4c83-8d40-1fc2fb355ba6":{"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"}},"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":"Add a business model to a service - MarketBox API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T15:10:27.811Z","originalFileLocation":"api-reference/servicebusinessmodels/add-a-business-model-to-a-service.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=\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\">\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=\"Add a business model to a service - MarketBox API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\">\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/servicebusinessmodels/add-a-business-model-to-a-service\">\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=ServiceBusinessModels\u0026amp;title=Add+a+business+model+to+a+service\u0026amp;description=Declares+a+way+the+service+can+be+sold%2C+and+gates+what+you+can+build+on+it+%E2%80%94+a+service+cannot+have+packages+created+against+it+until+it+carries+an+active+PACKAG\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=e8aaa1db994649ef8435af499b73acb827e6454ca6f197de20098a26bd3e3202\">\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=\"Add a business model to a service - MarketBox API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://marketboxinc.mintlify.site/_mintlify/api/og/v2?division=ServiceBusinessModels\u0026amp;title=Add+a+business+model+to+a+service\u0026amp;description=Declares+a+way+the+service+can+be+sold%2C+and+gates+what+you+can+build+on+it+%E2%80%94+a+service+cannot+have+packages+created+against+it+until+it+carries+an+active+PACKAG\u0026amp;theme=3a79fb7765978cda15c7035f\u0026amp;signature=e8aaa1db994649ef8435af499b73acb827e6454ca6f197de20098a26bd3e3202\">\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/servicebusinessmodels/add-a-business-model-to-a-service\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/servicebusinessmodels/add-a-business-model-to-a-service.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/servicebusinessmodels/add-a-business-model-to-a-service#webpage\",\"url\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service\",\"name\":\"Add a business model to a service\",\"description\":\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\",\"dateModified\":\"2026-11-19T15:10:27.811Z\",\"isPartOf\":{\"@id\":\"https://docs.gomarketbox.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service#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\":\"ServiceBusinessModels\",\"item\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/list-business-models-for-a-service\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add a business model to a service\",\"item\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service#apireference\",\"headline\":\"Add a business model to a service\",\"name\":\"Add a business model to a service\",\"description\":\"Declares a way the service can be sold, and gates what you can build on it — a service cannot have packages created against it until it carries an active PACKAGE model, so this call usually comes before the first package. The model is created active. Nothing here is deduplicated: posting the same type twice leaves two rows, both live, so list before you add. type cannot be changed afterwards, only deactivated, so pick it deliberately. paymentOptions sets when money is taken and must hold at least one option. fees are additional charges — a booking fee, an admin fee — attached to this business model and applied automatically to any order line sold under it. Each fee is charged once per order however many lines it governs, and surfaces as its own entry in the order summary rather than being folded into tax. A FLAT fee is a bare minor-unit figure that takes the currency of whatever order it lands on; use a PERCENT fee if you need it to scale.\",\"url\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomarketbox.com/api-reference/servicebusinessmodels/add-a-business-model-to-a-service#webpage\"},\"dateModified\":\"2026-11-19T15:10:27.811Z\",\"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/servicebusinessmodels/add-a-business-model-to-a-service.md","siteName":"MarketBox API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Events","pages":[{"title":"Report site events straight from the browser (publishable key, no response body)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events/beacon","href":"/api-reference/events/report-site-events-straight-from-the-browser-publishable-key-no-response-body"},{"title":"Report what your site showed: rendered searches, lists, impressions, clicks, profile views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/events","href":"/api-reference/events/report-what-your-site-showed:-rendered-searches-lists-impressions-clicks-profile-views"}]},{"group":"Supplier plane","pages":[{"title":"Whether the signed-in person may use the supplier plane, and why not","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/access","href":"/api-reference/supplier-plane/whether-the-signed-in-person-may-use-the-supplier-plane-and-why-not"},{"title":"List the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-bookings"},{"title":"One of the signed-in supplier’s bookings, with services and participants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/one-of-the-signed-in-supplier’s-bookings-with-services-and-participants"},{"title":"Move one of the signed-in supplier’s bookings to another time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}","href":"/api-reference/supplier-plane/move-one-of-the-signed-in-supplier’s-bookings-to-another-time"},{"title":"The signed-in supplier’s own attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-attendance-report-on-one-of-their-bookings"},{"title":"File the signed-in supplier’s attendance report on one of their bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/reports","href":"/api-reference/supplier-plane/file-the-signed-in-supplier’s-attendance-report-on-one-of-their-bookings"},{"title":"Cancel one of the signed-in supplier’s bookings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/bookings/{bookingId}/cancel","href":"/api-reference/supplier-plane/cancel-one-of-the-signed-in-supplier’s-bookings"},{"title":"List the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-schedules"},{"title":"Create a schedule for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules","href":"/api-reference/supplier-plane/create-a-schedule-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-schedules"},{"title":"Delete one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-schedules"},{"title":"Update one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-schedules"},{"title":"Clone one of the signed-in supplier’s schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/schedules/{scheduleId}/clone","href":"/api-reference/supplier-plane/clone-one-of-the-signed-in-supplier’s-schedules"},{"title":"Move the signed-in supplier’s schedules and blocked times to their profile zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/availability-timezone/apply-profile","href":"/api-reference/supplier-plane/move-the-signed-in-supplier’s-schedules-and-blocked-times-to-their-profile-zone"},{"title":"List the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-blocked-times"},{"title":"Create a blocked time for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/blocked-times","href":"/api-reference/supplier-plane/create-a-blocked-time-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Delete one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"Update one of the signed-in supplier’s blocked times","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/blocked-times/{blockedTimeId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-blocked-times"},{"title":"The signed-in supplier’s Week \u0026 demand view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/demand","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-week-\u0026-demand-view"},{"title":"Dismiss one of the signed-in supplier’s demand suggestions for 90 days","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/dismiss-one-of-the-signed-in-supplier’s-demand-suggestions-for-90-days"},{"title":"Undo a dismissal: the suggestion shows again when the data still supports it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/demand/suggestions/{key}/dismiss","href":"/api-reference/supplier-plane/undo-a-dismissal:-the-suggestion-shows-again-when-the-data-still-supports-it"},{"title":"The signed-in supplier’s Search insights","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/search-insights","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-search-insights"},{"title":"The signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-own-profile"},{"title":"Update the signed-in supplier’s own profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me","href":"/api-reference/supplier-plane/update-the-signed-in-supplier’s-own-profile"},{"title":"Get a presigned URL to upload the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/avatar/upload-url","href":"/api-reference/supplier-plane/get-a-presigned-url-to-upload-the-signed-in-supplier’s-photo"},{"title":"Attach the uploaded photo to the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/attach-the-uploaded-photo-to-the-signed-in-supplier"},{"title":"Remove the signed-in supplier’s photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/avatar","href":"/api-reference/supplier-plane/remove-the-signed-in-supplier’s-photo"},{"title":"List the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-travel-zones"},{"title":"Create a travel zone for the signed-in supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/travel-zones","href":"/api-reference/supplier-plane/create-a-travel-zone-for-the-signed-in-supplier"},{"title":"Get one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/get-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Delete one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/delete-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"Update one of the signed-in supplier’s travel zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}","href":"/api-reference/supplier-plane/update-one-of-the-signed-in-supplier’s-travel-zones"},{"title":"List the venues the signed-in supplier may be scheduled at","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/locations","href":"/api-reference/supplier-plane/list-the-venues-the-signed-in-supplier-may-be-scheduled-at"},{"title":"List the signed-in supplier’s alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts","href":"/api-reference/supplier-plane/list-the-signed-in-supplier’s-alerts"},{"title":"The signed-in supplier’s unread count and open conditions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/me/alerts/summary","href":"/api-reference/supplier-plane/the-signed-in-supplier’s-unread-count-and-open-conditions"},{"title":"Mark all of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/read-all","href":"/api-reference/supplier-plane/mark-all-of-the-signed-in-supplier’s-alerts-read"},{"title":"Mark one of the signed-in supplier’s alerts read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/me/alerts/{alertId}/read","href":"/api-reference/supplier-plane/mark-one-of-the-signed-in-supplier’s-alerts-read"}]},{"group":"Bookings","pages":[{"title":"List bookings for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-project"},{"title":"Create a new booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings","href":"/api-reference/bookings/create-a-new-booking"},{"title":"Get a booking by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/get-a-booking-by-id"},{"title":"Soft-delete a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/soft-delete-a-booking"},{"title":"Reschedule or update a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}","href":"/api-reference/bookings/reschedule-or-update-a-booking"},{"title":"Get a booking with its services, participants, notes, reports and party names","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/aggregate","href":"/api-reference/bookings/get-a-booking-with-its-services-participants-notes-reports-and-party-names"},{"title":"Change a booking status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/status","href":"/api-reference/bookings/change-a-booking-status"},{"title":"List bookings for a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-supplier"},{"title":"List bookings for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/bookings","href":"/api-reference/bookings/list-bookings-for-a-client"},{"title":"List participants on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/list-participants-on-a-booking"},{"title":"Register a participant on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants","href":"/api-reference/bookings/register-a-participant-on-a-booking"},{"title":"Get a single booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/get-a-single-booking-participant"},{"title":"Cancel a booking participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}","href":"/api-reference/bookings/cancel-a-booking-participant"},{"title":"Check in a participant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/participants/{clientId}/check-in","href":"/api-reference/bookings/check-in-a-participant"},{"title":"List booking notes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/list-booking-notes"},{"title":"Create a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/notes","href":"/api-reference/bookings/create-a-booking-note"},{"title":"Delete a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/delete-a-booking-note"},{"title":"Update a booking note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/bookings/{bookingId}/notes/{noteId}","href":"/api-reference/bookings/update-a-booking-note"},{"title":"List the reports filed on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/list-the-reports-filed-on-a-booking"},{"title":"File one side's report on a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reports","href":"/api-reference/bookings/file-one-sides-report-on-a-booking"}]},{"group":"Reviews","pages":[{"title":"List every review linked to a booking","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/list-every-review-linked-to-a-booking"},{"title":"Review a booking, in either direction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/bookings/{bookingId}/reviews","href":"/api-reference/reviews/review-a-booking-in-either-direction"},{"title":"List reviews for a project (newest first); filter by supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/list-reviews-for-a-project-newest-first;-filter-by-supplier"},{"title":"Create a supplier review (1–5 star rating with optional comment)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/reviews","href":"/api-reference/reviews/create-a-supplier-review-1–5-star-rating-with-optional-comment"},{"title":"List the reviews written about a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/reviews","href":"/api-reference/reviews/list-the-reviews-written-about-a-client"},{"title":"Get a client's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/review-summary","href":"/api-reference/reviews/get-a-clients-average-rating-and-review-count"},{"title":"Get a supplier's average rating and review count","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}/review-summary","href":"/api-reference/reviews/get-a-suppliers-average-rating-and-review-count"}]},{"group":"Orders","pages":[{"title":"List orders by status, by payment method, or every order in a date range","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders","href":"/api-reference/orders/list-orders-by-status-by-payment-method-or-every-order-in-a-date-range"},{"title":"Create a new order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders","href":"/api-reference/orders/create-a-new-order"},{"title":"Get an order by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/get-an-order-by-id"},{"title":"Soft-delete an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/soft-delete-an-order"},{"title":"Update an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}","href":"/api-reference/orders/update-an-order"},{"title":"Get an order with its items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/aggregate","href":"/api-reference/orders/get-an-order-with-its-items"},{"title":"List orders for a client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/clients/{clientId}/orders","href":"/api-reference/orders/list-orders-for-a-client"},{"title":"Change order status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/status","href":"/api-reference/orders/change-order-status"},{"title":"Add an item to an order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/items","href":"/api-reference/orders/add-an-item-to-an-order"},{"title":"Remove an order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/remove-an-order-item"},{"title":"Update an order item quantity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/projects/{projectId}/orders/{orderId}/items/{orderItemId}","href":"/api-reference/orders/update-an-order-item-quantity"},{"title":"List the bookings created for a PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/list-the-bookings-created-for-a-package-order-item"},{"title":"Create N package sessions atomically (or best-effort) from one PACKAGE order item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/orders/{orderId}/package-bookings","href":"/api-reference/orders/create-n-package-sessions-atomically-or-best-effort-from-one-package-order-item"}]},{"group":"Suppliers","pages":[{"title":"List suppliers for a project, enriched with services and skills; filter by service/skill/region/point","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/list-suppliers-for-a-project-enriched-with-services-and-skills;-filter-by-serviceskillregionpoint"},{"title":"Create a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers","href":"/api-reference/suppliers/create-a-supplier"},{"title":"One supplier in full: profile, services, skills, locations, rating and working hours","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/one-supplier-in-full:-profile-services-skills-locations-rating-and-working-hours"},{"title":"Update a supplier; sync its service/skill mappings when arrays are supplied","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/update-a-supplier;-sync-its-serviceskill-mappings-when-arrays-are-supplied"},{"title":"Soft-delete a supplier (cascade-removes its mappings and avatar)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}","href":"/api-reference/suppliers/soft-delete-a-supplier-cascade-removes-its-mappings-and-avatar"},{"title":"Add a service to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/add-a-service-to-a-supplier"},{"title":"Remove a service from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/services/{serviceId}","href":"/api-reference/suppliers/remove-a-service-from-a-supplier"},{"title":"Add a skill to a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/add-a-skill-to-a-supplier"},{"title":"Remove a skill from a supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}","href":"/api-reference/suppliers/remove-a-skill-from-a-supplier"},{"title":"Get a presigned URL to upload a supplier avatar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{projectId}/suppliers/{supplierId}/avatar/upload-url","href":"/api-reference/suppliers/get-a-presigned-url-to-upload-a-supplier-avatar"},{"title":"Confirm an uploaded avatar and attach it to the supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/projects/{projectId}/suppliers/{supplierId}/avatar","href":"/api-reference/suppliers/confirm-an-uploaded-avatar-and-attach-it-to-the-supplier"},{"title":"Remove a supplier's avatar","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","description":"How this service may be sold, and on what payment terms. Check here first when a package create returns 400: creating packages requires an entry with `type: \"PACKAGE\"` and `active: true`, and this is the only way to see whether the service has one. Inactive models are returned too — read `active`, do not assume presence means enabled. Not paginated; `nextCursor` is always null.","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","description":"Edits `paymentOptions`, `fees`, and `config` only. `type` is fixed at creation and there is no way to change it — to switch a service from one selling model to another, deactivate this one and add the model you want. All three fields are whole-value replacements: sending `paymentOptions` discards the previous list rather than merging into it, and sending `config` replaces the whole object. Omit a field entirely to leave it untouched. Sending `fees` likewise replaces the entire list: omit the field to leave configured fees untouched, send `[]` to clear them. An unknown `businessModelId` is a 404, and nothing is written.","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":"Add a business model to a service - 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"]}