Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.
Aggregate mode — set is_aggregated: true and provide a reference to group all transfers under a single aggregate transaction on the account. Instead of N individual debit lines, your members see one consolidated entry. The aggregate status updates automatically as child transfers settle.This operation requires Strong Customer Authentication, except when all transfers include a beneficiary_id and all beneficiaries are trusted, in which case SCA is not required.
However, if at least one transfer passes the beneficiary object then SCA will be triggered.
You can either provide a beneficiary_id for a known beneficiary or beneficiary data which will create an untrusted beneficiary on the fly.Note:
if a beneficiary with the same IBAN already exists, the provided details (such as name) will be updated;
this endpoint is not trusting the beneficiary - you can trust a beneficiary through the Qonto app (for more details, please refer to this article) or through this endpoint (available for the Automate your business operations and Embed use cases).
Business rules and validations are applied to each individual transfer after the BulkTransfer is created. For instance, transfers above 30,000 EUR require at least one attachment. This validation is performed asynchronously, meaning the BulkTransfer will be created, but if the attachment is missing, the result for that transfer will contain an error.By default, transfers will be processed as instant. If instant processing isn’t possible, it will automatically fall back to standard processing. It will be the case if the amount of the individual transfer is above the following thresholds 👇
Untrusted beneficiary
The individual transfer is above 5,000 EUR;
More than 20,000 EUR have been sent to this beneficairy within 24 hours.
Trusted beneficiary
The individual transfer is above 10,000 EUR;
More than 50,000 EUR have been sent to this beneficairy within 24 hours.
To learn more about instant transfers, please read this article.
Authorizations
Authorization
string
header
required
Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Scopes
payment.write
Create external transfers and untrust beneficiaries
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Body
application/json
vop_proof_token
string
required
Proof token from a bulk payee verification attempt. Use the token from bulk verify payee to opt-out from the verification.
Example:
"proof_1234567890abcdef"
bank_account_id
string<uuid>
required
The ID of the bank account from which the amount will be debited from.
bulk_transfers
object[]
required
List of SEPA transfers to process (up to 400).
Maximum array length: 400
Show child attributes
is_aggregated
boolean
default:false
When true, all transfers in the batch appear as a single aggregate transaction on the account
instead of N individual debit lines. The aggregate status updates automatically as child transfers settle.
Requires reference to be set.
reference
string
Label for the aggregate transaction shown on the account (e.g. "October payroll").
Required when is_aggregated is true. Ignored when is_aggregated is false.
Maximum string length: 255
Example:
"October payroll"
Response
Successfully creates a BulkTransfer for processing
bulk_transfer
object
required
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Qonto","colors":{"primary":"#0E0E0E","light":"#B0B0B0","dark":"#0E0E0E"},"logo":{"light":"https://mintcdn.com/qonto-6237c309/Op_emyzb5FlZ5x50/logo/qonto-developers-light.svg?fit=max\u0026auto=format\u0026n=Op_emyzb5FlZ5x50\u0026q=85\u0026s=a8ce932eeec004b77efe8c0f611c5c5d","dark":"https://mintcdn.com/qonto-6237c309/Op_emyzb5FlZ5x50/logo/qonto-developers-dark.svg?fit=max\u0026auto=format\u0026n=Op_emyzb5FlZ5x50\u0026q=85\u0026s=bae39034af9c6d95a7e2e1a84a3857af","href":"https://docs.qonto.com/"},"favicon":"https://mintcdn.com/qonto-6237c309/IZJ5MTjzXpp-Ln1p/favicon.png?fit=max\u0026auto=format\u0026n=IZJ5MTjzXpp-Ln1p\u0026q=85\u0026s=557b33e6df403e1a96ae4b380aa212aa","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","prefill":true}},"appearance":{"default":"light"},"background":{"color":{"dark":"#1d1d1b"}},"navbar":{"links":[{"href":"https://qonto.com/en/integrations?#search","label":"Integrations"}],"primary":{"type":"button","label":"Developer Portal","href":"https://developers.qonto.com/sign-in/"}},"footer":{"socials":{"x":"https://x.com/getqonto","linkedin":"https://www.linkedin.com/company/qonto","instagram":"https://www.instagram.com/qonto","facebook":"https://www.facebook.com/getqonto"}},"seo":{"metatags":{"application-name":"Qonto APIs","description":"Qonto provides 2 collections of REST APIs and a Sandbox environment to help you build integrations on top of Qonto accounts, transactions, memberships, etc; no matter what your use case is.","keywords":"qonto api, qonto api reference, qonto api doc"},"indexing":"all"},"fonts":{"heading":{"family":"PolySans","source":"https://mintlify-assets.b-cdn.net/fonts/polysans-neutral-b855437b9905fe21c922ad25ed73abdfe6a7a8f2445c6e418f7f41d6d95c061f.woff2","format":"woff2"},"body":{"family":"PolySans","source":"https://mintlify-assets.b-cdn.net/fonts/polysans-neutral-b855437b9905fe21c922ad25ed73abdfe6a7a8f2445c6e418f7f41d6d95c061f.woff2","format":"woff2"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qonto-6237c309","hasAudioNarration":false,"actualSubdomain":"qonto-6237c309","customDomains":["docs.qonto.com"],"gitSource":{"type":"github","owner":"qonto-private","repo":"public-doc","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5a315c24142980e5aa3d9","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API","count":243},{"language":"default","tag":"Business API","count":221},{"language":"default","tag":"Partnerships","count":85},{"language":"default","tag":"Embed Qonto in your product","count":78},{"language":"default","tag":"Embed TypeScript SDK","count":61},{"language":"default","tag":"MCP","count":54},{"language":"default","tag":"Invoicing","count":53},{"language":"default","tag":"Guides","count":36},{"language":"default","tag":"Resources","count":34},{"language":"default","tag":"CLI","count":34}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"td code{overflow-wrap:normal}"}],"page":{"pagePath":"api-reference/business-api/transfers/bulk-transfers/create","slug":"/api-reference/business-api/transfers/bulk-transfers/create","pageMetadata":{"openapi":"POST /v2/sepa/bulk_transfers","description":"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via `GET v2/sepa/bulk_transfers/:id`.","title":"Create a Bulk Transfer","href":"/api-reference/business-api/transfers/bulk-transfers/create"},"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: [\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via \", _jsx(_components.code, {\n children: \"GET v2/sepa/bulk_transfers/:id\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Badge,Note,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Badge)_missingMdxReference(`Badge`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Authentication:`}),` `,_jsx(Badge,{color:`gray`,size:`sm`,stroke:true,icon:`xmark`,children:`API key`}),` `,_jsx(Badge,{color:`green`,size:`sm`,icon:`check`,children:`OAuth 2.0`}),_jsx(`br`,{}),`\n`,_jsx(_components.strong,{children:`Scope:`}),` `,_jsx(_components.a,{href:`/api-reference/business-api/introduction/authentication/scopes#payment-write`,children:_jsx(_components.code,{children:`payment.write`})}),` `,_jsx(Badge,{color:`red`,size:`sm`,icon:`lock`,children:`Sensitive`})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Related guides:`}),` `,_jsx(_components.a,{href:`/guides/payments/verification-of-payee`,children:`Verification of Payee`}),`, `,_jsx(_components.a,{href:`/guides/psd2/make-a-transfer`,children:`How to make a transfer with PSD2`})]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Aggregate mode`}),` — set `,_jsx(_components.code,{children:`is_aggregated: true`}),` and provide a `,_jsx(_components.code,{children:`reference`}),` to group all transfers under a single aggregate transaction on the account. Instead of N individual debit lines, your members see one consolidated entry. The aggregate status updates automatically as child transfers settle.`]}),`\n`,_jsxs(_components.p,{children:[`This operation requires `,_jsx(_components.a,{href:`/guides/authentication/sca-flows`,children:`Strong Customer Authentication`}),`, except when all transfers include a `,_jsx(_components.code,{children:`beneficiary_id`}),` and `,_jsx(_components.a,{href:`/api-reference/business-api/transfers/sepa-beneficiaries/trust`,children:`all beneficiaries are trusted`}),`, in which case `,_jsx(_components.strong,{children:`SCA is not required`}),`.\nHowever, if at least one transfer passes the `,_jsx(_components.code,{children:`beneficiary`}),` object then `,_jsx(_components.strong,{children:`SCA will be triggered`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Example of SCA usage: `,_jsx(_components.a,{href:`https://www.postman.com/qontoteam/workspace/qonto-public-api/flow/6670429eb7bd63003156bd57`,children:`Postman visual flow`})]})}),`\n`,_jsxs(_components.p,{children:[`You can either provide a `,_jsx(_components.code,{children:`beneficiary_id`}),` for a known beneficiary or `,_jsx(_components.code,{children:`beneficiary`}),` data which will create an untrusted beneficiary on the fly.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Note`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`if a beneficiary with the same IBAN already exists, the provided details (such as name) will be updated;`}),`\n`,_jsxs(_components.li,{children:[`this endpoint is not trusting the beneficiary - you can trust a beneficiary through the Qonto app (for more details, please refer to `,_jsx(_components.a,{href:`https://support-de.qonto.com/hc/en-us/articles/23949206250641-How-can-I-mark-a-payee-as-trustworthy#h_925061f25d`,children:`this article`}),`) or through `,_jsx(_components.a,{href:`/api-reference/business-api/transfers/sepa-beneficiaries/trust`,children:`this endpoint`}),` (available for the Automate your business operations and Embed use cases).`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Business rules and validations are applied to each individual transfer after the `,_jsx(_components.code,{children:`BulkTransfer`}),` is created. For instance, transfers above 30,000 EUR require at least one attachment. This validation is performed asynchronously, meaning the `,_jsx(_components.code,{children:`BulkTransfer`}),` will be created, but if the attachment is missing, the result for that transfer will contain an error.`]}),`\n`,_jsxs(_components.p,{children:[`By default, transfers will be processed as `,_jsx(_components.strong,{children:`instant`}),`. If instant processing isn’t possible, it will automatically fall back to standard processing. It will be the case if the amount of the individual transfer is above the following thresholds 👇`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Untrusted beneficiary`,id:`untrusted-beneficiary`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The individual transfer is above 5,000 EUR;`}),`\n`,_jsx(_components.li,{children:`More than 20,000 EUR have been sent to this beneficairy within 24 hours.`}),`\n`]})}),_jsx(Accordion,{title:`Trusted beneficiary`,id:`trusted-beneficiary`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The individual transfer is above 10,000 EUR;`}),`\n`,_jsx(_components.li,{children:`More than 50,000 EUR have been sent to this beneficairy within 24 hours.`}),`\n`]})})]}),`\n`,_jsxs(_components.p,{children:[`To learn more about instant transfers, please read `,_jsx(_components.a,{href:`https://support-fr.qonto.com/hc/en-us/articles/23947629441681-How-to-make-an-instant-transfer-in-euros-SEPA`,children:`this article`}),`.`]})]})}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":{"openapi":"POST /v2/sepa/bulk_transfers","description":"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via `GET v2/sepa/bulk_transfers/:id`.","title":"Create a Bulk Transfer","href":"/api-reference/business-api/transfers/bulk-transfers/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/qonto-6237c309/825d995cd157b7a6/zendesk-widget.js"],"openApiReferenceData":{"operation":{"tags":["SEPA Transfers"],"summary":"Create a Bulk Transfer","description":"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via `GET v2/sepa/bulk_transfers/:id`.","operationId":"createSepaBulkTransfers","security":["bed4e797-0694-449d-aca1-02f3c415a4af"],"parameters":["d95ade4f-41d8-446d-8507-be625ab709ad","86dfcc13-a784-4df8-a834-f3b505e088a0","00a1758a-9071-49ae-b77b-8bb04606f2f9","6f5e89aa-700c-4b9b-ac00-ee58080152c4"],"requestBody":"6e40813a-14fb-49a0-84da-43a2e3cd19e9","responses":{"200":"8e4def44-e2bd-4a8f-840b-63ec7efbb941","400":"19d3ea4c-3d85-47c2-bac3-c109b0dbd3d1","401":"09bcf7f0-c988-42d7-8738-855ca6cfcd17","403":"8d056fbf-a964-4f12-af34-2a4fbf4132a7"},"method":"post","type":"path","servers":["2a24a92e-6246-458d-92f3-fd7c59c12b92","01b1fc5a-dc2d-4cfd-ba01-daed9f0af62b"],"path":"/v2/sepa/bulk_transfers","baseUrlOptions":["https://thirdparty.qonto.com","https://thirdparty-sandbox.staging.qonto.co"],"title":"Create a Bulk Transfer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.vop_proof_token":"proof_1234567890abcdef","body.bank_account_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","body.bulk_transfers.items.0.reference":"Inventory","body.bulk_transfers.items.0.amount":"100.50","body.bulk_transfers.items.0.client_transfer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","body.bulk_transfers.items.0.beneficiary_id.oneOf.0":"3c90c3cc-0d44-4b50-8888-8dd25736052a","body.bulk_transfers.items.0.beneficiary.oneOf.0.name":"Alice In Wonderland","body.bulk_transfers.items.0.beneficiary.oneOf.0.iban":"DE91100000000123456789","body.bulk_transfers.items.0.beneficiary.oneOf.0.bic":"DEUTDEDDXXX","body.bulk_transfers.items.0.beneficiary.oneOf.0.email":"beneficiary@example.com","body.bulk_transfers.items.0.scheduled_date":"2023-12-25","body.bulk_transfers.items.0.note":"Inventory goods for restaurant in Paris","body.bulk_transfers.items.0.attachment_ids.items.0":"3c90c3cc-0d44-4b50-8888-8dd25736052a","body.is_aggregated":false,"body.reference":"October payroll"}]},"dependencies":{"parameters":{"d95ade4f-41d8-446d-8507-be625ab709ad":{"name":"X-Qonto-2fa-Preference","in":"header","description":"Learn more in [Strong Customer Authentication](/guides/authentication/sca-flows).","schema":{"type":"string","enum":["paired-device","passkey","mock","sms-otp"],"default":"paired-device","description":"Learn more in [Strong Customer Authentication](/guides/authentication/sca-flows).","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"86dfcc13-a784-4df8-a834-f3b505e088a0":{"name":"X-Qonto-Idempotency-Key","in":"header","required":true,"description":"Learn more in [Idempotent Requests](/api-reference/business-api/introduction/idempotency).","schema":{"type":"string","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"description":"Learn more in [Idempotent Requests](/api-reference/business-api/introduction/idempotency).","uniqueKey":"","typeLabel":"string"}},"00a1758a-9071-49ae-b77b-8bb04606f2f9":{"name":"X-Qonto-Sca-Session-Token","in":"header","description":"Learn more in [Strong Customer Authentication](/guides/authentication/sca-flows).","schema":{"type":"string","description":"Learn more in [Strong Customer Authentication](/guides/authentication/sca-flows).","uniqueKey":"","typeLabel":"string"}},"6f5e89aa-700c-4b9b-ac00-ee58080152c4":{"name":"X-Qonto-MFA","in":"header","description":"Learn more in the [SMS OTP Flow](/guides/authentication/sca-flows#sms-otp-flow).","schema":{"type":"string","description":"Learn more in the [SMS OTP Flow](/guides/authentication/sca-flows#sms-otp-flow).","uniqueKey":"","typeLabel":"string"}},"eea6e337-2432-4238-b409-3374be5668c6":{"name":"X-Qonto-Staging-Token","in":"header","description":"Required only for Sandbox API requests; to get one, please sign up to the [Developer Portal](https://developers.qonto.com/).","schema":{"type":"string","description":"Required only for Sandbox API requests; to get one, please sign up to the [Developer Portal](https://developers.qonto.com/).","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bank_account_id","bulk_transfers","vop_proof_token"],"properties":{"vop_proof_token":{"type":"string","description":"Proof token from a bulk payee verification attempt. Use the token from [bulk verify payee](/api-reference/business-api/transfers/verification-of-payee/bulk-verify-payee) to opt-out from the verification.","example":"proof_1234567890abcdef","isRequired":true,"uniqueKey":"vop_proof_token","typeLabel":"string"},"bank_account_id":{"type":"string","format":"uuid","description":"The ID of the bank account from which the amount will be debited from.","isRequired":true,"uniqueKey":"bank_account_id","typeLabel":"string\u003cuuid>"},"bulk_transfers":{"type":"array","description":"List of SEPA transfers to process (up to 400).","maxItems":400,"items":{"type":"object","required":["amount","client_transfer_id","reference"],"properties":{"reference":{"type":"string","description":"The reference of the transfer","example":"Inventory","maxLength":140,"isRequired":true,"uniqueKey":"bulk_transfers.items.[INDEX].reference","typeLabel":"string"},"amount":{"type":"string","example":"100.50","pattern":"^\\d+(\\.\\d{1,2})?$","description":"Corresponds to the amount of the transaction in the `currency` of the bank account. Amounts must be https://www.w3.org/TR/payment-request/#dfn-valid-decimal-monetary-value.","isRequired":true,"uniqueKey":"bulk_transfers.items.[INDEX].amount","typeLabel":"string"},"client_transfer_id":{"type":"string","format":"uuid","description":"A unique identifier provided by the client to track and distinguish individual transfers within a bulk transfer creation request.","isRequired":true,"uniqueKey":"bulk_transfers.items.[INDEX].client_transfer_id","typeLabel":"string\u003cuuid>"},"beneficiary_id":{"oneOf":[{"type":"string","format":"uuid","description":"The ID of the SEPA beneficiary","uniqueKey":"bulk_transfers.items.[INDEX].beneficiary_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The ID of the SEPA beneficiary","uniqueKey":"bulk_transfers.items.[INDEX].beneficiary_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary_id","typeLabel":"string\u003cuuid> | null"},"beneficiary":{"oneOf":[{"type":"object","required":["name","iban"],"properties":{"name":{"type":"string","description":"The name of the beneficiary","example":"Alice In Wonderland","isRequired":true,"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.name","typeLabel":"string"},"iban":{"type":"string","description":"The IBAN of the beneficiary","example":"DE91100000000123456789","isRequired":true,"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.iban","typeLabel":"string"},"bic":{"type":"string","description":"The BIC of the beneficiary","example":"DEUTDEDDXXX","uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.bic","typeLabel":"string"},"email":{"type":"string","description":"The email of the beneficiary","example":"beneficiary@example.com","uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.email","typeLabel":"string"},"activity_tag":{"oneOf":[{"type":"string","enum":["atm","fallback","fees","finance","food_and_grocery","gas_station","hardware_and_equipment","hotel_and_lodging","insurance","it_and_electronics","legal_and_accounting","logistics","manufacturing","marketing","office_rental","office_supply","online_service","other_expense","other_income","other_service","pending","refund","restaurant_and_bar","sales","salary","subscription","tax","transport","treasury_and_interco","utility","voucher"],"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.activity_tag.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["atm","fallback","fees","finance","food_and_grocery","gas_station","hardware_and_equipment","hotel_and_lodging","insurance","it_and_electronics","legal_and_accounting","logistics","manufacturing","marketing","office_rental","office_supply","online_service","other_expense","other_income","other_service","pending","refund","restaurant_and_bar","sales","salary","subscription","tax","transport","treasury_and_interco","utility","voucher"],"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.activity_tag.oneOf.1","typeLabel":"null"}],"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0.activity_tag","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.0","typeLabel":"object"},{"type":"null","required":["name","iban"],"properties":{"name":{"type":"string","description":"The name of the beneficiary","example":"Alice In Wonderland"},"iban":{"type":"string","description":"The IBAN of the beneficiary","example":"DE91100000000123456789"},"bic":{"type":"string","description":"The BIC of the beneficiary","example":"DEUTDEDDXXX"},"email":{"type":"string","description":"The email of the beneficiary","example":"beneficiary@example.com"},"activity_tag":{"oneOf":[{"type":"string","enum":["atm","fallback","fees","finance","food_and_grocery","gas_station","hardware_and_equipment","hotel_and_lodging","insurance","it_and_electronics","legal_and_accounting","logistics","manufacturing","marketing","office_rental","office_supply","online_service","other_expense","other_income","other_service","pending","refund","restaurant_and_bar","sales","salary","subscription","tax","transport","treasury_and_interco","utility","voucher"]},{"type":"null","enum":["atm","fallback","fees","finance","food_and_grocery","gas_station","hardware_and_equipment","hotel_and_lodging","insurance","it_and_electronics","legal_and_accounting","logistics","manufacturing","marketing","office_rental","office_supply","online_service","other_expense","other_income","other_service","pending","refund","restaurant_and_bar","sales","salary","subscription","tax","transport","treasury_and_interco","utility","voucher"]}]}},"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary.oneOf.1","typeLabel":"null"}],"uniqueKey":"bulk_transfers.items.[INDEX].beneficiary","typeLabel":"object | null"},"scheduled_date":{"type":"string","format":"date","description":"The date for the transfer to be executed in YYYY-MM-DD format.\nIf not provided, the transfer will be executed the same day or the next available date.","uniqueKey":"bulk_transfers.items.[INDEX].scheduled_date","typeLabel":"string\u003cdate>"},"note":{"type":"string","description":"A note for the transfer","example":"Inventory goods for restaurant in Paris","uniqueKey":"bulk_transfers.items.[INDEX].note","typeLabel":"string"},"attachment_ids":{"type":"array","description":"You can link up to 5 attachments per transfer by passing the `attachment_ids` parameter. You can upload your attachments using our [POST /v2/attachments](/api-reference/business-api/transactions-statements/attachments/upload-an-attachment) endpoint. \u003cbr>**Note: For SEPA transfers above 30,000 EUR at least one attachment is required**","items":{"type":"string","format":"uuid","uniqueKey":"bulk_transfers.items.[INDEX].attachment_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"bulk_transfers.items.[INDEX].attachment_ids","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"bulk_transfers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"bulk_transfers","typeLabel":"object[]"},"is_aggregated":{"type":"boolean","default":false,"description":"When `true`, all transfers in the batch appear as a single aggregate transaction on the account\ninstead of N individual debit lines. The aggregate status updates automatically as child transfers settle.\nRequires `reference` to be set.\n","uniqueKey":"is_aggregated","typeLabel":"boolean"},"reference":{"type":"string","maxLength":255,"description":"Label for the aggregate transaction shown on the account (e.g. `\"October payroll\"`).\nRequired when `is_aggregated` is `true`. Ignored when `is_aggregated` is `false`.\n","example":"October payroll","uniqueKey":"reference","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"vop_proof_token":"proof_1234567890abcdef","bank_account_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","bulk_transfers":[{"reference":"Inventory","amount":"100.50","client_transfer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","beneficiary_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","beneficiary":{"name":"Alice In Wonderland","iban":"DE91100000000123456789","bic":"DEUTDEDDXXX","email":"beneficiary@example.com"},"scheduled_date":"2023-12-25","note":"Inventory goods for restaurant in Paris","attachment_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}],"is_aggregated":false,"reference":"October payroll"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8e4def44-e2bd-4a8f-840b-63ec7efbb941":{"description":"Successfully creates a BulkTransfer for processing","content":{"application/json":{"schema":{"type":"object","required":["bulk_transfer"],"properties":{"bulk_transfer":{"type":"object","required":["id","initiator_id","created_at","updated_at","total_count","completed_count","pending_count","failed_count","results"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the bulk transfer job.","isRequired":true,"uniqueKey":"bulk_transfer.id","typeLabel":"string\u003cuuid>"},"initiator_id":{"type":"string","format":"uuid","description":"Unique identifier for the member that created the BulkTransfer.","isRequired":true,"uniqueKey":"bulk_transfer.initiator_id","typeLabel":"string\u003cuuid>"},"created_at":{"type":"string","format":"date-time","example":"2025-04-22T12:00:00Z","description":"UTC, the time at which the bulk transfer was first recorded.","isRequired":true,"uniqueKey":"bulk_transfer.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2025-04-22T12:00:00Z","description":"UTC, the time at which the bulk transfer was last updated.","isRequired":true,"uniqueKey":"bulk_transfer.updated_at","typeLabel":"string\u003cdate-time>"},"total_count":{"type":"integer","description":"Total number of transfers in the job.","example":400,"isRequired":true,"uniqueKey":"bulk_transfer.total_count","typeLabel":"integer"},"completed_count":{"type":"integer","description":"Total number of transfers successfully completed in the job.","example":200,"isRequired":true,"uniqueKey":"bulk_transfer.completed_count","typeLabel":"integer"},"failed_count":{"type":"integer","description":"Total number of transfers failed in the job.","example":150,"isRequired":true,"uniqueKey":"bulk_transfer.failed_count","typeLabel":"integer"},"pending_count":{"type":"integer","description":"Total number of transfers pending in the job.","example":50,"isRequired":true,"uniqueKey":"bulk_transfer.pending_count","typeLabel":"integer"},"results":{"type":"array","description":"Detailed status of each individual transfer in the job.","items":{"type":"object","required":["client_transfer_id","transfer_id","errors","status"],"properties":{"client_transfer_id":{"type":"string","format":"uuid","description":"Client-provided key to identify the transfer within the job.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].client_transfer_id","typeLabel":"string\u003cuuid>"},"transfer_id":{"oneOf":[{"type":"string","format":"uuid","description":"ID of the created transfer (populated if the status=completed).","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].transfer_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"ID of the created transfer (populated if the status=completed).","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].transfer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].transfer_id","typeLabel":"string\u003cuuid> | null"},"errors":{"oneOf":[{"type":"array","description":"List of errors for the transfer (populated if the status=failed).","items":{"type":"object","title":"Errors","properties":{"errors":{"type":"array","items":{"oneOf":[{"type":"object","required":["code","detail"],"x-examples":{"Invalid credentials":{"code":"unauthorized","detail":"Invalid credentials"}},"properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.0.code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.0.detail","typeLabel":"string"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["code","detail"],"x-examples":{"Authorization field missing":{"code":"bad_request","detail":"Authorization field missing"}},"properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1.code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1.detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","description":"The property in the request body that caused the error (optional).","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1.source.pointer","typeLabel":"string"},"parameter":{"type":"string","description":"The query parameter that caused the error (optional).","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1.source.parameter","typeLabel":"string"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1.source","typeLabel":"object"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["code","detail"],"x-examples":{"Insufficient permissions":{"code":"forbidden","detail":"User does not have sufficient permissions for this action."}},"properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.2.code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.2.detail","typeLabel":"string"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["code","detail"],"x-examples":{"Object not found":{"code":"not_found","detail":"Object not found","source":{"parameter":"id"}}},"properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.3.code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.3.detail","typeLabel":"string"},"source":{"type":"object","properties":{"parameter":{"type":"string","description":"The parameter that causes the error.","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.3.source.parameter","typeLabel":"string"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.3.source","typeLabel":"object"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["code","detail"],"properties":{"code":{"type":"string","description":"Error code.","example":"missing_key","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","example":"property is missing","isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.detail","typeLabel":"string"},"status":{"type":"string","example":"unprocessable entity","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.status","typeLabel":"string"},"message":{"type":"string","example":"property id is missing","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.message","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","description":"The property and the item in an array (if applicable) that causes the error.","example":"id","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.source.pointer","typeLabel":"string"},"parameter":{"type":"string","description":"The query parameter that caused the error (optional).","uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.source.parameter","typeLabel":"string"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4.source","typeLabel":"object"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX].oneOf.4","typeLabel":"object"}],"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX].errors","typeLabel":"object[]"}},"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0.items.[INDEX]","typeLabel":"Errors · object"},"isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","description":"List of errors for the transfer (populated if the status=failed).","items":{"type":"object","title":"Errors","properties":{"errors":{"type":"array","items":{"oneOf":[{"type":"object","required":["code","detail"],"x-examples":{"Invalid credentials":{"code":"unauthorized","detail":"Invalid credentials"}},"properties":{"code":{"type":"string","description":"Error code."},"detail":{"type":"string","description":"Human readable error that explains error `code`."}}},{"type":"object","required":["code","detail"],"x-examples":{"Authorization field missing":{"code":"bad_request","detail":"Authorization field missing"}},"properties":{"code":{"type":"string","description":"Error code."},"detail":{"type":"string","description":"Human readable error that explains error `code`."},"source":{"type":"object","properties":{"pointer":{"type":"string","description":"The property in the request body that caused the error (optional)."},"parameter":{"type":"string","description":"The query parameter that caused the error (optional)."}}}}},{"type":"object","required":["code","detail"],"x-examples":{"Insufficient permissions":{"code":"forbidden","detail":"User does not have sufficient permissions for this action."}},"properties":{"code":{"type":"string","description":"Error code."},"detail":{"type":"string","description":"Human readable error that explains error `code`."}}},{"type":"object","required":["code","detail"],"x-examples":{"Object not found":{"code":"not_found","detail":"Object not found","source":{"parameter":"id"}}},"properties":{"code":{"type":"string","description":"Error code."},"detail":{"type":"string","description":"Human readable error that explains error `code`."},"source":{"type":"object","properties":{"parameter":{"type":"string","description":"The parameter that causes the error."}}}}},{"type":"object","required":["code","detail"],"properties":{"status":{"type":"string","example":"unprocessable entity"},"code":{"type":"string","description":"Error code.","example":"missing_key"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","example":"property is missing"},"message":{"type":"string","example":"property id is missing"},"source":{"type":"object","properties":{"pointer":{"type":"string","description":"The property and the item in an array (if applicable) that causes the error.","example":"id"},"parameter":{"type":"string","description":"The query parameter that caused the error (optional)."}}}}}]}}}},"isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].errors","typeLabel":"Errors · object[] | null"},"status":{"type":"string","enum":["pending","completed","failed"],"isRequired":true,"uniqueKey":"bulk_transfer.results.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"bulk_transfer.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"bulk_transfer.results","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"bulk_transfer","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"bulk_transfer":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","initiator_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2025-04-22T12:00:00Z","updated_at":"2025-04-22T12:00:00Z","total_count":400,"completed_count":200,"failed_count":150,"pending_count":50,"results":[{"client_transfer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","transfer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","errors":[{"errors":[{"code":"\u003cstring>","detail":"\u003cstring>"}]}],"status":"pending"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"19d3ea4c-3d85-47c2-bac3-c109b0dbd3d1":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","description":"The property in the request body that caused the error (optional).","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"type":"string","description":"The query parameter that caused the error (optional).","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"}},"required":["code","detail"],"x-examples":{"Authorization field missing":{"code":"bad_request","detail":"Authorization field missing"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"reference is missing":{"title":"reference is missing","value":{"errors":[{"code":"missing_key","detail":"reference is missing","source":{"pointer":"/bulk_transfers/2/reference"}}]}},"amount is missing":{"title":"amount is missing","value":{"errors":[{"code":"missing_key","detail":"amount is missing","source":{"pointer":"/bulk_transfers/1/amount"}}]}},"with invalid amount":{"title":"with invalid amount","value":{"errors":[{"code":"invalid","detail":"amount must be greater than 0","source":{"pointer":"/bulk_transfers/4/amount"}}]}},"attachment_ids exceeds max limit":{"title":"attachment_ids exceeds max limit","value":{"errors":[{"code":"above_max_size","detail":"attachment_ids cannot be greater than 5","source":{"pointer":"/bulk_transfers/0/attachment_ids"}}]}},"with unknown beneficiary":{"title":"with unknown beneficiary","value":{"errors":[{"code":"beneficiary_not_found","detail":"Beneficiary with id=66b7e300-0126-4905-9688-27b445a48c4e not found","source":{"pointer":"/bulk_transfers/20/beneficiary_id"}}]}},"with unknown bank account":{"title":"with unknown bank account","value":{"errors":[{"code":"bank_account_not_found","detail":"BankAccount with id=420e13ac-9d3e-4c11-93a1-0c3c8304f2df not found","source":{"pointer":"/bank_account_id"}}]}},"invalid vop proof token":{"title":"invalid vop proof token","value":{"errors":[{"code":"vop_proof_token_invalid","detail":"VOP proof token is invalid"}]}},"payment policy approval required":{"title":"payment policy approval required","value":{"errors":[{"code":"payment_policy_approval_required","detail":"Approval required by payment policy"}]}},"payment policy approver missing":{"title":"payment policy approver missing","value":{"errors":[{"code":"payment_policy_approver_missing","detail":"No approver available for payment policy"}]}},"reference required for aggregated bulk":{"title":"reference required for aggregated bulk","value":{"errors":[{"code":"reference_required","detail":"reference is required for aggregated bulk transfers","source":{"pointer":"/reference"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"09bcf7f0-c988-42d7-8738-855ca6cfcd17":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"required":["code","detail"],"x-examples":{"Invalid credentials":{"code":"unauthorized","detail":"Invalid credentials"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing vop proof token":{"title":"missing vop proof token","value":{"errors":[{"code":"vop_proof_token_missing","detail":"VOP proof token is required"}]}},"authorization_header_missing":{"title":"authorization_header_missing","value":{"errors":[{"code":"authorization_header_missing","detail":"authorization header missing"}]}},"authorization_token_invalid":{"title":"authorization_token_invalid","value":{"errors":[{"code":"authorization_token_invalid","detail":"authorization token invalid"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"8d056fbf-a964-4f12-af34-2a4fbf4132a7":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Error code.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","description":"Human readable error that explains error `code`.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"required":["code","detail"],"x-examples":{"Insufficient permissions":{"code":"forbidden","detail":"User does not have sufficient permissions for this action."}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Insufficient permissions":{"title":"Insufficient permissions","value":{"errors":[{"code":"forbidden","detail":"User does not have sufficient permissions for this action."}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"bed4e797-0694-449d-aca1-02f3c415a4af":{"OAuth":{"type":"oauth2","description":"Bearer authorization header: `Bearer \u003ctoken>`, where `\u003ctoken>` is the access token received from the authorization server at the end of the [OAuth 2.0 flow](/guides/authentication/oauth-flow).\n","x-sensitive-scopes":["organization.read","payment.write","internal_transfer.write","international_transfer.write","beneficiary.trust"],"flows":{"authorizationCode":{"refreshUrl":"https://oauth.qonto.com/oauth2/token","authorizationUrl":"https://oauth.qonto.com/oauth2/auth","scopes":{"attachment.read":"Retrieve attachments","attachment.write":"Upload attachments and remove attachments from transactions","bank_account.write":"Create, update and close bank accounts","beneficiary.trust":"Trust SEPA beneficiaries","card.read":"Retrieve cards","card.write":"Create or update cards","cash_flow_category.read":"Retrieve cash flow categories","cash_flow_category.write":"Create, update and delete cash flow categories, and assign them to transactions","client.read":"Retrieve clients","client.write":"Create clients","client_invoice.write":"Create client invoices","client_invoices.read":"Retrieve client invoices and credit notes","einvoicing.read":"Retrieve e-invoicing settings","embed_auth_link.write":"Create Embed auth links","insurance_contract.read":"Retrieve insurance contracts","insurance_contract.write":"Create and update insurance contracts","internal_transfer.write":"Create internal transfers (between 2 Qonto accounts of the same organization)","international_transfer.write":"Create international transfers","membership.read":"Retrieve the authentified membership","membership.write":"Invite team members","offline_access":"Retrieve a refresh token","organization.read":"Retrieve organization, bank accounts, transactions, transfers, beneficiaries, labels, memberships, requests \u0026 statements","payment.write":"Create external transfers and untrust beneficiaries","payment_link.read":"Retrieve payment links, their payments, and the available payment methods","payment_link.write":"Connect to the payment links provider, create and deactivate payment links","product.read":"Retrieve products","product.write":"Create products","request_cards.write":"Create card requests","request_review.write":"Approve or decline requests","request_transfers.write":"Create transfer requests","sepa_direct_debit.read":"View SEPA Direct Debit payments","sepa_direct_debit.write":"Manage SEPA Direct Debit payments","subscription.read":"Retrieve the organization's current subscription plan","supplier_invoice.read":"Retrieve supplier invoices","supplier_invoice.write":"Create supplier invoices","team.read":"Retrieve teams","team.write":"Create teams","terminal.read":"View your payment terminals","terminal.write":"Configure your terminals and initiate payments","user_organization.read":"View the organizations the user has granted access to","webhook":"Receive a notification each time a particular event occurs in Qonto"},"tokenUrl":"https://oauth.qonto.com/oauth2/token"}},"scopes":["payment.write"],"schemeName":"OAuth"}}},"servers":{"2a24a92e-6246-458d-92f3-fd7c59c12b92":{"url":"https://thirdparty.qonto.com","description":"Production URL"},"01b1fc5a-dc2d-4cfd-ba01-daed9f0af62b":{"url":"https://thirdparty-sandbox.staging.qonto.co","description":"Sandbox URL"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"Bearer authorization header: `Bearer \u003ctoken>`, where `\u003ctoken>` is the access token received from the authorization server at the end of the [OAuth 2.0 flow](/guides/authentication/oauth-flow).\n","x-sensitive-scopes":["organization.read","payment.write","internal_transfer.write","international_transfer.write","beneficiary.trust"],"flows":{"authorizationCode":{"refreshUrl":"https://oauth.qonto.com/oauth2/token","authorizationUrl":"https://oauth.qonto.com/oauth2/auth","scopes":{"attachment.read":"Retrieve attachments","attachment.write":"Upload attachments and remove attachments from transactions","bank_account.write":"Create, update and close bank accounts","beneficiary.trust":"Trust SEPA beneficiaries","card.read":"Retrieve cards","card.write":"Create or update cards","cash_flow_category.read":"Retrieve cash flow categories","cash_flow_category.write":"Create, update and delete cash flow categories, and assign them to transactions","client.read":"Retrieve clients","client.write":"Create clients","client_invoice.write":"Create client invoices","client_invoices.read":"Retrieve client invoices and credit notes","einvoicing.read":"Retrieve e-invoicing settings","embed_auth_link.write":"Create Embed auth links","insurance_contract.read":"Retrieve insurance contracts","insurance_contract.write":"Create and update insurance contracts","internal_transfer.write":"Create internal transfers (between 2 Qonto accounts of the same organization)","international_transfer.write":"Create international transfers","membership.read":"Retrieve the authentified membership","membership.write":"Invite team members","offline_access":"Retrieve a refresh token","organization.read":"Retrieve organization, bank accounts, transactions, transfers, beneficiaries, labels, memberships, requests \u0026 statements","payment.write":"Create external transfers and untrust beneficiaries","payment_link.read":"Retrieve payment links, their payments, and the available payment methods","payment_link.write":"Connect to the payment links provider, create and deactivate payment links","product.read":"Retrieve products","product.write":"Create products","request_cards.write":"Create card requests","request_review.write":"Approve or decline requests","request_transfers.write":"Create transfer requests","sepa_direct_debit.read":"View SEPA Direct Debit payments","sepa_direct_debit.write":"Manage SEPA Direct Debit payments","subscription.read":"Retrieve the organization's current subscription plan","supplier_invoice.read":"Retrieve supplier invoices","supplier_invoice.write":"Create supplier invoices","team.read":"Retrieve teams","team.write":"Create teams","terminal.read":"View your payment terminals","terminal.write":"Configure your terminals and initiate payments","user_organization.read":"View the organizations the user has granted access to","webhook":"Receive a notification each time a particular event occurs in Qonto"},"tokenUrl":"https://oauth.qonto.com/oauth2/token"}},"scopes":["payment.write"],"schemeName":"OAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Bearer authorization header: `Bearer \u003ctoken>`, where `\u003ctoken>` is the access token received from the authorization server at the end of the [OAuth 2.0 flow](/guides/authentication/oauth-flow).\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth","name":"Authorization"}],"title":"OAuth"}]},"originalFileLocation":"api-reference/business-api/openapi.yml"},"subdomain":"qonto-6237c309","siteName":"Qonto","title":"Create a Bulk Transfer - Qonto","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T11:36:16.959Z","originalFileLocation":"api-reference/business-api/transfers/bulk-transfers/create.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=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.\">\u003cmeta data-mint-head name=\"keywords\" content=\"qonto api, qonto api reference, qonto api doc\">\u003cmeta data-mint-head name=\"application-name\" content=\"Qonto\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_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/qonto-6237c309/-JBBMXOClYmTjqns/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Bulk Transfer - Qonto\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Qonto\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qonto-6237c309.mintlify.site/_mintlify/api/og/v2?division=Bulk+transfers\u0026amp;title=Create+a+Bulk+Transfer\u0026amp;description=Creates+a+batch+of+SEPA+transfers+for+asynchronous+processing.+If+the+payload+is+valid%2C+the+job+is+created+and+returned%2C+which+can+be+polled+via+%60GET+v2%2Fsepa%2Fbu\u0026amp;theme=de8daa248a116ea6c770b0a2\u0026amp;signature=e0278ccb2c076e5555385aa1915520a7441d3c69e214e5d02bb495a0244caa00\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a Bulk Transfer - Qonto\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qonto-6237c309.mintlify.site/_mintlify/api/og/v2?division=Bulk+transfers\u0026amp;title=Create+a+Bulk+Transfer\u0026amp;description=Creates+a+batch+of+SEPA+transfers+for+asynchronous+processing.+If+the+payload+is+valid%2C+the+job+is+created+and+returned%2C+which+can+be+polled+via+%60GET+v2%2Fsepa%2Fbu\u0026amp;theme=de8daa248a116ea6c770b0a2\u0026amp;signature=e0278ccb2c076e5555385aa1915520a7441d3c69e214e5d02bb495a0244caa00\">\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/qonto-6237c309/-JBBMXOClYmTjqns/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Qonto\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0E0E0E\">\u003cmeta data-mint-head name=\"application-name\" content=\"Qonto APIs\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/business-api/transfers/bulk-transfers/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.qonto.com/#organization\",\"name\":\"Qonto\",\"url\":\"https://docs.qonto.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/qonto-6237c309/Op_emyzb5FlZ5x50/logo/qonto-developers-light.svg?fit=max\u0026auto=format\u0026n=Op_emyzb5FlZ5x50\u0026q=85\u0026s=a8ce932eeec004b77efe8c0f611c5c5d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.qonto.com#website\",\"name\":\"Qonto\",\"url\":\"https://docs.qonto.com\",\"publisher\":{\"@id\":\"https://docs.qonto.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create#webpage\",\"url\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create\",\"name\":\"Create a Bulk Transfer\",\"description\":\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.\",\"dateModified\":\"2026-11-06T11:36:16.959Z\",\"isPartOf\":{\"@id\":\"https://docs.qonto.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transfers\",\"item\":\"https://docs.qonto.com/api-reference/business-api/transfers/sepa-transfers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bulk transfers\",\"item\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a Bulk Transfer\",\"item\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create#apireference\",\"headline\":\"Create a Bulk Transfer\",\"name\":\"Create a Bulk Transfer\",\"description\":\"Creates a batch of SEPA transfers for asynchronous processing. If the payload is valid, the job is created and returned, which can be polled via GET v2/sepa/bulk_transfers/:id.\",\"url\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.qonto.com/api-reference/business-api/transfers/bulk-transfers/create#webpage\"},\"dateModified\":\"2026-11-06T11:36:16.959Z\",\"publisher\":{\"@id\":\"https://docs.qonto.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.qonto.com#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/business-api/transfers/bulk-transfers/create.md","siteName":"Qonto","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":""}]},{"tab":"Guides","icon":"book-open","menu":[{"item":"Technical guides","icon":"compass","pages":[{"title":"Technical guides","href":"/guides"}]},{"item":"Use cases","icon":"briefcase","pages":[{"title":"Use cases","href":"/guides/use-cases"}]}],"pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API","icon":"code","anchors":[{"anchor":"Business API","icon":"building-columns","groups":[{"group":"Introduction","pages":[{"title":"What is the Business API?","sidebarTitle":"What is this API?","href":"/api-reference/business-api/introduction/overview"},{"title":"Base URLs \u0026 environments","href":"/api-reference/business-api/introduction/base-urls"},{"group":"Authentication","pages":[{"title":"Available authentication methods","sidebarTitle":"Available methods","href":"/api-reference/business-api/introduction/authentication/methods"},{"title":"Scopes \u0026 endpoint access","sidebarTitle":"Scopes \u0026 endpoint access","mode":"wide","href":"/api-reference/business-api/introduction/authentication/scopes"}]},{"title":"Versioning","href":"/api-reference/business-api/introduction/versioning"},{"title":"Pagination","href":"/api-reference/business-api/introduction/pagination"},{"title":"Errors","href":"/api-reference/business-api/introduction/errors"},{"title":"Idempotency","href":"/api-reference/business-api/introduction/idempotency"},{"title":"Rate limits","href":"/api-reference/business-api/introduction/rate-limits"}]},{"group":"Authentication","pages":[{"group":"OAuth 2.0","pages":[{"openapi":"get /oauth2/auth","playground":"none","title":"Retrieve an authorization code","href":"/api-reference/business-api/authentication/oauth2/retrieve_authorization"},{"openapi":"post /oauth2/token","title":"Create or refresh tokens","href":"/api-reference/business-api/authentication/oauth2/create_tokens"},{"openapi":"delete /v2/oauth2/consents","title":"Revoke consents","href":"/api-reference/business-api/authentication/oauth2/revoke-oauth-consents"}]},{"group":"SCA sessions","pages":[{"openapi":"get /v2/sca_sessions/{sca-session-token}","title":"Retrieve SCA session","href":"/api-reference/business-api/authentication/sca/retrieve-session"},{"openapi":"get /v2/mocked_sca_sessions/{sca-session-token}","title":"Retrieve mocked SCA session","href":"/api-reference/business-api/authentication/sca/retrieve-mocked-session"},{"openapi":"post /v2/mocked_sca_sessions/{sca-session-token}/{decision}","title":"Simulate user decision","href":"/api-reference/business-api/authentication/sca/simulate-user-decision"}]}]},{"group":"Organization \u0026 accounts","pages":[{"group":"Organizations","pages":[{"openapi":"get /v2/organization","title":"Retrieve the authenticated organization and list bank accounts","href":"/api-reference/business-api/organization-accounts/organizations/retrieve-the-authenticated-organization-and-list-bank-accounts"},{"title":"Get user organizations","openapi":"get /v2/user_organizations","href":"/api-reference/business-api/organization-accounts/organizations/get-user-organizations"},{"title":"Show organization (v2 · deprecated)","openapi":"get /v2/organizations/{slug}","href":"/api-reference/business-api/organization-accounts/organizations/show-organization"},{"title":"Show organization (v1 · deprecated)","openapi":"get /v1/organizations/{slug}","href":"/api-reference/business-api/organization-accounts/organizations/show-organization-v1"}]},{"group":"Business accounts","pages":[{"openapi":"get /v2/bank_accounts","title":"List business accounts","href":"/api-reference/business-api/organization-accounts/business-accounts/list"},{"openapi":"get /v2/bank_accounts/{id}","title":"Get a business account","href":"/api-reference/business-api/organization-accounts/business-accounts/show"},{"openapi":"post /v2/bank_accounts/{id}/close","title":"Close a business account","href":"/api-reference/business-api/organization-accounts/business-accounts/close"},{"openapi":"post /v2/bank_accounts","title":"Create a business account","href":"/api-reference/business-api/organization-accounts/business-accounts/create"},{"openapi":"patch /v2/bank_accounts/{id}","title":"Update a business account","href":"/api-reference/business-api/organization-accounts/business-accounts/update"},{"openapi":"get /v2/bank_accounts/{id}/iban_certificate","title":"Download the IBAN certificate","href":"/api-reference/business-api/organization-accounts/business-accounts/download-iban-certificate"}]},{"group":"Memberships","pages":[{"openapi":"get /v2/memberships","title":"List memberships","href":"/api-reference/business-api/organization-accounts/memberships/list-memberships"},{"openapi":"get /v2/membership","title":"Retrieve the authenticated membership","href":"/api-reference/business-api/organization-accounts/memberships/retrieve-the-authenticated-membership"},{"openapi":"post /v2/memberships/invite_employee_or_accountant","title":"Create a membership","href":"/api-reference/business-api/organization-accounts/memberships/create-a-membership"}]},{"group":"Teams","pages":[{"openapi":"get /v2/teams","title":"List teams","href":"/api-reference/business-api/organization-accounts/teams/list-teams"},{"openapi":"post /v2/teams","title":"Create a team","href":"/api-reference/business-api/organization-accounts/teams/create-a-team"},{"openapi":"patch /v2/teams/{id}","title":"Update a team","href":"/api-reference/business-api/organization-accounts/teams/update-a-team"}]},{"group":"Labels","pages":[{"openapi":"get /v2/labels","title":"List labels","href":"/api-reference/business-api/organization-accounts/labels/list-labels"},{"openapi":"get /v2/labels/{id}","title":"Retrieve a label","href":"/api-reference/business-api/organization-accounts/labels/retrieve-a-label"}]},{"group":"Subscription","pages":[{"openapi":"get /v2/subscription","title":"Retrieve the organization's current subscription plan","href":"/api-reference/business-api/organization-accounts/subscription/get-subscription"}]}]},{"group":"Transactions \u0026 statements","pages":[{"group":"Transactions","pages":[{"openapi":"get /v2/transactions","title":"List transactions","href":"/api-reference/business-api/transactions-statements/transactions/list-transactions"},{"openapi":"get /v2/transactions/{id}","title":"Retrieve a transaction","href":"/api-reference/business-api/transactions-statements/transactions/retrieve-a-transaction"},{"openapi":"get /v2/transactions/{id}/child_transaction_links","title":"List child transaction links","href":"/api-reference/business-api/transactions-statements/transactions/list-child-transaction-links"}]},{"group":"Statements","pages":[{"openapi":"get /v2/statements","title":"List statements","href":"/api-reference/business-api/transactions-statements/statements/list-statements"},{"openapi":"get /v2/statements/{id}","title":"Retrieve a statement","href":"/api-reference/business-api/transactions-statements/statements/retrieve-a-statement"}]},{"group":"Attachments","pages":[{"openapi":"get /v2/attachments/{id}","title":"Retrieve an attachment","href":"/api-reference/business-api/transactions-statements/attachments/retrieve-an-attachment"},{"openapi":"post /v2/attachments","title":"Upload an attachment","href":"/api-reference/business-api/transactions-statements/attachments/upload-an-attachment"}]},{"group":"Attachments in transactions","pages":[{"openapi":"get /v2/transactions/{id}/attachments","title":"List attachments for a transaction","href":"/api-reference/business-api/transactions-statements/attachments-in-transactions/list-attachments-for-a-transaction"},{"openapi":"post /v2/transactions/{id}/attachments","title":"Upload an attachment to a transaction","href":"/api-reference/business-api/transactions-statements/attachments-in-transactions/upload-an-attachment-to-a-transaction"},{"openapi":"delete /v2/transactions/{transaction_id}/attachments/{attachment_id}","title":"Remove an attachment from a transaction","href":"/api-reference/business-api/transactions-statements/attachments-in-transactions/remove-an-attachment-from-a-transaction"},{"openapi":"delete /v2/transactions/{id}/attachments","title":"Remove all attachments from a transaction","href":"/api-reference/business-api/transactions-statements/attachments-in-transactions/remove-all-attachments-from-a-transaction"}]}]},{"group":"Transfers","pages":[{"group":"SEPA transfers","pages":[{"openapi":"GET /v2/sepa/transfers","title":"List SEPA transfers","href":"/api-reference/business-api/transfers/sepa-transfers/index"},{"openapi":"GET /v2/sepa/transfers/{id}","title":"Get SEPA transfer","href":"/api-reference/business-api/transfers/sepa-transfers/show"},{"openapi":"POST /v2/sepa/transfers","title":"Create a SEPA transfer","href":"/api-reference/business-api/transfers/sepa-transfers/create"},{"openapi":"POST /v2/sepa/transfers/{id}/download_proof","title":"Download proof of a SEPA transfer","href":"/api-reference/business-api/transfers/sepa-transfers/download-proof"},{"openapi":"POST /v2/sepa/transfers/{id}/cancel","title":"Cancel SEPA transfer","href":"/api-reference/business-api/transfers/sepa-transfers/cancel"}]},{"group":"SEPA beneficiaries","pages":[{"openapi":"get /v2/sepa/beneficiaries","title":"List SEPA beneficiaries","href":"/api-reference/business-api/transfers/sepa-beneficiaries/index"},{"openapi":"get /v2/sepa/beneficiaries/{id}","title":"Retrieve a SEPA beneficiary","href":"/api-reference/business-api/transfers/sepa-beneficiaries/show"},{"openapi":"post /v2/sepa/beneficiaries","title":"Add a SEPA beneficiary","href":"/api-reference/business-api/transfers/sepa-beneficiaries/create"},{"openapi":"patch /v2/sepa/beneficiaries/{id}","title":"Update a SEPA beneficiary","href":"/api-reference/business-api/transfers/sepa-beneficiaries/update"},{"openapi":"delete /v2/sepa/beneficiaries/{id}","title":"Delete a SEPA beneficiary","href":"/api-reference/business-api/transfers/sepa-beneficiaries/delete"},{"openapi":"patch /v2/sepa/beneficiaries/trust","title":"Trust SEPA beneficiaries","href":"/api-reference/business-api/transfers/sepa-beneficiaries/trust"},{"openapi":"patch /v2/sepa/beneficiaries/untrust","title":"Untrust SEPA beneficiaries","href":"/api-reference/business-api/transfers/sepa-beneficiaries/untrust"}]},{"group":"Verification of Payee","pages":[{"openapi":"POST /v2/sepa/verify_payee","title":"Verify a SEPA payee","href":"/api-reference/business-api/transfers/verification-of-payee/index"},{"openapi":"POST /v2/sepa/bulk_verify_payee","title":"Bulk verify SEPA payees","href":"/api-reference/business-api/transfers/verification-of-payee/bulk-verify-payee"}]},{"group":"Bulk transfers","pages":[{"openapi":"GET /v2/sepa/bulk_transfers","title":"List Bulk Transfers","href":"/api-reference/business-api/transfers/bulk-transfers/index"},{"openapi":"GET /v2/sepa/bulk_transfers/{id}","description":"Retrieves the current status of a bulk transfer and the progress of individual transfers.","title":"Get Bulk Transfer","href":"/api-reference/business-api/transfers/bulk-transfers/show"},{"openapi":"POST /v2/sepa/bulk_transfers","title":"Create a Bulk Transfer","href":"/api-reference/business-api/transfers/bulk-transfers/create"}]},{"group":"Recurring transfers","pages":[{"openapi":"GET /v2/sepa/recurring_transfers","description":"Retrieves a list of all SEPA recurring transfers. The list is ordered by updated_at in descending order.","title":"List SEPA recurring transfers","href":"/api-reference/business-api/transfers/recurring-transfers/index"},{"openapi":"GET /v2/sepa/recurring_transfers/{id}","title":"Get SEPA recurring transfer","href":"/api-reference/business-api/transfers/recurring-transfers/show"},{"openapi":"POST /v2/sepa/recurring_transfers","title":"Create a SEPA recurring transfer","href":"/api-reference/business-api/transfers/recurring-transfers/create"},{"openapi":"POST /v2/sepa/recurring_transfers/{id}/cancel","title":"Cancel SEPA recurring transfer","href":"/api-reference/business-api/transfers/recurring-transfers/cancel"}]},{"group":"Internal transfers","pages":[{"openapi":"post /v2/internal_transfers","title":"Create an internal transfer","href":"/api-reference/business-api/transfers/internal-transfers/create-an-internal-transfer"}]},{"group":"International transfers","pages":[{"openapi":"get /v2/international/eligibility","title":"Check if the organization is eligible for international transfers","href":"/api-reference/business-api/transfers/international-transfers/check-eligibility"},{"openapi":"get /v2/international/currencies","title":"Get available currencies for international transfers","href":"/api-reference/business-api/transfers/international-transfers/list-available-currencies"},{"openapi":"post /v2/international/quotes","title":"Create a new international transfer quote","href":"/api-reference/business-api/transfers/international-transfers/create-international-quote"},{"openapi":"get /v2/international/beneficiaries","title":"List international beneficiaries","href":"/api-reference/business-api/transfers/international-transfers/list-beneficiaries-by-currency"},{"openapi":"post /v2/international/beneficiaries/requirements","title":"List requirements for an international beneficiary","href":"/api-reference/business-api/transfers/international-transfers/list-beneficiary-requirements"},{"openapi":"post /v2/international/beneficiaries","title":"Create an international beneficiary","href":"/api-reference/business-api/transfers/international-transfers/create-beneficiary"},{"openapi":"put /v2/international/beneficiaries/{id}","title":"Update an international beneficiary","href":"/api-reference/business-api/transfers/international-transfers/update-beneficiary"},{"openapi":"delete /v2/international/beneficiaries/{id}","title":"Delete an international beneficiary","href":"/api-reference/business-api/transfers/international-transfers/delete-beneficiary"},{"openapi":"post /v2/international/transfers/requirements","title":"List international transfer requirements","href":"/api-reference/business-api/transfers/international-transfers/list-transfer-requirements"},{"openapi":"post /v2/international/transfers","title":"Create an international transfer","href":"/api-reference/business-api/transfers/international-transfers/create-international-transfer"}]}]},{"group":"Getting paid","pages":[{"group":"Payment links","pages":[{"openapi":"get /v2/payment_links","title":"List payment links","href":"/api-reference/business-api/getting-paid/payment-links/index"},{"openapi":"get /v2/payment_links/{id}","title":"Get a payment link","href":"/api-reference/business-api/getting-paid/payment-links/show"},{"openapi":"post /v2/payment_links","title":"Create a payment link","href":"/api-reference/business-api/getting-paid/payment-links/create"},{"openapi":"patch /v2/payment_links/{id}/deactivate","title":"Deactivate a payment link","href":"/api-reference/business-api/getting-paid/payment-links/deactivate"},{"openapi":"get /v2/payment_links/{id}/payments","title":"List payments for a payment link","href":"/api-reference/business-api/getting-paid/payment-links/index-payments"},{"openapi":"get /v2/payment_links/payment_methods","title":"List available payment methods","href":"/api-reference/business-api/getting-paid/payment-links/index-payment-methods"},{"openapi":"post /v2/payment_links/connections","title":"Connect to the payment links provider","href":"/api-reference/business-api/getting-paid/payment-links/connect"},{"openapi":"get /v2/payment_links/connections","title":"Get the connection status","href":"/api-reference/business-api/getting-paid/payment-links/get-connection"}]},{"group":"Terminals","pages":[{"openapi":"get /v2/terminals","title":"List terminals","href":"/api-reference/business-api/getting-paid/terminals/list-terminals"},{"openapi":"post /v2/terminals/{id}/payment","title":"Create a terminal payment","href":"/api-reference/business-api/getting-paid/terminals/create-terminal-payment"},{"openapi":"get /v2/terminal_payments/{id}","title":"Get a terminal payment","href":"/api-reference/business-api/getting-paid/terminals/get-terminal-payment"}]},{"group":"SEPA Direct Debit mandates","pages":[{"openapi":"get /v2/sepa/direct_debit_mandates","title":"List SEPA Direct Debit mandates","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/mandates/index"},{"openapi":"get /v2/sepa/direct_debit_mandates/{direct_debit_mandate_id}","title":"Get a SEPA Direct Debit mandate","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/mandates/show"},{"openapi":"post /v2/sepa/direct_debit_mandates","title":"Create a SEPA Direct Debit mandate","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/mandates/create"},{"openapi":"post /v2/sepa/direct_debit_mandates/{direct_debit_mandate_id}/cancel","title":"Cancel a SEPA Direct Debit mandate","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/mandates/cancel"}]},{"group":"SEPA Direct Debit subscriptions","pages":[{"openapi":"get /v2/sepa/direct_debit_subscriptions","title":"List SEPA Direct Debit subscriptions","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/subscriptions/index"},{"openapi":"get /v2/sepa/direct_debit_subscriptions/{direct_debit_subscription_id}","title":"Get a SEPA Direct Debit subscription","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/subscriptions/show"},{"openapi":"post /v2/sepa/direct_debit_subscriptions","title":"Create a SEPA Direct Debit subscription","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/subscriptions/create"}]},{"group":"SEPA Direct Debit collections","pages":[{"openapi":"get /v2/sepa/direct_debit_collections","title":"List SEPA Direct Debit collections","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/collections/index"},{"openapi":"get /v2/sepa/direct_debit_collections/{direct_debit_collection_id}","title":"Get a SEPA Direct Debit collection","href":"/api-reference/business-api/getting-paid/sepa-direct-debit/collections/show"}]}]},{"group":"Cards","pages":[{"group":"Cards","pages":[{"openapi":"get /v2/cards","title":"List cards","href":"/api-reference/business-api/cards/list-cards"},{"openapi":"get /v2/cards/appearances","title":"List card appearances","href":"/api-reference/business-api/cards/list-appearances"},{"openapi":"get /v2/cards/{id}/data_view","title":"Retrieve a card iframe url","href":"/api-reference/business-api/cards/retrieve-a-card-iframe-url"},{"openapi":"post /v2/cards","title":"Create a card","href":"/api-reference/business-api/cards/create-a-card"},{"openapi":"post /v2/cards_bulk","title":"Bulk create cards","href":"/api-reference/business-api/cards/bulk-create-cards"},{"openapi":"patch /v2/cards/{id}/limits","title":"Update a card's limits","href":"/api-reference/business-api/cards/update-a-cards-limits"},{"openapi":"patch /v2/cards/{id}/nickname","title":"Update a card's nickname","href":"/api-reference/business-api/cards/update-a-cards-nickname"},{"openapi":"patch /v2/cards/{id}/options","title":"Update a card's options","href":"/api-reference/business-api/cards/update-a-cards-options"},{"openapi":"patch /v2/cards/{id}/restrictions","title":"Update a card's restrictions","href":"/api-reference/business-api/cards/update-a-cards-restrictions"},{"openapi":"put /v2/cards/{id}/lock","title":"Lock a card","href":"/api-reference/business-api/cards/lock-a-card"},{"openapi":"put /v2/cards/{id}/unlock","title":"Unlock a card","href":"/api-reference/business-api/cards/unlock-a-card"},{"openapi":"put /v2/cards/{id}/lost","title":"Report a physical card as lost","href":"/api-reference/business-api/cards/report-a-physical-card-as-lost"},{"openapi":"put /v2/cards/{id}/stolen","title":"Report a physical card as stolen","href":"/api-reference/business-api/cards/report-a-physical-card-as-stolen"},{"openapi":"put /v2/cards/{id}/discard","title":"Discard a card","href":"/api-reference/business-api/cards/discard-a-card"}]}]},{"group":"Invoicing","pages":[{"group":"Clients","pages":[{"openapi":"get /v2/clients","title":"List clients","href":"/api-reference/business-api/invoicing/clients/list-clients"},{"openapi":"get /v2/clients/{id}","title":"Retrieve a client","href":"/api-reference/business-api/invoicing/clients/retrieve-a-client"},{"openapi":"post /v2/clients","title":"Create a client","href":"/api-reference/business-api/invoicing/clients/create-a-client"},{"openapi":"patch /v2/clients/{id}","title":"Update a client","href":"/api-reference/business-api/invoicing/clients/update-a-client"},{"openapi":"delete /v2/clients/{id}","title":"Delete a client","href":"/api-reference/business-api/invoicing/clients/delete-a-client"}]},{"group":"Products","pages":[{"openapi":"get /v2/products","title":"List products","href":"/api-reference/business-api/invoicing/products/list-products"},{"openapi":"get /v2/products/{id}","title":"Retrieve a product","href":"/api-reference/business-api/invoicing/products/retrieve-a-product"},{"openapi":"post /v2/products","title":"Create a product","href":"/api-reference/business-api/invoicing/products/create-a-product"},{"openapi":"delete /v2/products/{id}","title":"Delete a product","href":"/api-reference/business-api/invoicing/products/delete-a-product"}]},{"group":"Client invoices","pages":[{"openapi":"get /v2/client_invoices","title":"List client invoices","href":"/api-reference/business-api/invoicing/client-invoices/list-client-invoices"},{"openapi":"get /v2/client_invoices/{id}","title":"Retrieve a client invoice","href":"/api-reference/business-api/invoicing/client-invoices/retrieve-a-client-invoice"},{"openapi":"post /v2/client_invoices","title":"Create a client invoice","href":"/api-reference/business-api/invoicing/client-invoices/create-a-client-invoice"},{"openapi":"patch /v2/client_invoices/{id}","title":"Update a draft client invoice","href":"/api-reference/business-api/invoicing/client-invoices/update-a-client-invoice"},{"openapi":"delete /v2/client_invoices/{id}","title":"Delete a client invoice","href":"/api-reference/business-api/invoicing/client-invoices/delete-a-client-invoice"},{"openapi":"post /v2/client_invoices/{id}/finalize","title":"Finalize a client invoice","href":"/api-reference/business-api/invoicing/client-invoices/finalize-a-client-invoice"},{"openapi":"post /v2/client_invoices/{id}/send","title":"Send a client invoice via email","href":"/api-reference/business-api/invoicing/client-invoices/send-a-client-invoice"},{"openapi":"post /v2/client_invoices/{id}/send_by_einvoice","title":"Send a client invoice via e-invoice","href":"/api-reference/business-api/invoicing/client-invoices/send-a-client-invoice-by-e-invoice"},{"openapi":"post /v2/client_invoices/{id}/mark_as_paid","title":"Mark a client invoice as paid","href":"/api-reference/business-api/invoicing/client-invoices/mark-a-client-invoice-as-paid"},{"openapi":"post /v2/client_invoices/{id}/unmark_as_paid","title":"Unmark a client invoice as paid","href":"/api-reference/business-api/invoicing/client-invoices/unmark-a-client-invoice-as-paid"},{"openapi":"post /v2/client_invoices/{id}/mark_as_canceled","title":"Cancel a client invoice","href":"/api-reference/business-api/invoicing/client-invoices/mark-a-client-invoice-as-canceled"},{"openapi":"post /v2/client_invoices/bulk","title":"Import client invoices in bulk","href":"/api-reference/business-api/invoicing/client-invoices/bulk-import-client-invoices"},{"openapi":"post /v2/client_invoices/uploads","title":"Create a client invoice upload","href":"/api-reference/business-api/invoicing/client-invoices/create-a-client-invoice-upload"},{"openapi":"get /v2/client_invoices/uploads/{id}","title":"Retrieve a client invoice upload","href":"/api-reference/business-api/invoicing/client-invoices/retrieve-a-client-invoice-upload"}]},{"group":"Quotes","pages":[{"openapi":"get /v2/quotes","title":"List quotes","href":"/api-reference/business-api/invoicing/quotes/list-quotes"},{"openapi":"get /v2/quotes/{id}","title":"Retrieve a quote","href":"/api-reference/business-api/invoicing/quotes/retrieve-a-quote"},{"openapi":"post /v2/quotes","title":"Create a quote","href":"/api-reference/business-api/invoicing/quotes/create-a-quote"},{"openapi":"patch /v2/quotes/{id}","title":"Update a quote","href":"/api-reference/business-api/invoicing/quotes/patch-a-quote"},{"openapi":"delete /v2/quotes/{id}","title":"Delete a quote","href":"/api-reference/business-api/invoicing/quotes/delete-a-quote"},{"openapi":"post /v2/quotes/{id}/send","title":"Send a quote via email","href":"/api-reference/business-api/invoicing/quotes/send-a-quote"}]},{"group":"Credit notes","pages":[{"openapi":"get /v2/credit_notes","title":"List credit notes","href":"/api-reference/business-api/invoicing/credit-notes/list-credit-notes"},{"openapi":"get /v2/credit_notes/{id}","title":"Retrieve a credit note","href":"/api-reference/business-api/invoicing/credit-notes/retrieve-a-credit-note"},{"openapi":"post /v2/credit_notes","title":"Create a credit note","href":"/api-reference/business-api/invoicing/credit-notes/create-a-credit-note"},{"openapi":"get /v2/credit_notes/{credit_note_id}/file","title":"Download a credit note","href":"/api-reference/business-api/invoicing/credit-notes/download-a-credit-note"},{"openapi":"post /v2/credit_notes/{id}/send","title":"Send a credit note via email","href":"/api-reference/business-api/invoicing/credit-notes/send-a-credit-note"}]},{"group":"Recurring invoices","pages":[{"openapi":"get /v2/recurring_invoices","title":"List recurring invoices","href":"/api-reference/business-api/invoicing/recurring-invoices/list-recurring-invoices"},{"openapi":"get /v2/recurring_invoices/{id}","title":"Retrieve a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/retrieve-a-recurring-invoice"},{"openapi":"post /v2/recurring_invoices","title":"Create a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/create-a-recurring-invoice"},{"openapi":"put /v2/recurring_invoices/{id}","title":"Update a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/update-a-recurring-invoice"},{"openapi":"post /v2/recurring_invoices/{id}/cancel","title":"Cancel a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/cancel-a-recurring-invoice"},{"openapi":"post /v2/recurring_invoices/{id}/reactivate","title":"Reactivate a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/reactivate-a-recurring-invoice"},{"openapi":"post /v2/recurring_invoices/{id}/suspend","title":"Suspend a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/suspend-a-recurring-invoice"},{"openapi":"post /v2/recurring_invoices/validate","title":"Validate a recurring invoice","href":"/api-reference/business-api/invoicing/recurring-invoices/validate-a-recurring-invoice"}]},{"group":"Reminders","pages":[{"openapi":"get /v2/reminders","title":"List payment reminder configurations","href":"/api-reference/business-api/invoicing/reminders/list-reminders"},{"openapi":"get /v2/reminders/{id}","title":"Get a payment reminder configuration","href":"/api-reference/business-api/invoicing/reminders/retrieve-a-reminder"},{"openapi":"post /v2/reminders","title":"Configure payment reminders for a client","href":"/api-reference/business-api/invoicing/reminders/create-a-reminder"},{"openapi":"put /v2/reminders/{id}","title":"Replace a payment reminder configuration","href":"/api-reference/business-api/invoicing/reminders/update-a-reminder"},{"openapi":"delete /v2/reminders/{id}","title":"Delete a payment reminder configuration","href":"/api-reference/business-api/invoicing/reminders/delete-a-reminder"}]},{"group":"Invoicing settings","pages":[{"openapi":"get /v2/settings","title":"Get invoicing settings","href":"/api-reference/business-api/invoicing/settings/retrieve-settings"},{"openapi":"put /v2/settings","title":"Update invoicing settings","href":"/api-reference/business-api/invoicing/settings/update-settings"}]},{"group":"E-invoicing settings","pages":[{"openapi":"get /v2/einvoicing/settings","title":"Get e-invoicing settings","href":"/api-reference/business-api/invoicing/e-invoicing-settings/retrieve-settings"}]}]},{"group":"Spend management","pages":[{"group":"Suppliers","pages":[{"openapi":"post /v2/suppliers/search","title":"Search suppliers","href":"/api-reference/business-api/spend-management/suppliers/search-suppliers"},{"openapi":"get /v2/suppliers/{id}","title":"Retrieve a supplier","href":"/api-reference/business-api/spend-management/suppliers/retrieve-a-supplier"},{"openapi":"post /v2/suppliers","title":"Create a supplier","href":"/api-reference/business-api/spend-management/suppliers/create-supplier"},{"openapi":"put /v2/suppliers/{id}","title":"Update a supplier","href":"/api-reference/business-api/spend-management/suppliers/update-supplier"}]},{"group":"Supplier invoices","pages":[{"openapi":"get /v2/supplier_invoices","title":"List supplier invoices","href":"/api-reference/business-api/spend-management/supplier-invoices/list-supplier-invoices"},{"openapi":"get /v2/supplier_invoices/{id}","title":"Retrieve a supplier invoice","href":"/api-reference/business-api/spend-management/supplier-invoices/retrieve-a-supplier-invoice"},{"openapi":"post /v2/supplier_invoices/bulk","title":"Create supplier invoices","href":"/api-reference/business-api/spend-management/supplier-invoices/create-supplier-invoices"},{"openapi":"post /v2/supplier_invoices/{id}/mark_as_paid","title":"Mark a supplier invoice as paid","href":"/api-reference/business-api/spend-management/supplier-invoices/mark-supplier-invoice-as-paid"},{"openapi":"post /v2/supplier_invoices/{id}/reject","title":"Reject a supplier invoice","href":"/api-reference/business-api/spend-management/supplier-invoices/reject-supplier-invoice"},{"openapi":"post /v2/supplier_invoices/{id}/unmark_as_paid","title":"Unmark a supplier invoice as paid","href":"/api-reference/business-api/spend-management/supplier-invoices/unmark-supplier-invoice-as-paid"}]},{"group":"Requests","pages":[{"openapi":"get /v2/requests","title":"List requests","href":"/api-reference/business-api/spend-management/requests/list-requests"},{"openapi":"post /v2/requests/transfers","title":"Create transfer request","href":"/api-reference/business-api/spend-management/requests/create-transfer-request"},{"openapi":"post /v2/requests/multi_transfers","title":"Create multi transfer request","href":"/api-reference/business-api/spend-management/requests/create-multi-transfer-request"},{"openapi":"post /v2/requests/flash_cards","title":"Create a flash card request","href":"/api-reference/business-api/spend-management/requests/create-a-flash-card-request"},{"openapi":"post /v2/requests/virtual_cards","title":"Create a virtual card request","href":"/api-reference/business-api/spend-management/requests/create-a-virtual-card-request"},{"openapi":"post /v2/requests/{request_type}/{id}/approve","title":"Approve a request","href":"/api-reference/business-api/spend-management/requests/approve-a-request"},{"openapi":"post /v2/requests/{request_type}/{id}/decline","title":"Decline a request","href":"/api-reference/business-api/spend-management/requests/decline-a-request"}]},{"group":"Insurance contracts","pages":[{"openapi":"get /v2/insurance_contracts/{id}","title":"Retrieve an insurance contract","href":"/api-reference/business-api/spend-management/insurance-contracts/retrieve-an-insurance-contract"},{"openapi":"post /v2/insurance_contracts","title":"Create an insurance contract","href":"/api-reference/business-api/spend-management/insurance-contracts/create-an-insurance-contract"},{"openapi":"patch /v2/insurance_contracts/{id}","title":"Update an insurance contract","href":"/api-reference/business-api/spend-management/insurance-contracts/update-an-insurance-contract"},{"openapi":"post /v2/insurance_contracts/{id}/attachments","title":"Upload a document to an insurance contract","href":"/api-reference/business-api/spend-management/insurance-contracts/upload-a-document-to-an-insurance-contract"},{"openapi":"delete /v2/insurance_contracts/{id}/attachments/{attachment_id}","title":"Remove a document from an insurance contract","href":"/api-reference/business-api/spend-management/insurance-contracts/remove-a-document-from-an-insurance-contract"}]}]},{"group":"Cash flow","pages":[{"group":"Categories","pages":[{"openapi":"get /v2/cash_flow_categories","title":"List cash flow categories","href":"/api-reference/business-api/cash-flow/categories/list"},{"openapi":"post /v2/cash_flow_categories","title":"Create a cash flow category","href":"/api-reference/business-api/cash-flow/categories/create"},{"openapi":"patch /v2/cash_flow_categories/{id}","title":"Update a cash flow category","href":"/api-reference/business-api/cash-flow/categories/update"},{"openapi":"delete /v2/cash_flow_categories/{id}","title":"Delete a cash flow category","href":"/api-reference/business-api/cash-flow/categories/delete"},{"openapi":"post /v2/cash_flow_categories/assignments","title":"Assign a cash flow category to transactions","href":"/api-reference/business-api/cash-flow/categories/assign"},{"openapi":"post /v2/cash_flow_categories/{category_id}/subcategories","title":"Create a cash flow subcategory","href":"/api-reference/business-api/cash-flow/categories/create-subcategory"},{"openapi":"post /v2/cash_flow_categories/unassignments","title":"Unassign a cash flow category from transactions","href":"/api-reference/business-api/cash-flow/categories/unassign"}]},{"group":"Scenarios","pages":[{"openapi":"get /v2/cash_flow_scenarios","title":"List cash flow scenarios","href":"/api-reference/business-api/cash-flow/scenarios/list"},{"openapi":"post /v2/cash_flow_scenarios","title":"Create a cash flow scenario","href":"/api-reference/business-api/cash-flow/scenarios/create"},{"openapi":"patch /v2/cash_flow_scenarios/{id}","title":"Update a cash flow scenario","href":"/api-reference/business-api/cash-flow/scenarios/update"},{"openapi":"delete /v2/cash_flow_scenarios/{id}","title":"Delete a cash flow scenario","href":"/api-reference/business-api/cash-flow/scenarios/delete"}]},{"group":"Targets","pages":[{"openapi":"get /v2/cash_flow_targets","title":"List cash flow targets","href":"/api-reference/business-api/cash-flow/targets/list"},{"openapi":"put /v2/cash_flow_targets","title":"Create or update cash flow targets","href":"/api-reference/business-api/cash-flow/targets/upsert"},{"openapi":"delete /v2/cash_flow_targets","title":"Delete a cash flow target","href":"/api-reference/business-api/cash-flow/targets/delete"}]}]},{"group":"Webhooks","pages":[{"group":"Webhook subscriptions","pages":[{"openapi":"get /v2/webhook_subscriptions","title":"List webhook subscriptions","href":"/api-reference/business-api/webhooks/list-webhook-subscriptions"},{"openapi":"get /v2/webhook_subscriptions/{id}","title":"Get a webhook subscription","href":"/api-reference/business-api/webhooks/get-a-webhook-subscription"},{"openapi":"post /v2/webhook_subscriptions","title":"Create a new webhook subscription","href":"/api-reference/business-api/webhooks/create-a-webhook-subscription"},{"openapi":"put /v2/webhook_subscriptions/{id}","title":"Update a webhook subscription","href":"/api-reference/business-api/webhooks/update-a-webhook-subscription"},{"openapi":"delete /v2/webhook_subscriptions/{id}","title":"Delete a webhook subscription","href":"/api-reference/business-api/webhooks/delete-a-webhook-subscription"}]},{"group":"Supported events","pages":[{"title":"v1/accounts","openapi":"webhook v1/accounts","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-accounts"},{"title":"v1/beneficiaries","openapi":"webhook v1/beneficiaries","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-beneficiaries"},{"title":"v1/cards","openapi":"webhook v1/cards","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-cards"},{"title":"v1/client-invoices","openapi":"webhook v1/client-invoices","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-client-invoices"},{"title":"v1/clients","openapi":"webhook v1/clients","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-clients"},{"title":"v1/consent-revocations","openapi":"webhook v1/consent-revocations","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-consent-revocations"},{"title":"v1/memberships","openapi":"webhook v1/memberships","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-memberships"},{"title":"v1/organizations","openapi":"webhook v1/organizations","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-organizations"},{"title":"v1/payment-links","openapi":"webhook v1/payment-links","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-payment-links"},{"title":"v1/payment-links-connections","openapi":"webhook v1/payment-links-connections","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-payment-links-connections"},{"title":"v1/products","openapi":"webhook v1/products","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-products"},{"title":"v1/recurring-transfers","openapi":"webhook v1/recurring-transfers","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-recurring-transfers"},{"title":"v1/sepa-direct-debit-collections","openapi":"webhook v1/sepa-direct-debit-collections","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-sepa-direct-debit-collections"},{"title":"v1/sepa-direct-debit-mandates","openapi":"webhook v1/sepa-direct-debit-mandates","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-sepa-direct-debit-mandates"},{"title":"v1/terminal-payments","openapi":"webhook v1/terminal-payments","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-terminal-payments"},{"title":"v1/transactions","openapi":"webhook v1/transactions","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-transactions"},{"title":"v1/transfers","openapi":"webhook v1/transfers","href":"/api-reference/business-api/webhooks/supported-webhooks/v1-transfers"}]}]},{"group":"Partner endpoints","pages":[{"group":"Encoded requests","pages":[{"openapi":"post /v1/encoded_requests/dispatch","title":"Dispatch an encoded request","href":"/api-reference/business-api/authentication/encoded-requests/dispatch"}]},{"group":"Embed auth links","pages":[{"openapi":"post /v1/embed_auth_links","title":"Create an Embed Auth Link","href":"/api-reference/business-api/authentication/embed-auth-links/create"}]}]}]},{"anchor":"Onboarding Partners API","icon":"user-plus","pages":[{"title":"Onboarding Partners API","href":"/api-reference/onboarding-api/introduction/overview"}]}]},{"tab":"MCP","icon":"robot","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Resources","icon":"toolbox","menu":[{"item":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/cli/overview"}]},{"item":"FAQs","icon":"circle-question","pages":[{"title":"FAQs","href":"/faq-articles/faq-home"}]},{"item":"Support","icon":"life-ring","pages":[{"title":"Support","href":"/support"}]},{"item":"Security \u0026 compliance","icon":"shield-halved","pages":[{"title":"Security \u0026 compliance","href":"/security-and-compliance/security-measures"}]}],"pages":[{"title":"Resources","href":"/cli/overview"}]},{"tab":"Partnerships","icon":"handshake","menu":[{"item":"Integrations with Qonto","icon":"puzzle-piece","pages":[{"title":"Integrations with Qonto","href":"/partnerships/integrations"}]},{"item":"Embed Qonto in your product","icon":"link","pages":[{"title":"Embed Qonto in your product","href":"/partnerships/embed/overview"}]},{"item":"Company creation","icon":"building","pages":[{"title":"Company creation","href":"/partnerships/company-creation"}]},{"item":"Plateforme Agréée as a Service","icon":"file-invoice","pages":[{"title":"Plateforme Agréée as a Service","href":"/partnerships/plateforme-agreee-as-a-service"}]}],"pages":[{"title":"Partnerships","href":"/partnerships/integrations"}]}]},"basePath":"","title":"Create a Bulk Transfer - Qonto","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}