{
"error": "No Entity found",
"code": "NOT_FOUND"
}
{
"error": "Buyer already has an active Facility",
"code": "CONFLICT"
}
{
"error": "Facility could not be created",
"code": "RISK_DECISION_ERROR"
}
Credit Facilities
Request a credit facility
Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.
{
"error": "No Entity found",
"code": "NOT_FOUND"
}
{
"error": "Buyer already has an active Facility",
"code": "CONFLICT"
}
{
"error": "Facility could not be created",
"code": "RISK_DECISION_ERROR"
}
A credit facility is the credit line that enables a buyer to pay on deferred terms through your platform. Requesting one triggers Tilta’s automated underwriting engine, which evaluates the buyer’s creditworthiness using third-party credit bureau data alongside the business information stored in the buyer record. A buyer can hold only one active credit facility at a time. The underwriting result is returned synchronously where possible; a 202 response means the decision is still pending and arrives via webhook.
Webhook events
When underwriting cannot complete synchronously, Tilta delivers the result via webhook. Subscribe to the following events in your webhook configuration:
Event
Description
FACILITY.CREATION.ACCEPTED
The credit facility was approved and is ready to use.
FACILITY.CREATION.REJECTED
The credit facility request was rejected.
FACILITY.CREATION.IN_REVIEW
Underwriting requires additional review and is not yet complete.
To request a credit facility, the buyer must have completed the Tilta onboarding flow. If they have not, create a buyer
Onboarding Session first.
Each buyer can hold only one active credit facility at a time. Requesting a new facility for a buyer who already has one
returns a 409 Conflict. To raise an existing limit, use Request Increase
instead.
Authorizations
Authorization
string
header
required
Your Tilta API key, sent as Bearer <key>.
Headers
async_execution
enum<string>
Indicates if the operation should be performed asynchronously.
Available options:
true,
false
Path Parameters
external_id
string
required
Unique identifier of a buyer.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
Body
application/json
requested_amount
integer | null
Requested amount. As minimum currency unit (e.g cents/pence).
Required range: x >= 1
is_existing_buyer
boolean | null
Indicates that the platform has at least two closed orders with this buyer.
requested_currency
enum<string>
Available options:
EUR,
GBP,
USD,
CHF,
PLN,
CZK,
RON,
BGN,
DKK,
HUF,
SEK,
NOK,
JPY,
AUD,
NZD,
CAD
Response
A credit facility has been successfully created for a buyer.
buyer_external_id
string
required
Unique identifier for buyer.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
Example:
"5f6374a46a5e8e0104aa5cd4"
pending_orders_amount
integer
required
Blocked by pending deferred orders portion of the Credit Limit. As minimum currency unit (e.g cents/pence).
Example:
2500
risk_band
enum<string>
required
Available options:
REJECT,
A1,
A2,
B1,
B2,
C1,
C2,
D1,
D2
created_at
number
required
Timestamp indicating when the facility was created (unix time in seconds).
Example:
1582896122
updated_at
number
required
Timestamp indicating the last time the facility was updated (unix time in seconds).
Example:
1582896122
pending_actions
object[] | null
required
List of pending actions for the facility.
Show child attributes
status
enum<string>
required
Status of the Active facility
Available options:
ACTIVE,
PENDING,
FROZEN,
EXPIRED
Example:
"ACTIVE"
reviewed_at
number | null
required
Review Date of the Active facility
currency
enum<string>
required
ISO 4217 three-letter currency code.
Available options:
EUR,
GBP,
USD,
CHF,
PLN,
CZK,
RON,
BGN,
DKK,
HUF,
SEK,
NOK,
JPY,
AUD,
NZD,
CAD
total_amount
integer
required
Total credit limit available to the Buyer. As minimum currency unit (e.g cents/pence).
Example:
10000
available_amount
integer
required
Available portion of the Credit Limit. As minimum currency unit (e.g cents/pence).
Example:
5200
used_amount
integer
required
Credit Limit portion currently in use (not repaid). As minimum currency unit (e.g cents/pence).
Example:
4800
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tilta","colors":{"primary":"#7563E4","light":"#8A7AFE","dark":"#7563E4"},"logo":{"light":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_positive_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=2d77f76ffd19a7569d9f4281c2c7d985","dark":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_negative_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=9750c80c39f37d607fc7cc0f9ded89ff"},"favicon":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/favicon.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=d3419a3989bf69708050d87b411d8540","api":{"openapi":"api-reference/openapi.yml","playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["bash","javascript","python","php"]}},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#101019"}},"navbar":{"primary":{"type":"button","label":"Book a Demo","href":"https://www.tilta.ai/book-a-demo"}},"footer":{"socials":{"github":"https://github.com/tilta-io","linkedin":"https://www.linkedin.com/company/tilta","website":"https://tilta.ai/"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"integrations":{"gtm":{"tagId":"GTM-KGGKX2BZ"}},"contextual":{"options":["copy","view","download-spec","mcp","cursor","claude"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tilta","hasAudioNarration":false,"actualSubdomain":"tilta","customDomains":["docs.tilta.ai"],"gitSource":{"type":"github","owner":"tilta-io","repo":"tilta-backend","deployBranch":"docs-release","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afeebaf42e7ae4824d4e79d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":69},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"Merchants","count":17},{"language":"default","tag":"Invoices","count":10},{"language":"default","tag":"Buyers","count":9},{"language":"default","tag":"Orders","count":8},{"language":"default","tag":"Platform \u0026 Utilities","count":8},{"language":"default","tag":"Contacts \u0026 Persons","count":7},{"language":"default","tag":"Platform \u0026 Reference","count":6},{"language":"default","tag":"Integration","count":6}]},"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[{"filePath":"brand.css","content":":root{--background-light: 255 255 255;--background-dark: 16 16 25;--gray-50: 250 250 251;--gray-100: 243 243 245;--gray-200: 230 230 233;--gray-300: 211 212 217;--gray-400: 139 139 146;--gray-500: 114 114 121;--gray-600: 93 93 100;--gray-700: 71 71 79;--gray-800: 50 50 58;--gray-900: 32 31 40;--gray-950: 16 16 25}.prose{--tw-prose-links: #7563e4}.prose a.link{color:#7563e4}html.dark .prose{--tw-prose-links: #8a7afe;color:#d3d4d9}html.dark .prose a.link{color:#8a7afe}html.dark #topbar-cta-button .bg-primary-dark{background-color:#8a7afe}html.dark #topbar-cta-button .text-white{color:#101019}.callout[data-callout-type=\"note\"]{background-color:#f4f4ff;border-color:#d7d7ff;color:#5e4dbe}html.dark .callout[data-callout-type=\"note\"]{background-color:#221b4b;border-color:#352a70;color:#d7d7ff}.callout[data-callout-type=\"tip\"]{background-color:#daffe0;border-color:#09e36b;color:#01813a}html.dark .callout[data-callout-type=\"tip\"]{background-color:#1a3520;border-color:#01813a;color:#30bb60}.callout[data-callout-type=\"warning\"]{background-color:#ffeee5;border-color:#ff7e21;color:#b15203}html.dark .callout[data-callout-type=\"warning\"]{background-color:#422616;border-color:#b15203;color:#e58042}.callout[data-callout-type=\"info\"]{background-color:#fafafb;border-color:#e6e6e9;color:#5d5d64}html.dark .callout[data-callout-type=\"info\"]{background-color:#201f28;border-color:#32323a;color:#d3d4d9}.callout[data-callout-type] [data-component-part=\"callout-icon\"],.callout[data-callout-type] svg,.callout[data-callout-type] a{color:inherit}"}]}
{"page":{"pagePath":"api-reference/facilities/create-facility","slug":"/api-reference/facilities/create-facility","pageMetadata":{"title":"Request a credit facility","sidebarTitle":"Create facility","description":"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.","keywords":["underwriting","credit line","credit decision","webhook"],"openapi":"POST /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/create-facility"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A credit facility is the credit line that enables a buyer to pay on deferred terms through your platform. Requesting one triggers Tilta’s automated underwriting engine, which evaluates the buyer’s creditworthiness using third-party credit bureau data alongside the business information stored in the buyer record. A buyer can hold only one active credit facility at a time. The underwriting result is returned synchronously where possible; a `,_jsx(_components.code,{children:`202`}),` response means the decision is still pending and arrives via webhook.`]}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-events`,children:`Webhook events`}),`\n`,_jsx(_components.p,{children:`When underwriting cannot complete synchronously, Tilta delivers the result via webhook. Subscribe to the following events in your webhook configuration:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FACILITY.CREATION.ACCEPTED`})}),_jsx(_components.td,{children:`The credit facility was approved and is ready to use.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FACILITY.CREATION.REJECTED`})}),_jsx(_components.td,{children:`The credit facility request was rejected.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FACILITY.CREATION.IN_REVIEW`})}),_jsx(_components.td,{children:`Underwriting requires additional review and is not yet complete.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`To request a credit facility, the buyer must have completed the Tilta onboarding flow. If they have not, create a `,_jsx(_components.a,{href:`/api-reference/buyers/buyer-onboarding-session`,children:`buyer\nOnboarding Session`}),` first.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Each buyer can hold only one active credit facility at a time. Requesting a new facility for a buyer who already has one\nreturns a `,_jsx(_components.code,{children:`409 Conflict`}),`. To raise an existing limit, use `,_jsx(_components.a,{href:`/api-reference/facilities/request-increase`,children:`Request Increase`}),`\ninstead.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Request a credit facility","sidebarTitle":"Create facility","description":"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.","keywords":["underwriting","credit line","credit decision","webhook"],"openapi":"POST /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/create-facility"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Webhook events","slug":"webhook-events","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.","summary":"Create a credit facility","tags":["Credit Facilities"],"security":["2cbad061-0f5b-4754-ad6a-4c236df35bda"],"parameters":["367fbd12-7cb7-4024-8957-434f41cfbe88","fa3ce285-0182-4fb3-90e7-ffadd1698e4e"],"requestBody":"5eb768ac-f6fd-4f4f-a657-be4059bad901","responses":{"201":"d9c1eac7-b447-4174-9393-fa7c8a8aab6b","202":"973659da-aa7a-47a0-85cc-c90e451dd6d7","400":"7e808f40-5d94-4f92-946f-1694d7f17d36","401":"0d9542d9-59f0-4f73-8ea0-2b6e83a0a0bc","404":"554a22d6-e38e-46fc-bb05-cdd3d45fb2a1","409":"8d1c96a2-1b11-4829-a390-960b218d1500","424":"3821bbb2-25c6-47da-89d8-4e0bb38967ff"},"method":"post","type":"path","servers":["0d16876d-c42e-4739-9cb6-74ddf3bb3f66","a8fd5e82-bae4-4987-aed3-5d5342202f75"],"path":"/v1/buyers/{external_id}/facility","baseUrlOptions":["https://api.tilta.io","https://api.tilta-sandbox.io"],"title":"Create a credit facility","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"367fbd12-7cb7-4024-8957-434f41cfbe88":{"schema":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier of a buyer.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Unique identifier of a buyer.","name":"external_id","in":"path"},"fa3ce285-0182-4fb3-90e7-ffadd1698e4e":{"schema":{"type":"string","enum":["true","false"],"description":"Indicates if the operation should be performed asynchronously.","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"Indicates if the operation should be performed asynchronously.","name":"async_execution","in":"header"}},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"requested_amount":{"oneOf":[{"type":"integer","minimum":1,"description":"Requested amount. As minimum currency unit (e.g cents/pence).","uniqueKey":"oneOf.0.requested_amount.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Requested amount. As minimum currency unit (e.g cents/pence).","uniqueKey":"oneOf.0.requested_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.requested_amount","typeLabel":"integer | null"},"is_existing_buyer":{"oneOf":[{"type":"boolean","description":"Indicates that the platform has at least two closed orders with this buyer.","uniqueKey":"oneOf.0.is_existing_buyer.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Indicates that the platform has at least two closed orders with this buyer.","uniqueKey":"oneOf.0.is_existing_buyer.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.is_existing_buyer","typeLabel":"boolean | null"},"requested_currency":{"type":"string","enum":["EUR","GBP","USD","CHF","PLN","CZK","RON","BGN","DKK","HUF","SEK","NOK","JPY","AUD","NZD","CAD"],"uniqueKey":"oneOf.0.requested_currency","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"null","properties":{"requested_amount":{"oneOf":[{"type":"integer","minimum":1,"description":"Requested amount. As minimum currency unit (e.g cents/pence)."},{"type":"null","minimum":1,"description":"Requested amount. As minimum currency unit (e.g cents/pence)."}]},"is_existing_buyer":{"oneOf":[{"type":"boolean","description":"Indicates that the platform has at least two closed orders with this buyer."},{"type":"null","description":"Indicates that the platform has at least two closed orders with this buyer."}]},"requested_currency":{"type":"string","enum":["EUR","GBP","USD","CHF","PLN","CZK","RON","BGN","DKK","HUF","SEK","NOK","JPY","AUD","NZD","CAD"]}},"uniqueKey":"oneOf.1","typeLabel":"null"}],"uniqueKey":"","typeLabel":"object | null"},"examples":{"Example":{"title":"Example","value":{"requested_amount":2,"is_existing_buyer":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d9c1eac7-b447-4174-9393-fa7c8a8aab6b":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"buyer_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier for buyer.","example":"5f6374a46a5e8e0104aa5cd4","isRequired":true,"uniqueKey":"buyer_external_id","typeLabel":"string"},"pending_orders_amount":{"type":"integer","description":"Blocked by pending deferred orders portion of the Credit Limit. As minimum currency unit (e.g cents/pence).","example":2500,"isRequired":true,"uniqueKey":"pending_orders_amount","typeLabel":"integer"},"risk_band":{"type":"string","enum":["REJECT","A1","A2","B1","B2","C1","C2","D1","D2"],"isRequired":true,"uniqueKey":"risk_band","typeLabel":"enum\u003cstring>"},"created_at":{"type":"number","description":"Timestamp indicating when the facility was created (unix time in seconds).","example":1582896122,"isRequired":true,"uniqueKey":"created_at","typeLabel":"number"},"updated_at":{"type":"number","description":"Timestamp indicating the last time the facility was updated (unix time in seconds).","example":1582896122,"isRequired":true,"uniqueKey":"updated_at","typeLabel":"number"},"pending_actions":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CREATION","RENEWAL","INCREASE"],"description":"Type of the pending action.","isRequired":true,"uniqueKey":"pending_actions.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"created_at":{"type":"number","description":"Timestamp indicating when the pending action was created (unix time in seconds).","example":1582896122,"isRequired":true,"uniqueKey":"pending_actions.oneOf.0.items.[INDEX].created_at","typeLabel":"number"}},"required":["type","created_at"],"uniqueKey":"pending_actions.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of pending actions for the facility.","isRequired":true,"uniqueKey":"pending_actions.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"type":{"type":"string","enum":["CREATION","RENEWAL","INCREASE"],"description":"Type of the pending action."},"created_at":{"type":"number","description":"Timestamp indicating when the pending action was created (unix time in seconds).","example":1582896122}},"required":["type","created_at"]},"description":"List of pending actions for the facility.","isRequired":true,"uniqueKey":"pending_actions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"pending_actions","typeLabel":"object[] | null"},"status":{"type":"string","enum":["ACTIVE","PENDING","FROZEN","EXPIRED"],"description":"Status of the Active facility","example":"ACTIVE","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"reviewed_at":{"oneOf":[{"type":"number","description":"Review Date of the Active facility","isRequired":true,"uniqueKey":"reviewed_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"Review Date of the Active facility","isRequired":true,"uniqueKey":"reviewed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reviewed_at","typeLabel":"number | null"},"currency":{"type":"string","enum":["EUR","GBP","USD","CHF","PLN","CZK","RON","BGN","DKK","HUF","SEK","NOK","JPY","AUD","NZD","CAD"],"description":"ISO 4217 three-letter currency code.","isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"total_amount":{"type":"integer","description":"Total credit limit available to the Buyer. As minimum currency unit (e.g cents/pence).","example":10000,"isRequired":true,"uniqueKey":"total_amount","typeLabel":"integer"},"available_amount":{"type":"integer","description":"Available portion of the Credit Limit. As minimum currency unit (e.g cents/pence).","example":5200,"isRequired":true,"uniqueKey":"available_amount","typeLabel":"integer"},"used_amount":{"type":"integer","description":"Credit Limit portion currently in use (not repaid). As minimum currency unit (e.g cents/pence).","example":4800,"isRequired":true,"uniqueKey":"used_amount","typeLabel":"integer"}},"required":["buyer_external_id","pending_orders_amount","risk_band","created_at","updated_at","pending_actions","status","reviewed_at","currency","total_amount","available_amount","used_amount"],"additionalProperties":false,"description":"A credit facility has been successfully created for a buyer.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"buyer_external_id":"5f6374a46a5e8e0104aa5cd4","pending_orders_amount":2500,"risk_band":"REJECT","created_at":1582896122,"updated_at":1582896122,"pending_actions":[{"type":"CREATION","created_at":1582896122}],"status":"ACTIVE","reviewed_at":123,"currency":"EUR","total_amount":10000,"available_amount":5200,"used_amount":4800}}},"exampleType":"generated"}},"exampleType":"generated"},"973659da-aa7a-47a0-85cc-c90e451dd6d7":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"buyer_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier for buyer.","example":"5f6374a46a5e8e0104aa5cd4","isRequired":true,"uniqueKey":"buyer_external_id","typeLabel":"string"},"status":{"type":"string","enum":["PENDING"],"description":"Status of the Pending facility","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["buyer_external_id","status"],"description":"The creation of a credit facility is pending.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"buyer_external_id":"5f6374a46a5e8e0104aa5cd4","status":"PENDING"}}},"exampleType":"generated"}},"exampleType":"generated"},"7e808f40-5d94-4f92-946f-1694d7f17d36":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"Error message for debugging purposes","example":"Request validation failed. 1 issue found.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Issue code","example":"INVALID_TYPE","isRequired":true,"uniqueKey":"issues.items.[INDEX].code","typeLabel":"string"},"path":{"type":"string","description":"Issue path starting with body, params, querystring, or headers","example":"body.registered_at","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"Issue message for debugging purposes","example":"Invalid type","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["code","path","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"List of issues","example":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}],"isRequired":true,"uniqueKey":"issues","typeLabel":"object[]"}},"required":["code","error","issues"],"description":"Bad Request, see error message for details.","example":{"code":"BAD_REQUEST","error":"Request validation failed. 1 issue found.","issues":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"BAD_REQUEST","error":"Request validation failed. 1 issue found.","issues":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0d9542d9-59f0-4f73-8ea0-2b6e83a0a0bc":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error details.","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code.","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"description":"Unauthorized Request.","example":{"error":"Unauthorized","code":"UNAUTHORIZED"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized","code":"UNAUTHORIZED"}}},"exampleType":"generated"}},"exampleType":"generated"},"554a22d6-e38e-46fc-bb05-cdd3d45fb2a1":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error details.","example":"No Entity found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"description":"Buyer not found","example":{"error":"No Entity found","code":"NOT_FOUND"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"No Entity found","code":"NOT_FOUND"}}},"exampleType":"generated"}},"exampleType":"generated"},"8d1c96a2-1b11-4829-a390-960b218d1500":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error details.","example":"Buyer already has an active Facility","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code.","example":"CONFLICT","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"description":"Buyer already has an active Facility","example":{"error":"Buyer already has an active Facility","code":"CONFLICT"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Buyer already has an active Facility","code":"CONFLICT"}}},"exampleType":"generated"}},"exampleType":"generated"},"3821bbb2-25c6-47da-89d8-4e0bb38967ff":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error details.","example":"Facility could not be created","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code.","example":"RISK_DECISION_ERROR","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"description":"Could not create facility due to buyer risk","example":{"error":"Facility could not be created","code":"RISK_DECISION_ERROR"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Facility could not be created","code":"RISK_DECISION_ERROR"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2cbad061-0f5b-4754-ad6a-4c236df35bda":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0d16876d-c42e-4739-9cb6-74ddf3bb3f66":{"url":"https://api.tilta.io","description":"Tilta Production API"},"a8fd5e82-bae4-4987-aed3-5d5342202f75":{"url":"https://api.tilta-sandbox.io","description":"Tilta Sandbox API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yml"},"subdomain":"tilta","siteName":"Tilta","title":"Request a credit facility - Tilta","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T14:20:15.391Z","originalFileLocation":"api-reference/facilities/create-facility.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=\"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tilta\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Request a credit facility - Tilta\">\u003cmeta data-mint-head property=\"og:description\" content=\"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tilta\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tilta.ai/api-reference/facilities/create-facility\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tilta.mintlify.site/_mintlify/api/og/v2?division=Credit+Facilities\u0026amp;title=Request+a+credit+facility\u0026amp;description=Trigger+Tilta+automated+underwriting+to+request+a+credit+facility+for+a+buyer.+Approval+is+based+on+credit+bureau+data+and+delivered+via+webhook+event.\u0026amp;theme=f3f102f26ce2dce4c4ff02d0\u0026amp;signature=804c1076a8fb47166747452dde940b4ad5c4300aaf2feab87206a0e640aba9b9\">\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=\"Request a credit facility - Tilta\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tilta.mintlify.site/_mintlify/api/og/v2?division=Credit+Facilities\u0026amp;title=Request+a+credit+facility\u0026amp;description=Trigger+Tilta+automated+underwriting+to+request+a+credit+facility+for+a+buyer.+Approval+is+based+on+credit+bureau+data+and+delivered+via+webhook+event.\u0026amp;theme=f3f102f26ce2dce4c4ff02d0\u0026amp;signature=804c1076a8fb47166747452dde940b4ad5c4300aaf2feab87206a0e640aba9b9\">\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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tilta\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7563E4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tilta.ai/api-reference/facilities/create-facility\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/facilities/create-facility.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tilta.ai/#organization\",\"name\":\"Tilta\",\"url\":\"https://docs.tilta.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_positive_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=2d77f76ffd19a7569d9f4281c2c7d985\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tilta.ai#website\",\"name\":\"Tilta\",\"url\":\"https://docs.tilta.ai\",\"publisher\":{\"@id\":\"https://docs.tilta.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tilta.ai/api-reference/facilities/create-facility#webpage\",\"url\":\"https://docs.tilta.ai/api-reference/facilities/create-facility\",\"name\":\"Request a credit facility\",\"description\":\"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\",\"dateModified\":\"2026-11-17T14:20:15.391Z\",\"isPartOf\":{\"@id\":\"https://docs.tilta.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tilta.ai/api-reference/facilities/create-facility#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tilta.ai/api-reference/facilities/create-facility#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tilta\",\"item\":\"https://docs.tilta.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Request a credit facility\",\"item\":\"https://docs.tilta.ai/api-reference/facilities/create-facility\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tilta.ai/api-reference/facilities/create-facility#apireference\",\"headline\":\"Request a credit facility\",\"name\":\"Request a credit facility\",\"description\":\"Trigger Tilta automated underwriting to request a credit facility for a buyer. Approval is based on credit bureau data and delivered via webhook event.\",\"url\":\"https://docs.tilta.ai/api-reference/facilities/create-facility\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tilta.ai/api-reference/facilities/create-facility#webpage\"},\"dateModified\":\"2026-11-17T14:20:15.391Z\",\"keywords\":\"underwriting, credit line, credit decision, webhook\",\"publisher\":{\"@id\":\"https://docs.tilta.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tilta.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tilta\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tilta\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/facilities/create-facility.md","siteName":"Tilta","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"tab":"API Reference","groups":[{"group":"Buyers","pages":[{"title":"Create a buyer","sidebarTitle":"Create buyer","openapi":"POST /v1/buyers","href":"/api-reference/buyers/create-buyer"},{"title":"Retrieve a buyer","sidebarTitle":"Retrieve buyer","openapi":"GET /v1/buyers/{external_id}","href":"/api-reference/buyers/retrieve-buyer"},{"title":"List buyers","sidebarTitle":"List buyers","openapi":"GET /v1/buyers","href":"/api-reference/buyers/list-buyers"},{"title":"Search buyers","sidebarTitle":"Search buyers","openapi":"GET /v1/buyers/search","href":"/api-reference/buyers/search-buyers"},{"title":"Replace a buyer","sidebarTitle":"Replace buyer","openapi":"PUT /v1/buyers/{external_id}","href":"/api-reference/buyers/replace-buyer"},{"title":"Export buyers","sidebarTitle":"Export buyers","openapi":"GET /v1/buyers/export/csv","href":"/api-reference/buyers/export-buyers"},{"title":"Retrieve buyer settings","sidebarTitle":"Retrieve buyer settings","openapi":"GET /v1/buyers/{external_id}/settings","href":"/api-reference/buyers/retrieve-buyer-settings"},{"title":"Replace buyer settings","sidebarTitle":"Replace buyer settings","openapi":"PUT /v1/buyers/{external_id}/settings","href":"/api-reference/buyers/replace-buyer-settings"},{"title":"Create an onboarding session","sidebarTitle":"Onboarding session","description":"Generate a short-lived onboarding session for a buyer. Returns a JWT and hosted URL to launch Tilta white-labeled credit application flow for the buyer.","openapi":"POST /v1/buyers/{external_id}/sessions/onboarding","href":"/api-reference/buyers/buyer-onboarding-session"}]},{"group":"Credit Facilities","pages":[{"title":"Request a credit facility","sidebarTitle":"Create facility","openapi":"POST /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/create-facility"},{"title":"Retrieve a credit facility","sidebarTitle":"Retrieve facility","description":"Fetch the active credit facility for a buyer, including total credit limit, available balance, current usage amount, currency, and expiration date.","openapi":"GET /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/retrieve-facility"},{"title":"List credit facilities","sidebarTitle":"List facilities","openapi":"GET /v1/facilities","href":"/api-reference/facilities/list-facilities"},{"title":"Request a facility increase","sidebarTitle":"Request increase","openapi":"POST /v1/buyers/{external_id}/facility/increase","href":"/api-reference/facilities/request-increase"},{"title":"Request a facility renewal","sidebarTitle":"Request renewal","openapi":"POST /v1/buyers/{external_id}/facility/renew","href":"/api-reference/facilities/request-renewal"}]},{"group":"Orders","pages":[{"title":"Create an order","sidebarTitle":"Create order","openapi":"POST /v1/orders","href":"/api-reference/orders/create-order"},{"title":"Create a draft order","sidebarTitle":"Create draft order","openapi":"POST /v1/orders/draft","href":"/api-reference/orders/create-draft-order"},{"title":"Retrieve an order","sidebarTitle":"Retrieve order","openapi":"GET /v1/orders/{external_id}","href":"/api-reference/orders/retrieve-order"},{"title":"List orders","sidebarTitle":"List orders","openapi":"GET /v1/orders","href":"/api-reference/orders/list-orders"},{"title":"Search orders","sidebarTitle":"Search orders","openapi":"GET /v1/orders/search","href":"/api-reference/orders/search-orders"},{"title":"Replace an order","sidebarTitle":"Replace order","openapi":"PUT /v1/orders/{external_id}","href":"/api-reference/orders/replace-order"},{"title":"Transition an order","sidebarTitle":"Transition order","openapi":"POST /v1/orders/{external_id}/transition","href":"/api-reference/orders/transition-order"},{"title":"Create a checkout session","sidebarTitle":"Checkout session","openapi":"POST /v1/orders/{external_id}/sessions/checkout","href":"/api-reference/orders/checkout-session"}]},{"group":"Invoices","pages":[{"title":"Create an invoice","sidebarTitle":"Create invoice","openapi":"POST /v1/invoices","href":"/api-reference/invoices/create-invoice"},{"title":"Retrieve an invoice","sidebarTitle":"Retrieve invoice","openapi":"GET /v1/invoices/{external_id}","href":"/api-reference/invoices/retrieve-invoice"},{"title":"List invoices","sidebarTitle":"List invoices","openapi":"GET /v1/invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Search invoices","sidebarTitle":"Search invoices","openapi":"GET /v1/invoices/search","href":"/api-reference/invoices/search-invoices"},{"title":"Update an invoice","sidebarTitle":"Update invoice","openapi":"PUT /v1/invoices/{external_id}","href":"/api-reference/invoices/update-invoice"},{"title":"Mark an invoice as paid","sidebarTitle":"Mark paid","openapi":"POST /v1/invoices/{external_id}/paid","href":"/api-reference/invoices/mark-paid"},{"title":"Refund an invoice","sidebarTitle":"Refund invoice","openapi":"POST /v1/invoices/{external_id}/refund","href":"/api-reference/invoices/refund-invoice"},{"title":"Calculate fees","sidebarTitle":"Calculate fees","openapi":"POST /v1/invoices/calculate_fees","href":"/api-reference/invoices/calculate-fees"},{"title":"Upload an invoice file","sidebarTitle":"Upload file","openapi":"POST /v1/invoices/{external_id}/files","href":"/api-reference/invoices/upload-file"},{"title":"Export invoices","sidebarTitle":"Export CSV","openapi":"GET /v1/invoices/export/csv","href":"/api-reference/invoices/export-invoices"}]},{"group":"Merchants","pages":[{"title":"Create a merchant","sidebarTitle":"Create merchant","openapi":"POST /v1/merchants","href":"/api-reference/merchants/create-merchant"},{"title":"Retrieve a merchant","sidebarTitle":"Retrieve merchant","openapi":"GET /v1/merchants/{external_id}","href":"/api-reference/merchants/retrieve-merchant"},{"title":"List merchants","sidebarTitle":"List merchants","openapi":"GET /v1/merchants","href":"/api-reference/merchants/list-merchants"},{"title":"Replace a merchant","sidebarTitle":"Replace merchant","openapi":"PUT /v1/merchants/{external_id}","href":"/api-reference/merchants/replace-merchant"},{"title":"List representatives","sidebarTitle":"List representatives","openapi":"GET /v1/merchants/{external_id}/representatives","href":"/api-reference/merchants/list-representatives"},{"title":"Add a representative","sidebarTitle":"Add representative","openapi":"POST /v1/merchants/{external_id}/representatives","href":"/api-reference/merchants/add-representative"},{"title":"Remove a representative","sidebarTitle":"Remove representative","openapi":"DELETE /v1/merchants/{external_id}/representatives/{person_external_id}","href":"/api-reference/merchants/remove-representative"},{"title":"List owners","sidebarTitle":"List owners","openapi":"GET /v1/merchants/{external_id}/owners","href":"/api-reference/merchants/list-owners"},{"title":"Add an owner","sidebarTitle":"Add owner","openapi":"POST /v1/merchants/{external_id}/owners","href":"/api-reference/merchants/add-owner"},{"title":"Remove an owner","sidebarTitle":"Remove owner","openapi":"DELETE /v1/merchants/{external_id}/owners/{person_external_id}","href":"/api-reference/merchants/remove-owner"},{"title":"List payout instructions","sidebarTitle":"List payout instructions","openapi":"GET /v1/payout_instructions","href":"/api-reference/merchants/list-payout-instructions"},{"title":"Create a payout instruction","sidebarTitle":"Create payout instruction","openapi":"POST /v1/payout_instructions","href":"/api-reference/merchants/create-payout-instruction"},{"title":"Retrieve a payout instruction","sidebarTitle":"Retrieve payout instruction","openapi":"GET /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/retrieve-payout-instruction"},{"title":"Replace a payout instruction","sidebarTitle":"Replace payout instruction","openapi":"PUT /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/replace-payout-instruction"},{"title":"Delete a payout instruction","sidebarTitle":"Delete payout instruction","openapi":"DELETE /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/delete-payout-instruction"},{"title":"List mandates","sidebarTitle":"List mandates","openapi":"GET /v1/merchants/{external_id}/mandates","href":"/api-reference/merchants/list-mandates"},{"title":"Create a mandate","sidebarTitle":"Create mandate","openapi":"POST /v1/merchants/{external_id}/mandates","href":"/api-reference/merchants/create-mandate"}]},{"group":"Contacts \u0026 Persons","pages":[{"title":"Create a contact","sidebarTitle":"Create contact","openapi":"POST /v1/contacts","href":"/api-reference/contacts/create-contact"},{"title":"Retrieve a contact","sidebarTitle":"Retrieve contact","openapi":"GET /v1/contacts/{external_id}","href":"/api-reference/contacts/retrieve-contact"},{"title":"Replace a contact","sidebarTitle":"Replace contact","openapi":"PUT /v1/contacts/{external_id}","href":"/api-reference/contacts/replace-contact"},{"title":"Delete a contact","sidebarTitle":"Delete contact","openapi":"DELETE /v1/contacts/{external_id}","href":"/api-reference/contacts/delete-contact"},{"title":"Create a person","sidebarTitle":"Create person","openapi":"POST /v1/persons","href":"/api-reference/persons/create-person"},{"title":"Retrieve a person","sidebarTitle":"Retrieve person","openapi":"GET /v1/persons/{external_id}","href":"/api-reference/persons/retrieve-person"},{"title":"Replace a person","sidebarTitle":"Replace person","openapi":"PUT /v1/persons/{external_id}","href":"/api-reference/persons/replace-person"}]},{"group":"Webhooks","pages":[{"title":"Create a subscription","sidebarTitle":"Create subscription","openapi":"POST /v1/webhooks","href":"/api-reference/webhooks/create-subscription"},{"title":"List subscriptions","sidebarTitle":"List subscriptions","openapi":"GET /v1/webhooks","href":"/api-reference/webhooks/list-subscriptions"},{"title":"Replace a subscription","sidebarTitle":"Replace subscription","openapi":"PUT /v1/webhooks/{type}","href":"/api-reference/webhooks/replace-subscription"},{"title":"Delete a subscription","sidebarTitle":"Delete subscription","openapi":"POST /v1/webhooks/{type}/unsubscribe","href":"/api-reference/webhooks/delete-subscription"},{"title":"Rotate the signature key","sidebarTitle":"Rotate signature key","openapi":"POST /v1/webhooks/{type}/signature_key","href":"/api-reference/webhooks/rotate-signature-key"}]},{"group":"Platform \u0026 Utilities","pages":[{"title":"Retrieve the platform","sidebarTitle":"Retrieve platform","openapi":"GET /v1/platform","href":"/api-reference/platform/retrieve-platform"},{"title":"Retrieve payment terms","sidebarTitle":"Payment terms","openapi":"GET /v1/platform/payment_terms","href":"/api-reference/platform/payment-terms"},{"title":"Search businesses","sidebarTitle":"Search businesses","openapi":"GET /v1/businesses/search","href":"/api-reference/utilities/search-businesses"},{"title":"List legal forms","sidebarTitle":"Legal forms","openapi":"GET /v1/legal_forms","href":"/api-reference/utilities/legal-forms"},{"title":"Check service requirements","sidebarTitle":"Service requirements","openapi":"GET /v1/invoices/{external_id}/services/{service_type}/requirements","href":"/api-reference/utilities/invoice-service-requirements"},{"title":"Request a service","sidebarTitle":"Request service","openapi":"POST /v1/services","href":"/api-reference/utilities/create-invoice-service"},{"title":"Retrieve a service","sidebarTitle":"Retrieve service","openapi":"GET /v1/services/{external_id}","href":"/api-reference/utilities/retrieve-invoice-service"},{"title":"List services","sidebarTitle":"List services","openapi":"GET /v1/invoices/{external_id}/services","href":"/api-reference/utilities/list-invoice-services"}]}]}]},"basePath":"","title":"Request a credit facility - Tilta","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"]}