{"items":[{"type":"link","label":"Boya API","link":"/v2/openapi","routeSlug":"/v2/openapi","content":{"contentType":"overview","meta":{"name":"Boya API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/v2/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/v2/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"Boya API Support","email":"apisupport@boyahq.com","label":"apisupport@boyahq.com","withCopyButton":true,"copyContent":"apisupport@boyahq.com"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Boya API (2.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Boya is the financial operating system for business operations. The v2 API uses OAuth2 client-credentials authentication and signed webhooks."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Operations badged "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" require a commercial entitlement — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/v2/openapi"}],"sectionId":"/v2/openapi"}]}]}},{"type":"separator","label":"Money movement","content":null},{"type":"group","label":"Bills · Manage","link":"/v2/openapi/bills","routeSlug":"/v2/openapi/bills","items":[{"label":"List bills","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_listbills","routeSlug":"/v2/openapi/bills/billscontroller_listbills","metadata":{"seo":{"title":"List bills","description":"List bills"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_listBills","name":"List bills","isWebhook":false,"pointer":"/paths/~1bills/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List bills","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_107"},{"name":"page","in":"query","schemaId":"schema_108"},{"name":"limit","in":"query","schemaId":"schema_109"},{"name":"search","in":"query","schemaId":"schema_110","description":"Search by invoice, vendor, verifier, or category"},{"name":"from","in":"query","schemaId":"schema_110","description":"Start date filter"},{"name":"to","in":"query","schemaId":"schema_110","description":"End date filter"},{"name":"currency","in":"query","schemaId":"schema_111","description":"Currency code filter"},{"name":"partially_paid","in":"query","schemaId":"schema_110","description":"Only return partially paid outstanding bills"}],"pointer":"/paths/~1bills/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_107"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":25,"schemaId":"schema_109"},{"name":"search","in":"query","required":false,"schemaId":"schema_110"},{"name":"from","in":"query","required":false,"schemaId":"schema_110"},{"name":"to","in":"query","required":false,"schemaId":"schema_110"},{"name":"currency","in":"query","required":false,"example":"KES","schemaId":"schema_111"},{"name":"partially_paid","in":"query","required":false,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills","href":"bills/billscontroller_listbills","openApiOperationId":"BillsController_listBills","summary":"List bills"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_listbills"}],"panels":[]}]},"httpPath":"/bills"},{"label":"Create a bill","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_createbill","routeSlug":"/v2/openapi/bills/billscontroller_createbill","metadata":{"seo":{"title":"Create a bill","description":"Create a bill"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_createBill","name":"Create a bill","isWebhook":false,"pointer":"/paths/~1bills/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a bill","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBillV1Dto"}},"schemaId":"components/schemas/CreateBillV1Dto","pointer":"/paths/~1bills/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBillV1Dto"}},"responseCodes":["201"],"pointer":"/bills","href":"bills/billscontroller_createbill","openApiOperationId":"BillsController_createBill","summary":"Create a bill"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateBillV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBillV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_createbill"}],"panels":[]}]},"httpPath":"/bills"},{"label":"Create multiple bills in one request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_bulkcreatebills","routeSlug":"/v2/openapi/bills/billscontroller_bulkcreatebills","metadata":{"seo":{"title":"Create multiple bills in one request","description":"Create multiple bills in one request"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_bulkCreateBills","name":"Create multiple bills in one request","isWebhook":false,"pointer":"/paths/~1bills~1create-bulk-bills/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create multiple bills in one request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1create-bulk-bills/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BulkCreateBillsV1Dto"}},"schemaId":"components/schemas/BulkCreateBillsV1Dto","pointer":"/paths/~1bills~1create-bulk-bills/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/create-bulk-bills","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BulkCreateBillsV1Dto"}},"responseCodes":["201"],"pointer":"/bills/create-bulk-bills","href":"bills/billscontroller_bulkcreatebills","openApiOperationId":"BillsController_bulkCreateBills","summary":"Create multiple bills in one request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/BulkCreateBillsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BulkCreateBillsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1create-bulk-bills/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_bulkcreatebills"}],"panels":[]}]},"httpPath":"/bills/create-bulk-bills"},{"label":"Get bill counts by status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_getbillscount","routeSlug":"/v2/openapi/bills/billscontroller_getbillscount","metadata":{"seo":{"title":"Get bill counts by status","description":"Get bill counts by status"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getBillsCount","name":"Get bill counts by status","isWebhook":false,"pointer":"/paths/~1bills~1count/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get bill counts by status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1count/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/count","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/count","href":"bills/billscontroller_getbillscount","openApiOperationId":"BillsController_getBillsCount","summary":"Get bill counts by status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1count/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_getbillscount"}],"panels":[]}]},"httpPath":"/bills/count"},{"label":"Get bill approvers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_getbillapprovers","routeSlug":"/v2/openapi/bills/billscontroller_getbillapprovers","metadata":{"seo":{"title":"Get bill approvers","description":"Get bill approvers"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getBillApprovers","name":"Get bill approvers","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1approvers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get bill approvers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1approvers/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1approvers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/{billId}/approvers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/{billId}/approvers","href":"bills/billscontroller_getbillapprovers","openApiOperationId":"BillsController_getBillApprovers","summary":"Get bill approvers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1{billId}~1approvers/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_getbillapprovers"}],"panels":[]}]},"httpPath":"/bills/{billId}/approvers"},{"label":"Get bill detail","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_getbill","routeSlug":"/v2/openapi/bills/billscontroller_getbill","metadata":{"seo":{"title":"Get bill detail","description":"Get bill detail"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getBill","name":"Get bill detail","isWebhook":false,"pointer":"/paths/~1bills~1{billId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get bill detail","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/{billId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/{billId}","href":"bills/billscontroller_getbill","openApiOperationId":"BillsController_getBill","summary":"Get bill detail"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1{billId}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_getbill"}],"panels":[]}]},"httpPath":"/bills/{billId}"},{"label":"Update a bill","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_updatebill","routeSlug":"/v2/openapi/bills/billscontroller_updatebill","metadata":{"seo":{"title":"Update a bill","description":"Update a bill"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_updateBill","name":"Update a bill","isWebhook":false,"pointer":"/paths/~1bills~1{billId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a bill","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBillV1Dto"}},"schemaId":"components/schemas/UpdateBillV1Dto","pointer":"/paths/~1bills~1{billId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/bills/{billId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateBillV1Dto"}},"responseCodes":["200"],"pointer":"/bills/{billId}","href":"bills/billscontroller_updatebill","openApiOperationId":"BillsController_updateBill","summary":"Update a bill"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateBillV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBillV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1{billId}/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_updatebill"}],"panels":[]}]},"httpPath":"/bills/{billId}"},{"label":"Cancel a bill","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_cancelbill","routeSlug":"/v2/openapi/bills/billscontroller_cancelbill","metadata":{"seo":{"title":"Cancel a bill","description":"Cancel a bill"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_cancelBill","name":"Cancel a bill","isWebhook":false,"pointer":"/paths/~1bills~1{billId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a bill","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/bills/{billId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["200"],"pointer":"/bills/{billId}","href":"bills/billscontroller_cancelbill","openApiOperationId":"BillsController_cancelBill","summary":"Cancel a bill"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1{billId}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_cancelbill"}],"panels":[]}]},"httpPath":"/bills/{billId}"},{"label":"Return a bill to draft","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills/billscontroller_returntodraft","routeSlug":"/v2/openapi/bills/billscontroller_returntodraft","metadata":{"seo":{"title":"Return a bill to draft","description":"Return a bill to draft"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_returnToDraft","name":"Return a bill to draft","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1return-to-draft/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Return a bill to draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1return-to-draft/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1return-to-draft/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/return-to-draft","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["201"],"pointer":"/bills/{billId}/return-to-draft","href":"bills/billscontroller_returntodraft","openApiOperationId":"BillsController_returnToDraft","summary":"Return a bill to draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1return-to-draft/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills/billscontroller_returntodraft"}],"panels":[]}]},"httpPath":"/bills/{billId}/return-to-draft"}],"content":{"contentType":"group","meta":{"name":"bills"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bills · Manage","showPageActions":true},{"nodeType":"markdoc","content":"Create, list, update, and cancel bills."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bills","summary":"List bills","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills/billscontroller_listbills","deprecated":false},{"title":"/bills","summary":"Create a bill","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills/billscontroller_createbill","deprecated":false},{"title":"/bills/create-bulk-bills","summary":"Create multiple bills in one request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills/billscontroller_bulkcreatebills","deprecated":false},{"title":"/bills/count","summary":"Get bill counts by status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills/billscontroller_getbillscount","deprecated":false},{"title":"/bills/{billId}/approvers","summary":"Get bill approvers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills/billscontroller_getbillapprovers","deprecated":false},{"title":"/bills/{billId}","summary":"Get bill detail","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills/billscontroller_getbill","deprecated":false},{"title":"/bills/{billId}","summary":"Update a bill","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/bills/billscontroller_updatebill","deprecated":false},{"title":"/bills/{billId}","summary":"Cancel a bill","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/bills/billscontroller_cancelbill","deprecated":false},{"title":"/bills/{billId}/return-to-draft","summary":"Return a bill to draft","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills/billscontroller_returntodraft","deprecated":false}]}]}]}]}},{"type":"group","label":"Bills · Payments","link":"/v2/openapi/bills-payments","routeSlug":"/v2/openapi/bills-payments","items":[{"label":"Check bill payment status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_checkpaymentstatus","routeSlug":"/v2/openapi/bills-payments/billscontroller_checkpaymentstatus","metadata":{"seo":{"title":"Check bill payment status","description":"Check bill payment status"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_checkPaymentStatus","name":"Check bill payment status","isWebhook":false,"pointer":"/paths/~1bills~1payments~1{paymentRef}~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Check bill payment status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1status/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1status/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/payments/{paymentRef}/status","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/payments/{paymentRef}/status","href":"bills-payments/billscontroller_checkpaymentstatus","openApiOperationId":"BillsController_checkPaymentStatus","summary":"Check bill payment status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1status/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_checkpaymentstatus"}],"panels":[]}]},"httpPath":"/bills/payments/{paymentRef}/status"},{"label":"Add another payment to a bill","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_addpayment","routeSlug":"/v2/openapi/bills-payments/billscontroller_addpayment","metadata":{"seo":{"title":"Add another payment to a bill","description":"Add another payment to a bill"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_addPayment","name":"Add another payment to a bill","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1payments/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add another payment to a bill","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true},{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional idempotency key (8–255 chars). Also accepted as body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"idempotency_key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; header wins when both are present."},"children":[]}]}]}]}],"pointer":"/paths/~1bills~1{billId}~1payments/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddBillPaymentV1Dto"}},"schemaId":"components/schemas/AddBillPaymentV1Dto","pointer":"/paths/~1bills~1{billId}~1payments/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/payments","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"},{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddBillPaymentV1Dto"}},"responseCodes":["201"],"pointer":"/bills/{billId}/payments","href":"bills-payments/billscontroller_addpayment","openApiOperationId":"BillsController_addPayment","summary":"Add another payment to a bill"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddBillPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddBillPaymentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1payments/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_addpayment"}],"panels":[]}]},"httpPath":"/bills/{billId}/payments"},{"label":"Request approval for a bill payment","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_requestapproval","routeSlug":"/v2/openapi/bills-payments/billscontroller_requestapproval","metadata":{"seo":{"title":"Request approval for a bill payment","description":"Request approval for a bill payment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_requestApproval","name":"Request approval for a bill payment","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1request-approval/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request approval for a bill payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true},{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1request-approval/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1request-approval/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/bills/{billId}/payments/{paymentRef}/request-approval","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"},{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["200"],"pointer":"/bills/{billId}/payments/{paymentRef}/request-approval","href":"bills-payments/billscontroller_requestapproval","openApiOperationId":"BillsController_requestApproval","summary":"Request approval for a bill payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1request-approval/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_requestapproval"}],"panels":[]}]},"httpPath":"/bills/{billId}/payments/{paymentRef}/request-approval"},{"label":"Approve a bill payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_approvepayment","routeSlug":"/v2/openapi/bills-payments/billscontroller_approvepayment","metadata":{"seo":{"title":"Approve a bill payment","description":"Approve a bill payment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_approvePayment","name":"Approve a bill payment","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1approve/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve a bill payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true},{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1approve/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1approve/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/payments/{paymentRef}/approve","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"},{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["201"],"pointer":"/bills/{billId}/payments/{paymentRef}/approve","href":"bills-payments/billscontroller_approvepayment","openApiOperationId":"BillsController_approvePayment","summary":"Approve a bill payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1approve/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_approvepayment"}],"panels":[]}]},"httpPath":"/bills/{billId}/payments/{paymentRef}/approve"},{"label":"Reject a bill payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_rejectpayment","routeSlug":"/v2/openapi/bills-payments/billscontroller_rejectpayment","metadata":{"seo":{"title":"Reject a bill payment","description":"Reject a bill payment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_rejectPayment","name":"Reject a bill payment","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1reject/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject a bill payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true},{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1reject/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1reject/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentV1Dto"}},"schemaId":"components/schemas/RejectBillPaymentV1Dto","pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1reject/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/payments/{paymentRef}/reject","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"},{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentV1Dto"}},"responseCodes":["201"],"pointer":"/bills/{billId}/payments/{paymentRef}/reject","href":"bills-payments/billscontroller_rejectpayment","openApiOperationId":"BillsController_rejectPayment","summary":"Reject a bill payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectBillPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1reject/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_rejectpayment"}],"panels":[]}]},"httpPath":"/bills/{billId}/payments/{paymentRef}/reject"},{"label":"Withdraw approval request and return bill to draft","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_withdrawapproval","routeSlug":"/v2/openapi/bills-payments/billscontroller_withdrawapproval","metadata":{"seo":{"title":"Withdraw approval request and return bill to draft","description":"Withdraw approval request and return bill to draft"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_withdrawApproval","name":"Withdraw approval request and return bill to draft","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1withdraw/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Withdraw approval request and return bill to draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true},{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1withdraw/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1withdraw/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WithdrawBillApprovalV1Dto"}},"schemaId":"components/schemas/WithdrawBillApprovalV1Dto","pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1withdraw/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/payments/{paymentRef}/withdraw","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"},{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/WithdrawBillApprovalV1Dto"}},"responseCodes":["201"],"pointer":"/bills/{billId}/payments/{paymentRef}/withdraw","href":"bills-payments/billscontroller_withdrawapproval","openApiOperationId":"BillsController_withdrawApproval","summary":"Withdraw approval request and return bill to draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/WithdrawBillApprovalV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WithdrawBillApprovalV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1payments~1{paymentRef}~1withdraw/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_withdrawapproval"}],"panels":[]}]},"httpPath":"/bills/{billId}/payments/{paymentRef}/withdraw"},{"label":"Retry a failed bill payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-payments/billscontroller_retrypayment","routeSlug":"/v2/openapi/bills-payments/billscontroller_retrypayment","metadata":{"seo":{"title":"Retry a failed bill payment","description":"Retry a failed bill payment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_retryPayment","name":"Retry a failed bill payment","isWebhook":false,"pointer":"/paths/~1bills~1payments~1{paymentRef}~1retry/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retry a failed bill payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"paymentRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1retry/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1retry/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/payments/{paymentRef}/retry","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"paymentRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["201"],"pointer":"/bills/payments/{paymentRef}/retry","href":"bills-payments/billscontroller_retrypayment","openApiOperationId":"BillsController_retryPayment","summary":"Retry a failed bill payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1payments~1{paymentRef}~1retry/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-payments/billscontroller_retrypayment"}],"panels":[]}]},"httpPath":"/bills/payments/{paymentRef}/retry"}],"content":{"contentType":"group","meta":{"name":"bills-payments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bills · Payments","showPageActions":true},{"nodeType":"markdoc","content":"Add, approve, reject, retry, and check bill payments."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bills/payments/{paymentRef}/status","summary":"Check bill payment status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills-payments/billscontroller_checkpaymentstatus","deprecated":false},{"title":"/bills/{billId}/payments","summary":"Add another payment to a bill","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-payments/billscontroller_addpayment","deprecated":false},{"title":"/bills/{billId}/payments/{paymentRef}/request-approval","summary":"Request approval for a bill payment","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/bills-payments/billscontroller_requestapproval","deprecated":false},{"title":"/bills/{billId}/payments/{paymentRef}/approve","summary":"Approve a bill payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-payments/billscontroller_approvepayment","deprecated":false},{"title":"/bills/{billId}/payments/{paymentRef}/reject","summary":"Reject a bill payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-payments/billscontroller_rejectpayment","deprecated":false},{"title":"/bills/{billId}/payments/{paymentRef}/withdraw","summary":"Withdraw approval request and return bill to draft","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-payments/billscontroller_withdrawapproval","deprecated":false},{"title":"/bills/payments/{paymentRef}/retry","summary":"Retry a failed bill payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-payments/billscontroller_retrypayment","deprecated":false}]}]}]}]}},{"type":"group","label":"Bills · Approval workflows","link":"/v2/openapi/bills-workflows","routeSlug":"/v2/openapi/bills-workflows","items":[{"label":"Get bill approval workflow configuration","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-workflows/billscontroller_getworkflow","routeSlug":"/v2/openapi/bills-workflows/billscontroller_getworkflow","metadata":{"seo":{"title":"Get bill approval workflow configuration","description":"Get bill approval workflow configuration"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getWorkflow","name":"Get bill approval workflow configuration","isWebhook":false,"pointer":"/paths/~1bills~1workflow/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get bill approval workflow configuration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/workflow","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/workflow","href":"bills-workflows/billscontroller_getworkflow","openApiOperationId":"BillsController_getWorkflow","summary":"Get bill approval workflow configuration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1workflow/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-workflows/billscontroller_getworkflow"}],"panels":[]}]},"httpPath":"/bills/workflow"},{"label":"Create bill approval workflow","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-workflows/billscontroller_createworkflow","routeSlug":"/v2/openapi/bills-workflows/billscontroller_createworkflow","metadata":{"seo":{"title":"Create bill approval workflow","description":"Create bill approval workflow"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_createWorkflow","name":"Create bill approval workflow","isWebhook":false,"pointer":"/paths/~1bills~1workflow/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create bill approval workflow","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"schemaId":"components/schemas/BillWorkflowV1Dto","pointer":"/paths/~1bills~1workflow/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/workflow","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"responseCodes":["201"],"pointer":"/bills/workflow","href":"bills-workflows/billscontroller_createworkflow","openApiOperationId":"BillsController_createWorkflow","summary":"Create bill approval workflow"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/BillWorkflowV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1workflow/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-workflows/billscontroller_createworkflow"}],"panels":[]}]},"httpPath":"/bills/workflow"},{"label":"Update bill approval workflow","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-workflows/billscontroller_updateworkflow","routeSlug":"/v2/openapi/bills-workflows/billscontroller_updateworkflow","metadata":{"seo":{"title":"Update bill approval workflow","description":"Update bill approval workflow"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_updateWorkflow","name":"Update bill approval workflow","isWebhook":false,"pointer":"/paths/~1bills~1workflow~1{workflowId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update bill approval workflow","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"workflowId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"schemaId":"components/schemas/BillWorkflowV1Dto","pointer":"/paths/~1bills~1workflow~1{workflowId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/bills/workflow/{workflowId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"workflowId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"responseCodes":["200"],"pointer":"/bills/workflow/{workflowId}","href":"bills-workflows/billscontroller_updateworkflow","openApiOperationId":"BillsController_updateWorkflow","summary":"Update bill approval workflow"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/BillWorkflowV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BillWorkflowV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-workflows/billscontroller_updateworkflow"}],"panels":[]}]},"httpPath":"/bills/workflow/{workflowId}"},{"label":"Delete bill approval workflow","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-workflows/billscontroller_deleteworkflow","routeSlug":"/v2/openapi/bills-workflows/billscontroller_deleteworkflow","metadata":{"seo":{"title":"Delete bill approval workflow","description":"Delete bill approval workflow"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_deleteWorkflow","name":"Delete bill approval workflow","isWebhook":false,"pointer":"/paths/~1bills~1workflow~1{workflowId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete bill approval workflow","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"workflowId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/bills/workflow/{workflowId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"workflowId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"responseCodes":["200"],"pointer":"/bills/workflow/{workflowId}","href":"bills-workflows/billscontroller_deleteworkflow","openApiOperationId":"BillsController_deleteWorkflow","summary":"Delete bill approval workflow"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1workflow~1{workflowId}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-workflows/billscontroller_deleteworkflow"}],"panels":[]}]},"httpPath":"/bills/workflow/{workflowId}"}],"content":{"contentType":"group","meta":{"name":"bills-workflows"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bills · Approval workflows","showPageActions":true},{"nodeType":"markdoc","content":"Configure bill approval workflows."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bills/workflow","summary":"Get bill approval workflow configuration","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills-workflows/billscontroller_getworkflow","deprecated":false},{"title":"/bills/workflow","summary":"Create bill approval workflow","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-workflows/billscontroller_createworkflow","deprecated":false},{"title":"/bills/workflow/{workflowId}","summary":"Update bill approval workflow","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/bills-workflows/billscontroller_updateworkflow","deprecated":false},{"title":"/bills/workflow/{workflowId}","summary":"Delete bill approval workflow","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/bills-workflows/billscontroller_deleteworkflow","deprecated":false}]}]}]}]}},{"type":"group","label":"Bills · Budgets & setup","link":"/v2/openapi/bills-budgets","routeSlug":"/v2/openapi/bills-budgets","items":[{"label":"Get business budgets for bill assignment","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-budgets/billscontroller_getbudgets","routeSlug":"/v2/openapi/bills-budgets/billscontroller_getbudgets","metadata":{"seo":{"title":"Get business budgets for bill assignment","description":"Get business budgets for bill assignment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getBudgets","name":"Get business budgets for bill assignment","isWebhook":false,"pointer":"/paths/~1bills~1budgets/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get business budgets for bill assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1budgets/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/budgets","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/budgets","href":"bills-budgets/billscontroller_getbudgets","openApiOperationId":"BillsController_getBudgets","summary":"Get business budgets for bill assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1budgets/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-budgets/billscontroller_getbudgets"}],"panels":[]}]},"httpPath":"/bills/budgets"},{"label":"Get a single budget (with its wallet) for bill assignment","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-budgets/billscontroller_getbudget","routeSlug":"/v2/openapi/bills-budgets/billscontroller_getbudget","metadata":{"seo":{"title":"Get a single budget (with its wallet) for bill assignment","description":"Get a single budget (with its wallet) for bill assignment"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_getBudget","name":"Get a single budget (with its wallet) for bill assignment","isWebhook":false,"pointer":"/paths/~1bills~1budgets~1{budgetId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a single budget (with its wallet) for bill assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"budgetId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1budgets~1{budgetId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1budgets~1{budgetId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bills/budgets/{budgetId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"budgetId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:read"]}],"responseCodes":["200"],"pointer":"/bills/budgets/{budgetId}","href":"bills-budgets/billscontroller_getbudget","openApiOperationId":"BillsController_getBudget","summary":"Get a single budget (with its wallet) for bill assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1bills~1budgets~1{budgetId}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-budgets/billscontroller_getbudget"}],"panels":[]}]},"httpPath":"/bills/budgets/{budgetId}"},{"label":"Add or update vendor payment method","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-budgets/billscontroller_addvendorpaymentmethod","routeSlug":"/v2/openapi/bills-budgets/billscontroller_addvendorpaymentmethod","metadata":{"seo":{"title":"Add or update vendor payment method","description":"Add or update vendor payment method"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_addVendorPaymentMethod","name":"Add or update vendor payment method","isWebhook":false,"pointer":"/paths/~1bills~1vendors~1{vendorId}~1payment-method/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add or update vendor payment method","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"vendorId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1vendors~1{vendorId}~1payment-method/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1vendors~1{vendorId}~1payment-method/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddVendorPaymentMethodV1Dto"}},"schemaId":"components/schemas/AddVendorPaymentMethodV1Dto","pointer":"/paths/~1bills~1vendors~1{vendorId}~1payment-method/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/vendors/{vendorId}/payment-method","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"vendorId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddVendorPaymentMethodV1Dto"}},"responseCodes":["201"],"pointer":"/bills/vendors/{vendorId}/payment-method","href":"bills-budgets/billscontroller_addvendorpaymentmethod","openApiOperationId":"BillsController_addVendorPaymentMethod","summary":"Add or update vendor payment method"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddVendorPaymentMethodV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddVendorPaymentMethodV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1vendors~1{vendorId}~1payment-method/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-budgets/billscontroller_addvendorpaymentmethod"}],"panels":[]}]},"httpPath":"/bills/vendors/{vendorId}/payment-method"}],"content":{"contentType":"group","meta":{"name":"bills-budgets"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bills · Budgets & setup","showPageActions":true},{"nodeType":"markdoc","content":"Budgets for bill assignment and vendor payment methods."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bills/budgets","summary":"Get business budgets for bill assignment","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills-budgets/billscontroller_getbudgets","deprecated":false},{"title":"/bills/budgets/{budgetId}","summary":"Get a single budget (with its wallet) for bill assignment","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bills-budgets/billscontroller_getbudget","deprecated":false},{"title":"/bills/vendors/{vendorId}/payment-method","summary":"Add or update vendor payment method","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-budgets/billscontroller_addvendorpaymentmethod","deprecated":false}]}]}]}]}},{"type":"group","label":"Bills · Attachments","link":"/v2/openapi/bills-attachments","routeSlug":"/v2/openapi/bills-attachments","items":[{"label":"Upload a bill attachment file and get its URL","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-attachments/billscontroller_uploadbillfile","routeSlug":"/v2/openapi/bills-attachments/billscontroller_uploadbillfile","metadata":{"seo":{"title":"Upload a bill attachment file and get its URL","description":"Upload a bill attachment file and get its URL"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_uploadBillFile","name":"Upload a bill attachment file and get its URL","isWebhook":false,"pointer":"/paths/~1bills~1upload/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload a bill attachment file and get its URL","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1upload/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadBillFileV1Dto"}},"schemaId":"components/schemas/UploadBillFileV1Dto","pointer":"/paths/~1bills~1upload/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/upload","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UploadBillFileV1Dto"}},"responseCodes":["201"],"pointer":"/bills/upload","href":"bills-attachments/billscontroller_uploadbillfile","openApiOperationId":"BillsController_uploadBillFile","summary":"Upload a bill attachment file and get its URL"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UploadBillFileV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadBillFileV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1upload/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-attachments/billscontroller_uploadbillfile"}],"panels":[]}]},"httpPath":"/bills/upload"},{"label":"Attach an uploaded file to a bill","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/bills-attachments/billscontroller_addbillattachment","routeSlug":"/v2/openapi/bills-attachments/billscontroller_addbillattachment","metadata":{"seo":{"title":"Attach an uploaded file to a bill","description":"Attach an uploaded file to a bill"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BillsController_addBillAttachment","name":"Attach an uploaded file to a bill","isWebhook":false,"pointer":"/paths/~1bills~1{billId}~1attachments/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attach an uploaded file to a bill","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["bills:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"billId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1attachments/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1bills~1{billId}~1attachments/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddBillAttachmentV1Dto"}},"schemaId":"components/schemas/AddBillAttachmentV1Dto","pointer":"/paths/~1bills~1{billId}~1attachments/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bills/{billId}/attachments","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"billId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["bills:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddBillAttachmentV1Dto"}},"responseCodes":["201"],"pointer":"/bills/{billId}/attachments","href":"bills-attachments/billscontroller_addbillattachment","openApiOperationId":"BillsController_addBillAttachment","summary":"Attach an uploaded file to a bill"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddBillAttachmentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddBillAttachmentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1bills~1{billId}~1attachments/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bills-attachments/billscontroller_addbillattachment"}],"panels":[]}]},"httpPath":"/bills/{billId}/attachments"}],"content":{"contentType":"group","meta":{"name":"bills-attachments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bills · Attachments","showPageActions":true},{"nodeType":"markdoc","content":"Upload and attach bill files. Back-office / secondary."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bills/upload","summary":"Upload a bill attachment file and get its URL","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-attachments/billscontroller_uploadbillfile","deprecated":false},{"title":"/bills/{billId}/attachments","summary":"Attach an uploaded file to a bill","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bills-attachments/billscontroller_addbillattachment","deprecated":false}]}]}]}]}},{"type":"group","label":"payments","link":"/v2/openapi/payments","routeSlug":"/v2/openapi/payments","items":[{"label":"Get payment channels for a country","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_getpaymentchannels","routeSlug":"/v2/openapi/payments/paymentscontroller_getpaymentchannels","metadata":{"seo":{"title":"Get payment channels for a country","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_getPaymentChannels","name":"Get payment channels for a country","isWebhook":false,"pointer":"/paths/~1payments~1channels/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get payment channels for a country","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get payment channels for a country"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"country","in":"query","schemaId":"schema_112","description":"Country code (e.g., KENYA)","required":true}],"pointer":"/paths/~1payments~1channels/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1channels/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payments/channels","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"country","in":"query","required":true,"example":"KENYA","schemaId":"schema_112"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:read"]}],"responseCodes":["200","400"],"pointer":"/payments/channels","href":"payments/paymentscontroller_getpaymentchannels","openApiOperationId":"PaymentsController_getPaymentChannels","summary":"Get payment channels for a country"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment channels retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentChannelsResponseV1Dto"}},"schemaId":"components/schemas/PaymentChannelsResponseV1Dto"},{"code":"400","description":"Bad Request - Missing country parameter"}],"pointer":"/paths/~1payments~1channels/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentChannelsResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentChannelsResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_getpaymentchannels"}],"panels":[]}]},"httpPath":"/payments/channels"},{"label":"List bulk payments with pagination","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_listpayments","routeSlug":"/v2/openapi/payments/paymentscontroller_listpayments","metadata":{"seo":{"title":"List bulk payments with pagination","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_listPayments","name":"List bulk payments with pagination","isWebhook":false,"pointer":"/paths/~1payments/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List bulk payments with pagination","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List bulk payments with pagination"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"},{"name":"per_page","in":"query","schemaId":"schema_109","description":"Items per page (max 100)"},{"name":"status","in":"query","schemaId":"schema_113","description":"Payment status filter"},{"name":"from","in":"query","schemaId":"schema_114","description":"From Date"},{"name":"to","in":"query","schemaId":"schema_115","description":"To Date"},{"name":"account","in":"query","schemaId":"schema_116","description":"Account filter"},{"name":"channel","in":"query","schemaId":"schema_116","description":"Payment channel filter"},{"name":"all_currency","in":"query","schemaId":"schema_117","description":"Fetch across all currencies"}],"pointer":"/paths/~1payments/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payments","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"per_page","in":"query","required":false,"example":25,"schemaId":"schema_109"},{"name":"status","in":"query","required":false,"schemaId":"schema_113"},{"name":"from","in":"query","required":false,"example":"2026-02-01 00:00","schemaId":"schema_114"},{"name":"to","in":"query","required":false,"example":"2026-02-07 23:59","schemaId":"schema_115"},{"name":"account","in":"query","required":false,"example":"all","schemaId":"schema_116"},{"name":"channel","in":"query","required":false,"example":"all","schemaId":"schema_116"},{"name":"all_currency","in":"query","required":false,"example":"true","schemaId":"schema_117"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:read"]}],"responseCodes":["200","400"],"pointer":"/payments","href":"payments/paymentscontroller_listpayments","openApiOperationId":"PaymentsController_listPayments","summary":"List bulk payments with pagination"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of bulk payments","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedPaymentsResponseV1Dto"}},"schemaId":"components/schemas/PaginatedPaymentsResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid parameters"}],"pointer":"/paths/~1payments/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedPaymentsResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedPaymentsResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_listpayments"}],"panels":[]}]},"httpPath":"/payments"},{"label":"Create bulk payout","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_createbulkpayout","routeSlug":"/v2/openapi/payments/paymentscontroller_createbulkpayout","metadata":{"seo":{"title":"Create bulk payout","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_createBulkPayout","name":"Create bulk payout","isWebhook":false,"pointer":"/paths/~1payments/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create bulk payout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create bulk payout"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBulkPayoutV1Dto"}},"schemaId":"components/schemas/CreateBulkPayoutV1Dto","pointer":"/paths/~1payments/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBulkPayoutV1Dto"}},"responseCodes":["201","400"],"pointer":"/payments","href":"payments/paymentscontroller_createbulkpayout","openApiOperationId":"PaymentsController_createBulkPayout","summary":"Create bulk payout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateBulkPayoutV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBulkPayoutV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Bulk payout batch created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}},"schemaId":"components/schemas/BulkPaymentV1Dto"},{"code":"400","description":"Bad Request - Invalid input or validation errors"}],"pointer":"/paths/~1payments/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BulkPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_createbulkpayout"}],"panels":[]}]},"httpPath":"/payments"},{"label":"Get banks for a country","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_getbanks","routeSlug":"/v2/openapi/payments/paymentscontroller_getbanks","metadata":{"seo":{"title":"Get banks for a country","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_getBanks","name":"Get banks for a country","isWebhook":false,"pointer":"/paths/~1payments~1banks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get banks for a country","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get banks for a country"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"country","in":"query","schemaId":"schema_112","description":"Country code (e.g., KENYA)","required":true}],"pointer":"/paths/~1payments~1banks/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1banks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payments/banks","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"country","in":"query","required":true,"example":"KENYA","schemaId":"schema_112"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:read"]}],"responseCodes":["200","400"],"pointer":"/payments/banks","href":"payments/paymentscontroller_getbanks","openApiOperationId":"PaymentsController_getBanks","summary":"Get banks for a country"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Banks retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_118"}},"schemaId":"schema_118"},{"code":"400","description":"Bad Request - Missing country parameter"}],"pointer":"/paths/~1payments~1banks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_118","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_118"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_getbanks"}],"panels":[]}]},"httpPath":"/payments/banks"},{"label":"Create payment intent","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_createpaymentintent","routeSlug":"/v2/openapi/payments/paymentscontroller_createpaymentintent","metadata":{"seo":{"title":"Create payment intent","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_createPaymentIntent","name":"Create payment intent","isWebhook":false,"pointer":"/paths/~1payments~1intent/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create payment intent","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create payment intent"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1intent/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePaymentIntentV1Dto"}},"schemaId":"components/schemas/CreatePaymentIntentV1Dto","pointer":"/paths/~1payments~1intent/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/intent","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePaymentIntentV1Dto"}},"responseCodes":["201","400"],"pointer":"/payments/intent","href":"payments/paymentscontroller_createpaymentintent","openApiOperationId":"PaymentsController_createPaymentIntent","summary":"Create payment intent"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreatePaymentIntentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePaymentIntentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payment intent created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentIntentResponseV1Dto"}},"schemaId":"components/schemas/PaymentIntentResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid input"}],"pointer":"/paths/~1payments~1intent/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/PaymentIntentResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentIntentResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_createpaymentintent"}],"panels":[]}]},"httpPath":"/payments/intent"},{"label":"Confirm payment intent with OTP","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_confirmpaymentintent","routeSlug":"/v2/openapi/payments/paymentscontroller_confirmpaymentintent","metadata":{"seo":{"title":"Confirm payment intent with OTP","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_confirmPaymentIntent","name":"Confirm payment intent with OTP","isWebhook":false,"pointer":"/paths/~1payments~1confirm/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Confirm payment intent with OTP","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Confirm payment intent with OTP"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1confirm/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConfirmPaymentIntentV1Dto"}},"schemaId":"components/schemas/ConfirmPaymentIntentV1Dto","pointer":"/paths/~1payments~1confirm/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/confirm","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ConfirmPaymentIntentV1Dto"}},"responseCodes":["200","400","401"],"pointer":"/payments/confirm","href":"payments/paymentscontroller_confirmpaymentintent","openApiOperationId":"PaymentsController_confirmPaymentIntent","summary":"Confirm payment intent with OTP"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ConfirmPaymentIntentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConfirmPaymentIntentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment confirmed successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentConfirmationResponseV1Dto"}},"schemaId":"components/schemas/PaymentConfirmationResponseV1Dto"},{"code":"400","description":"Bad Request - Intent expired or invalid"},{"code":"401","description":"Unauthorized - Invalid OTP or secret"}],"pointer":"/paths/~1payments~1confirm/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentConfirmationResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentConfirmationResponseV1Dto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_confirmpaymentintent"}],"panels":[]}]},"httpPath":"/payments/confirm"},{"label":"Request M-Pesa STK push payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_requestmpesapayment","routeSlug":"/v2/openapi/payments/paymentscontroller_requestmpesapayment","metadata":{"seo":{"title":"Request M-Pesa STK push payment","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_requestMpesaPayment","name":"Request M-Pesa STK push payment","isWebhook":false,"pointer":"/paths/~1payments~1request-mpesa-payment/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request M-Pesa STK push payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request M-Pesa STK push payment"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1request-mpesa-payment/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestMpesaPaymentV1Dto"}},"schemaId":"components/schemas/RequestMpesaPaymentV1Dto","pointer":"/paths/~1payments~1request-mpesa-payment/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/request-mpesa-payment","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RequestMpesaPaymentV1Dto"}},"responseCodes":["200","400"],"pointer":"/payments/request-mpesa-payment","href":"payments/paymentscontroller_requestmpesapayment","openApiOperationId":"PaymentsController_requestMpesaPayment","summary":"Request M-Pesa STK push payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RequestMpesaPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestMpesaPaymentV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"M-Pesa payment request initiated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MpesaPaymentResponseV1Dto"}},"schemaId":"components/schemas/MpesaPaymentResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid parameters"}],"pointer":"/paths/~1payments~1request-mpesa-payment/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MpesaPaymentResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MpesaPaymentResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_requestmpesapayment"}],"panels":[]}]},"httpPath":"/payments/request-mpesa-payment"},{"label":"Initiate draft payout","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_initiatedraftpayout","routeSlug":"/v2/openapi/payments/paymentscontroller_initiatedraftpayout","metadata":{"seo":{"title":"Initiate draft payout","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_initiateDraftPayout","name":"Initiate draft payout","isWebhook":false,"pointer":"/paths/~1payments~1{batch_no}~1initiate/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Initiate draft payout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Initiate draft payout"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"batch_no","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1payments~1{batch_no}~1initiate/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1{batch_no}~1initiate/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InitiateBulkPayoutV1Dto"}},"schemaId":"components/schemas/InitiateBulkPayoutV1Dto","pointer":"/paths/~1payments~1{batch_no}~1initiate/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payments/{batch_no}/initiate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"batch_no","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/InitiateBulkPayoutV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/payments/{batch_no}/initiate","href":"payments/paymentscontroller_initiatedraftpayout","openApiOperationId":"PaymentsController_initiateDraftPayout","summary":"Initiate draft payout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/InitiateBulkPayoutV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InitiateBulkPayoutV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout initiated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}},"schemaId":"components/schemas/BulkPaymentV1Dto"},{"code":"400","description":"Bad Request - Invalid batch number or batch not in draft status"},{"code":"404","description":"Not Found - Batch number does not exist"}],"pointer":"/paths/~1payments~1{batch_no}~1initiate/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BulkPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_initiatedraftpayout"}],"panels":[]}]},"httpPath":"/payments/{batch_no}/initiate"},{"label":"Return payout to draft status","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_cancelpayout","routeSlug":"/v2/openapi/payments/paymentscontroller_cancelpayout","metadata":{"seo":{"title":"Return payout to draft status","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_cancelPayout","name":"Return payout to draft status","isWebhook":false,"pointer":"/paths/~1payments~1{batch_no}~1draft/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Return payout to draft status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return payout to draft status"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"batch_no","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1payments~1{batch_no}~1draft/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1{batch_no}~1draft/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payments/{batch_no}/draft","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"batch_no","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"responseCodes":["200","400","404"],"pointer":"/payments/{batch_no}/draft","href":"payments/paymentscontroller_cancelpayout","openApiOperationId":"PaymentsController_cancelPayout","summary":"Return payout to draft status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout returned to draft","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}},"schemaId":"components/schemas/BulkPaymentV1Dto"},{"code":"400","description":"Bad Request - Invalid batch number"},{"code":"404","description":"Not Found - Batch number does not exist"}],"pointer":"/paths/~1payments~1{batch_no}~1draft/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BulkPaymentV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkPaymentV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_cancelpayout"}],"panels":[]}]},"httpPath":"/payments/{batch_no}/draft"},{"label":"cancel a payout batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/payments/paymentscontroller_rejectpayout","routeSlug":"/v2/openapi/payments/paymentscontroller_rejectpayout","metadata":{"seo":{"title":"cancel a payout batch","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PaymentsController_rejectPayout","name":"cancel a payout batch","isWebhook":false,"pointer":"/paths/~1payments~1payout~1cancel/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"cancel a payout batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cancel a payout batch"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["payments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1payments~1payout~1cancel/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPayoutV1Dto"}},"schemaId":"components/schemas/RejectPayoutV1Dto","pointer":"/paths/~1payments~1payout~1cancel/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/payout/cancel","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["payments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectPayoutV1Dto"}},"responseCodes":["200","400","401","404"],"pointer":"/payments/payout/cancel","href":"payments/paymentscontroller_rejectpayout","openApiOperationId":"PaymentsController_rejectPayout","summary":"cancel a payout batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectPayoutV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPayoutV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout rejected successfully"},{"code":"400","description":"Bad Request - Invalid ref/reason or validation error"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"},{"code":"404","description":"Payout batch not found"}],"pointer":"/paths/~1payments~1payout~1cancel/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payments/paymentscontroller_rejectpayout"}],"panels":[]}]},"httpPath":"/payments/payout/cancel"}],"content":{"contentType":"group","meta":{"name":"payments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"payments","showPageActions":true},{"nodeType":"markdoc","content":"Payouts and disbursements. Private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payments/channels","summary":"Get payment channels for a country","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payments/paymentscontroller_getpaymentchannels","deprecated":false},{"title":"/payments","summary":"List bulk payments with pagination","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payments/paymentscontroller_listpayments","deprecated":false},{"title":"/payments","summary":"Create bulk payout","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payments/paymentscontroller_createbulkpayout","deprecated":false},{"title":"/payments/banks","summary":"Get banks for a country","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payments/paymentscontroller_getbanks","deprecated":false},{"title":"/payments/intent","summary":"Create payment intent","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payments/paymentscontroller_createpaymentintent","deprecated":false},{"title":"/payments/confirm","summary":"Confirm payment intent with OTP","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payments/paymentscontroller_confirmpaymentintent","deprecated":false},{"title":"/payments/request-mpesa-payment","summary":"Request M-Pesa STK push payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payments/paymentscontroller_requestmpesapayment","deprecated":false},{"title":"/payments/{batch_no}/initiate","summary":"Initiate draft payout","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payments/paymentscontroller_initiatedraftpayout","deprecated":false},{"title":"/payments/{batch_no}/draft","summary":"Return payout to draft status","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payments/paymentscontroller_cancelpayout","deprecated":false},{"title":"/payments/payout/cancel","summary":"cancel a payout batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payments/paymentscontroller_rejectpayout","deprecated":false}]}]}]}]}},{"type":"group","label":"approvals","link":"/v2/openapi/approvals","routeSlug":"/v2/openapi/approvals","items":[{"label":"List all approvals with filtering and pagination","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/approvals/approvalscontroller_listapprovals","routeSlug":"/v2/openapi/approvals/approvalscontroller_listapprovals","metadata":{"seo":{"title":"List all approvals with filtering and pagination","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ApprovalsController_listApprovals","name":"List all approvals with filtering and pagination","isWebhook":false,"pointer":"/paths/~1approvals~1all/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all approvals with filtering and pagination","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all approvals with filtering and pagination"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["approvals:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_119","description":"Approval status (PENDING, APPROVED, REJECTED, CANCELLED, DRAFT)"},{"name":"page","in":"query","schemaId":"schema_120","description":"Page number for pagination"},{"name":"limit","in":"query","schemaId":"schema_121","description":"Number of items per page"},{"name":"action_type","in":"query","schemaId":"schema_122","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by approval action type (e.g., PAYOUT, INVOICE, SUBSCRIPTION_REQUEST)"},"children":[]}]}]}]},{"name":"from","in":"query","schemaId":"schema_123","description":"Start date filter (ISO format)"},{"name":"to","in":"query","schemaId":"schema_124","description":"End date filter (ISO format)"}],"pointer":"/paths/~1approvals~1all/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1approvals~1all/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/approvals/all","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_119"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_120"},{"name":"limit","in":"query","required":false,"example":100,"schemaId":"schema_121"},{"name":"action_type","in":"query","required":false,"schemaId":"schema_122"},{"name":"from","in":"query","required":false,"example":"2026-01-01","schemaId":"schema_123"},{"name":"to","in":"query","required":false,"example":"2026-12-31","schemaId":"schema_124"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["approvals:read"]}],"responseCodes":["200","400","401"],"pointer":"/approvals/all","href":"approvals/approvalscontroller_listapprovals","openApiOperationId":"ApprovalsController_listApprovals","summary":"List all approvals with filtering and pagination"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of approvals","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedApprovalsResponseDto"}},"schemaId":"components/schemas/PaginatedApprovalsResponseDto"},{"code":"400","description":"Bad Request - Invalid query parameters"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"}],"pointer":"/paths/~1approvals~1all/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedApprovalsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedApprovalsResponseDto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/approvals/approvalscontroller_listapprovals"}],"panels":[]}]},"httpPath":"/approvals/all"},{"label":"List approvals with UX-friendly digest format","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/approvals/approvalscontroller_listapprovalsdigest","routeSlug":"/v2/openapi/approvals/approvalscontroller_listapprovalsdigest","metadata":{"seo":{"title":"List approvals with UX-friendly digest format","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ApprovalsController_listApprovalsDigest","name":"List approvals with UX-friendly digest format","isWebhook":false,"pointer":"/paths/~1approvals~1all~1digest/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List approvals with UX-friendly digest format","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns approvals transformed into a UX-friendly format with risk scoring, approval chain tracking, urgency flags, and recommended actions."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["approvals:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_119","description":"Approval status (PENDING, APPROVED, REJECTED, CANCELLED, DRAFT)"},{"name":"page","in":"query","schemaId":"schema_120","description":"Page number for pagination"},{"name":"limit","in":"query","schemaId":"schema_121","description":"Number of items per page"},{"name":"action_type","in":"query","schemaId":"schema_122","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by approval action type (e.g., PAYOUT, INVOICE, SUBSCRIPTION_REQUEST)"},"children":[]}]}]}]},{"name":"from","in":"query","schemaId":"schema_123","description":"Start date filter (ISO format)"},{"name":"to","in":"query","schemaId":"schema_124","description":"End date filter (ISO format)"}],"pointer":"/paths/~1approvals~1all~1digest/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1approvals~1all~1digest/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/approvals/all/digest","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_119"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_120"},{"name":"limit","in":"query","required":false,"example":100,"schemaId":"schema_121"},{"name":"action_type","in":"query","required":false,"schemaId":"schema_122"},{"name":"from","in":"query","required":false,"example":"2026-01-01","schemaId":"schema_123"},{"name":"to","in":"query","required":false,"example":"2026-12-31","schemaId":"schema_124"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["approvals:read"]}],"responseCodes":["200","400","401"],"pointer":"/approvals/all/digest","href":"approvals/approvalscontroller_listapprovalsdigest","openApiOperationId":"ApprovalsController_listApprovalsDigest","summary":"List approvals with UX-friendly digest format"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of approvals in digest format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedApprovalsDigestResponseDto"}},"schemaId":"components/schemas/PaginatedApprovalsDigestResponseDto"},{"code":"400","description":"Bad Request - Invalid query parameters"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"}],"pointer":"/paths/~1approvals~1all~1digest/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedApprovalsDigestResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedApprovalsDigestResponseDto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/approvals/approvalscontroller_listapprovalsdigest"}],"panels":[]}]},"httpPath":"/approvals/all/digest"},{"label":"Approve a payment request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/approvals/approvalscontroller_approvepaymentrequest","routeSlug":"/v2/openapi/approvals/approvalscontroller_approvepaymentrequest","metadata":{"seo":{"title":"Approve a payment request","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ApprovalsController_approvePaymentRequest","name":"Approve a payment request","isWebhook":false,"pointer":"/paths/~1approvals~1approve/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve a payment request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approve a payment request"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["approvals:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1approvals~1approve/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApprovePaymentRequestDto"}},"schemaId":"components/schemas/ApprovePaymentRequestDto","pointer":"/paths/~1approvals~1approve/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/approvals/approve","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["approvals:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ApprovePaymentRequestDto"}},"responseCodes":["200","400","401","404"],"pointer":"/approvals/approve","href":"approvals/approvalscontroller_approvepaymentrequest","openApiOperationId":"ApprovalsController_approvePaymentRequest","summary":"Approve a payment request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ApprovePaymentRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApprovePaymentRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment request approved successfully"},{"code":"400","description":"Bad Request - Invalid ref or validation error"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"},{"code":"404","description":"Payment request not found"}],"pointer":"/paths/~1approvals~1approve/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/approvals/approvalscontroller_approvepaymentrequest"}],"panels":[]}]},"httpPath":"/approvals/approve"},{"label":"Reject a payment request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/approvals/approvalscontroller_rejectpaymentrequest","routeSlug":"/v2/openapi/approvals/approvalscontroller_rejectpaymentrequest","metadata":{"seo":{"title":"Reject a payment request","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ApprovalsController_rejectPaymentRequest","name":"Reject a payment request","isWebhook":false,"pointer":"/paths/~1approvals~1reject/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject a payment request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reject a payment request"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["approvals:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1approvals~1reject/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPaymentRequestDto"}},"schemaId":"components/schemas/RejectPaymentRequestDto","pointer":"/paths/~1approvals~1reject/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/approvals/reject","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["approvals:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectPaymentRequestDto"}},"responseCodes":["200","400","401","404"],"pointer":"/approvals/reject","href":"approvals/approvalscontroller_rejectpaymentrequest","openApiOperationId":"ApprovalsController_rejectPaymentRequest","summary":"Reject a payment request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectPaymentRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPaymentRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment request rejected successfully"},{"code":"400","description":"Bad Request - Invalid ref/reason or validation error"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"},{"code":"404","description":"Payment request not found"}],"pointer":"/paths/~1approvals~1reject/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/approvals/approvalscontroller_rejectpaymentrequest"}],"panels":[]}]},"httpPath":"/approvals/reject"},{"label":"Reject a bill payment","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/approvals/approvalscontroller_rejectbillpayment","routeSlug":"/v2/openapi/approvals/approvalscontroller_rejectbillpayment","metadata":{"seo":{"title":"Reject a bill payment","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ApprovalsController_rejectBillPayment","name":"Reject a bill payment","isWebhook":false,"pointer":"/paths/~1approvals~1bills~1reject/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject a bill payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reject a bill payment"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["approvals:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"billId","in":"query","schemaId":"schema_110","required":true},{"name":"paymentId","in":"query","schemaId":"schema_110","required":true}],"pointer":"/paths/~1approvals~1bills~1reject/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1approvals~1bills~1reject/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentDto"}},"schemaId":"components/schemas/RejectBillPaymentDto","pointer":"/paths/~1approvals~1bills~1reject/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/approvals/bills/reject","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"billId","in":"query","required":true,"schemaId":"schema_110"},{"name":"paymentId","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["approvals:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentDto"}},"responseCodes":["200","400","401","404"],"pointer":"/approvals/bills/reject","href":"approvals/approvalscontroller_rejectbillpayment","openApiOperationId":"ApprovalsController_rejectBillPayment","summary":"Reject a bill payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectBillPaymentDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectBillPaymentDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Bill payment rejected successfully"},{"code":"400","description":"Bad Request - Invalid billId/paymentId or validation error"},{"code":"401","description":"Unauthorized - Missing or invalid bearer token"},{"code":"404","description":"Bill payment not found"}],"pointer":"/paths/~1approvals~1bills~1reject/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/approvals/approvalscontroller_rejectbillpayment"}],"panels":[]}]},"httpPath":"/approvals/bills/reject"}],"content":{"contentType":"group","meta":{"name":"approvals"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"approvals","showPageActions":true},{"nodeType":"markdoc","content":"Approve or reject requests. Private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/approvals/all","summary":"List all approvals with filtering and pagination","prefix":{"name":"get","color":"get"},"badges":[],"link":"/approvals/approvalscontroller_listapprovals","deprecated":false},{"title":"/approvals/all/digest","summary":"List approvals with UX-friendly digest format","prefix":{"name":"get","color":"get"},"badges":[],"link":"/approvals/approvalscontroller_listapprovalsdigest","deprecated":false},{"title":"/approvals/approve","summary":"Approve a payment request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/approvals/approvalscontroller_approvepaymentrequest","deprecated":false},{"title":"/approvals/reject","summary":"Reject a payment request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/approvals/approvalscontroller_rejectpaymentrequest","deprecated":false},{"title":"/approvals/bills/reject","summary":"Reject a bill payment","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/approvals/approvalscontroller_rejectbillpayment","deprecated":false}]}]}]}]}},{"type":"group","label":"fx","link":"/v2/openapi/fx","routeSlug":"/v2/openapi/fx","items":[{"label":"Get current FX conversion rate","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/fx/fxcontroller_getconversionrate","routeSlug":"/v2/openapi/fx/fxcontroller_getconversionrate","metadata":{"seo":{"title":"Get current FX conversion rate","description":"Returns the current exchange rate between two currencies, including buy/sell markup."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"FxController_getConversionRate","name":"Get current FX conversion rate","isWebhook":false,"pointer":"/paths/~1fx~1conversion-rate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get current FX conversion rate","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the current exchange rate between two currencies, including buy/sell markup."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["fx:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1fx~1conversion-rate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConversionRateRequestV1Dto"}},"schemaId":"components/schemas/ConversionRateRequestV1Dto","pointer":"/paths/~1fx~1conversion-rate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/fx/conversion-rate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["fx:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ConversionRateRequestV1Dto"}},"responseCodes":["200","400","401"],"pointer":"/fx/conversion-rate","href":"fx/fxcontroller_getconversionrate","openApiOperationId":"FxController_getConversionRate","summary":"Get current FX conversion rate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ConversionRateRequestV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConversionRateRequestV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Conversion rate returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionRateResponseV1Dto"}},"schemaId":"components/schemas/ConversionRateResponseV1Dto"},{"code":"400","description":"Bad Request"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1fx~1conversion-rate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ConversionRateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionRateResponseV1Dto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fx/fxcontroller_getconversionrate"}],"panels":[]}]},"httpPath":"/fx/conversion-rate"},{"label":"Get historic FX rate","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/fx/fxcontroller_gethistoricrate","routeSlug":"/v2/openapi/fx/fxcontroller_gethistoricrate","metadata":{"seo":{"title":"Get historic FX rate","description":"Returns the exchange rate between two currencies for a specific historical date."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"FxController_getHistoricRate","name":"Get historic FX rate","isWebhook":false,"pointer":"/paths/~1fx~1historic-rate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get historic FX rate","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the exchange rate between two currencies for a specific historical date."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["fx:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1fx~1historic-rate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/HistoricRateRequestV1Dto"}},"schemaId":"components/schemas/HistoricRateRequestV1Dto","pointer":"/paths/~1fx~1historic-rate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/fx/historic-rate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["fx:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/HistoricRateRequestV1Dto"}},"responseCodes":["200","400","401"],"pointer":"/fx/historic-rate","href":"fx/fxcontroller_gethistoricrate","openApiOperationId":"FxController_getHistoricRate","summary":"Get historic FX rate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/HistoricRateRequestV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/HistoricRateRequestV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Historic rate returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionRateResponseV1Dto"}},"schemaId":"components/schemas/ConversionRateResponseV1Dto"},{"code":"400","description":"Bad Request"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1fx~1historic-rate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ConversionRateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionRateResponseV1Dto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fx/fxcontroller_gethistoricrate"}],"panels":[]}]},"httpPath":"/fx/historic-rate"},{"label":"Fetch available FX currencies","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/fx/fxcontroller_fetchcurrencies","routeSlug":"/v2/openapi/fx/fxcontroller_fetchcurrencies","metadata":{"seo":{"title":"Fetch available FX currencies","description":"Returns all currencies available for foreign exchange operations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"FxController_fetchCurrencies","name":"Fetch available FX currencies","isWebhook":false,"pointer":"/paths/~1fx~1currencies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch available FX currencies","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns all currencies available for foreign exchange operations."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["fx:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1fx~1currencies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/fx/currencies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["fx:read"]}],"responseCodes":["200","401"],"pointer":"/fx/currencies","href":"fx/fxcontroller_fetchcurrencies","openApiOperationId":"FxController_fetchCurrencies","summary":"Fetch available FX currencies"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Currencies returned successfully"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1fx~1currencies/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fx/fxcontroller_fetchcurrencies"}],"panels":[]}]},"httpPath":"/fx/currencies"},{"label":"Execute FX transfer between wallets","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/fx/fxcontroller_createfxtransfer","routeSlug":"/v2/openapi/fx/fxcontroller_createfxtransfer","metadata":{"seo":{"title":"Execute FX transfer between wallets","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"FxController_createFxTransfer","name":"Execute FX transfer between wallets","isWebhook":false,"pointer":"/paths/~1fx~1transfer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Execute FX transfer between wallets","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Performs an internal fund transfer between two wallets with FX conversion. Auto-generates a reference if not provided."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["fx:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1fx~1transfer/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FxTransferRequestV1Dto"}},"schemaId":"components/schemas/FxTransferRequestV1Dto","pointer":"/paths/~1fx~1transfer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/fx/transfer","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["fx:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/FxTransferRequestV1Dto"}},"responseCodes":["200","400","401"],"pointer":"/fx/transfer","href":"fx/fxcontroller_createfxtransfer","openApiOperationId":"FxController_createFxTransfer","summary":"Execute FX transfer between wallets"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/FxTransferRequestV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FxTransferRequestV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"FX transfer completed successfully"},{"code":"400","description":"Bad Request"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1fx~1transfer/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fx/fxcontroller_createfxtransfer"}],"panels":[]}]},"httpPath":"/fx/transfer"}],"content":{"contentType":"group","meta":{"name":"fx"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"fx","showPageActions":true},{"nodeType":"markdoc","content":"Foreign-exchange rates. FX transfers are private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/fx/conversion-rate","summary":"Get current FX conversion rate","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fx/fxcontroller_getconversionrate","deprecated":false},{"title":"/fx/historic-rate","summary":"Get historic FX rate","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fx/fxcontroller_gethistoricrate","deprecated":false},{"title":"/fx/currencies","summary":"Fetch available FX currencies","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fx/fxcontroller_fetchcurrencies","deprecated":false},{"title":"/fx/transfer","summary":"Execute FX transfer between wallets","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fx/fxcontroller_createfxtransfer","deprecated":false}]}]}]}]}},{"type":"separator","label":"Spend & cards","content":null},{"type":"group","label":"Expenses · Retrieve","link":"/v2/openapi/expenses","routeSlug":"/v2/openapi/expenses","items":[{"label":"List expenses (role-scoped)","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses/expensescontroller_listuserexpenses","routeSlug":"/v2/openapi/expenses/expensescontroller_listuserexpenses","metadata":{"seo":{"title":"List expenses (role-scoped)","description":"Returns a paginated list of expenses filtered by the caller's role."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_listUserExpenses","name":"List expenses (role-scoped)","isWebhook":false,"pointer":"/paths/~1expenses/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List expenses (role-scoped)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a paginated list of expenses filtered by the caller's role."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CARD USER"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" – own expenses only"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"REVIEWER"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" – expenses belonging to teams the reviewer manages"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ADMIN / APPROVER / SUPER ADMIN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" – all business expenses"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For dashboard roles, expenses are fetched across "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"all business currency wallets"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in parallel and merged. Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accountref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to restrict results to a single currency wallet."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"},{"name":"accountref","in":"query","schemaId":"schema_126","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Wallet org_wallet_ref to scope expenses to a specific currency. When omitted, all business currency wallets are fetched and merged."},"children":[]}]}]}]},{"name":"to","in":"query","schemaId":"schema_127","description":"End date for filtering expenses (ISO 8601, e.g. 2026-04-30)"},{"name":"from","in":"query","schemaId":"schema_123","description":"Start date for filtering expenses (ISO 8601, e.g. 2026-01-01)"}],"pointer":"/paths/~1expenses/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"},{"name":"accountref","in":"query","required":false,"example":"1","schemaId":"schema_126"},{"name":"to","in":"query","required":false,"example":"2026-04-30","schemaId":"schema_127"},{"name":"from","in":"query","required":false,"example":"2026-01-01","schemaId":"schema_123"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200","400","401","403"],"pointer":"/expenses","href":"expenses/expensescontroller_listuserexpenses","openApiOperationId":"ExpensesController_listUserExpenses","summary":"List expenses (role-scoped)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of expenses scoped to the caller's role","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}},"schemaId":"components/schemas/PaginatedExpenseResponseDto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request – invalid page or limit parameters"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid bearer token"},"children":[]}]}]}]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – valid token but insufficient permissions"},"children":[]}]}]}]}],"pointer":"/paths/~1expenses/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedExpenseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}}},{"code":"400"},{"code":"401"},{"code":"403"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses/expensescontroller_listuserexpenses"}],"panels":[]}]},"httpPath":"/expenses"},{"label":"Get expense by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses/expensescontroller_getexpense","routeSlug":"/v2/openapi/expenses/expensescontroller_getexpense","metadata":{"seo":{"title":"Get expense by ID","description":"Get expense by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getExpense","name":"Get expense by ID","isWebhook":false,"pointer":"/paths/~1expenses~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get expense by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200"],"pointer":"/expenses/{id}","href":"expenses/expensescontroller_getexpense","openApiOperationId":"ExpensesController_getExpense","summary":"Get expense by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}},"schemaId":"components/schemas/ExpenseV1Dto"}],"pointer":"/paths/~1expenses~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExpenseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses/expensescontroller_getexpense"}],"panels":[]}]},"httpPath":"/expenses/{id}"},{"label":"Get expenses by category","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses/expensescontroller_getexpensesbycategory","routeSlug":"/v2/openapi/expenses/expensescontroller_getexpensesbycategory","metadata":{"seo":{"title":"Get expenses by category","description":"Get expenses by category"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getExpensesByCategory","name":"Get expenses by category","isWebhook":false,"pointer":"/paths/~1expenses~1byCategory~1{categoryId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get expenses by category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1byCategory~1{categoryId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1expenses~1byCategory~1{categoryId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1byCategory~1{categoryId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/byCategory/{categoryId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200","400"],"pointer":"/expenses/byCategory/{categoryId}","href":"expenses/expensescontroller_getexpensesbycategory","openApiOperationId":"ExpensesController_getExpensesByCategory","summary":"Get expenses by category"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of expenses by category","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}},"schemaId":"components/schemas/PaginatedExpenseResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1expenses~1byCategory~1{categoryId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedExpenseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses/expensescontroller_getexpensesbycategory"}],"panels":[]}]},"httpPath":"/expenses/byCategory/{categoryId}"},{"label":"Get expenses by subcategory _id","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses/expensescontroller_getexpensesbysubcategory","routeSlug":"/v2/openapi/expenses/expensescontroller_getexpensesbysubcategory","metadata":{"seo":{"title":"Get expenses by subcategory _id","description":"Get expenses by subcategory _id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getExpensesBySubCategory","name":"Get expenses by subcategory _id","isWebhook":false,"pointer":"/paths/~1expenses~1bySubCategory~1{subcategoryId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get expenses by subcategory _id","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"subcategoryId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1bySubCategory~1{subcategoryId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1expenses~1bySubCategory~1{subcategoryId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1bySubCategory~1{subcategoryId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/bySubCategory/{subcategoryId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"subcategoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200","400"],"pointer":"/expenses/bySubCategory/{subcategoryId}","href":"expenses/expensescontroller_getexpensesbysubcategory","openApiOperationId":"ExpensesController_getExpensesBySubCategory","summary":"Get expenses by subcategory _id"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of expenses by subcategory","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}},"schemaId":"components/schemas/PaginatedExpenseResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1expenses~1bySubCategory~1{subcategoryId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedExpenseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses/expensescontroller_getexpensesbysubcategory"}],"panels":[]}]},"httpPath":"/expenses/bySubCategory/{subcategoryId}"},{"label":"Get expenses by vendor","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses/expensescontroller_getexpensesbyvendor","routeSlug":"/v2/openapi/expenses/expensescontroller_getexpensesbyvendor","metadata":{"seo":{"title":"Get expenses by vendor","description":"Get expenses by vendor"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getExpensesByVendor","name":"Get expenses by vendor","isWebhook":false,"pointer":"/paths/~1expenses~1byVendor~1{vendor}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get expenses by vendor","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"vendor","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1byVendor~1{vendor}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1expenses~1byVendor~1{vendor}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1byVendor~1{vendor}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/byVendor/{vendor}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"vendor","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200","400"],"pointer":"/expenses/byVendor/{vendor}","href":"expenses/expensescontroller_getexpensesbyvendor","openApiOperationId":"ExpensesController_getExpensesByVendor","summary":"Get expenses by vendor"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of expenses by vendor","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}},"schemaId":"components/schemas/PaginatedExpenseResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1expenses~1byVendor~1{vendor}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedExpenseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpenseResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses/expensescontroller_getexpensesbyvendor"}],"panels":[]}]},"httpPath":"/expenses/byVendor/{vendor}"}],"content":{"contentType":"group","meta":{"name":"expenses"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Expenses · Retrieve","showPageActions":true},{"nodeType":"markdoc","content":"List, search, and read expenses."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/expenses","summary":"List expenses (role-scoped)","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses/expensescontroller_listuserexpenses","deprecated":false},{"title":"/expenses/{id}","summary":"Get expense by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses/expensescontroller_getexpense","deprecated":false},{"title":"/expenses/byCategory/{categoryId}","summary":"Get expenses by category","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses/expensescontroller_getexpensesbycategory","deprecated":false},{"title":"/expenses/bySubCategory/{subcategoryId}","summary":"Get expenses by subcategory _id","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses/expensescontroller_getexpensesbysubcategory","deprecated":false},{"title":"/expenses/byVendor/{vendor}","summary":"Get expenses by vendor","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses/expensescontroller_getexpensesbyvendor","deprecated":false}]}]}]}]}},{"type":"group","label":"Expenses · Review & approvals","link":"/v2/openapi/expenses-review","routeSlug":"/v2/openapi/expenses-review","items":[{"label":"Update an expense description or notes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_updateexpensenotes","routeSlug":"/v2/openapi/expenses-review/expensescontroller_updateexpensenotes","metadata":{"seo":{"title":"Update an expense description or notes","description":"Update an expense description or notes"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_updateExpenseNotes","name":"Update an expense description or notes","isWebhook":false,"pointer":"/paths/~1expenses~1notes~1{id}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an expense description or notes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1notes~1{id}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1notes~1{id}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExpenseNoteDto"}},"schemaId":"components/schemas/UpdateExpenseNoteDto","pointer":"/paths/~1expenses~1notes~1{id}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/notes/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateExpenseNoteDto"}},"responseCodes":["200"],"pointer":"/expenses/notes/{id}","href":"expenses-review/expensescontroller_updateexpensenotes","openApiOperationId":"ExpensesController_updateExpenseNotes","summary":"Update an expense description or notes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateExpenseNoteDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExpenseNoteDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}},"schemaId":"components/schemas/ExpenseV1Dto"}],"pointer":"/paths/~1expenses~1notes~1{id}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExpenseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_updateexpensenotes"}],"panels":[]}]},"httpPath":"/expenses/notes/{id}"},{"label":"Update expense subcategory","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_updateexpensesubcategory","routeSlug":"/v2/openapi/expenses-review/expensescontroller_updateexpensesubcategory","metadata":{"seo":{"title":"Update expense subcategory","description":"Update expense subcategory"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_updateExpenseSubcategory","name":"Update expense subcategory","isWebhook":false,"pointer":"/paths/~1expenses~1changeSubCategory~1{expenseId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update expense subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"expenseId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1changeSubCategory~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1changeSubCategory~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExpenseSubcategoryDto"}},"schemaId":"components/schemas/UpdateExpenseSubcategoryDto","pointer":"/paths/~1expenses~1changeSubCategory~1{expenseId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/changeSubCategory/{expenseId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"expenseId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateExpenseSubcategoryDto"}},"responseCodes":["200","400","404"],"pointer":"/expenses/changeSubCategory/{expenseId}","href":"expenses-review/expensescontroller_updateexpensesubcategory","openApiOperationId":"ExpensesController_updateExpenseSubcategory","summary":"Update expense subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateExpenseSubcategoryDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExpenseSubcategoryDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense subcategory updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}},"schemaId":"components/schemas/ExpenseV1Dto"},{"code":"400","description":"Bad Request - Invalid subcategory ID"},{"code":"404","description":"Expense not found"}],"pointer":"/paths/~1expenses~1changeSubCategory~1{expenseId}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExpenseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_updateexpensesubcategory"}],"panels":[]}]},"httpPath":"/expenses/changeSubCategory/{expenseId}"},{"label":"Approve multiple expenses","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_approvemultipleexpenses","routeSlug":"/v2/openapi/expenses-review/expensescontroller_approvemultipleexpenses","metadata":{"seo":{"title":"Approve multiple expenses","description":"Approve multiple expenses"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_approveMultipleExpenses","name":"Approve multiple expenses","isWebhook":false,"pointer":"/paths/~1expenses~1approve/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve multiple expenses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1approve/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApproveMultipleExpensesDto"}},"schemaId":"components/schemas/ApproveMultipleExpensesDto","pointer":"/paths/~1expenses~1approve/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/approve","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ApproveMultipleExpensesDto"}},"responseCodes":["200","400"],"pointer":"/expenses/approve","href":"expenses-review/expensescontroller_approvemultipleexpenses","openApiOperationId":"ExpensesController_approveMultipleExpenses","summary":"Approve multiple expenses"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ApproveMultipleExpensesDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApproveMultipleExpensesDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expenses approved successfully"},{"code":"400","description":"Bad Request - Invalid expense IDs or request body"}],"pointer":"/paths/~1expenses~1approve/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_approvemultipleexpenses"}],"panels":[]}]},"httpPath":"/expenses/approve"},{"label":"Approve single expense","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_approvesingleexpense","routeSlug":"/v2/openapi/expenses-review/expensescontroller_approvesingleexpense","metadata":{"seo":{"title":"Approve single expense","description":"Approve single expense"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_approveSingleExpense","name":"Approve single expense","isWebhook":false,"pointer":"/paths/~1expenses~1approve~1{expenseId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve single expense","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"expenseId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1approve~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1approve~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApproveRejectNotesDto"}},"schemaId":"components/schemas/ApproveRejectNotesDto","pointer":"/paths/~1expenses~1approve~1{expenseId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/approve/{expenseId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"expenseId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ApproveRejectNotesDto"}},"responseCodes":["200","404"],"pointer":"/expenses/approve/{expenseId}","href":"expenses-review/expensescontroller_approvesingleexpense","openApiOperationId":"ExpensesController_approveSingleExpense","summary":"Approve single expense"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ApproveRejectNotesDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApproveRejectNotesDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense approved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}},"schemaId":"components/schemas/ExpenseV1Dto"},{"code":"404","description":"Expense not found"}],"pointer":"/paths/~1expenses~1approve~1{expenseId}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExpenseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_approvesingleexpense"}],"panels":[]}]},"httpPath":"/expenses/approve/{expenseId}"},{"label":"Reject multiple expenses","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_rejectmultipleexpenses","routeSlug":"/v2/openapi/expenses-review/expensescontroller_rejectmultipleexpenses","metadata":{"seo":{"title":"Reject multiple expenses","description":"Reject multiple expenses"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_rejectMultipleExpenses","name":"Reject multiple expenses","isWebhook":false,"pointer":"/paths/~1expenses~1reject/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject multiple expenses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1reject/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectMultipleExpensesDto"}},"schemaId":"components/schemas/RejectMultipleExpensesDto","pointer":"/paths/~1expenses~1reject/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/reject","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectMultipleExpensesDto"}},"responseCodes":["200","400"],"pointer":"/expenses/reject","href":"expenses-review/expensescontroller_rejectmultipleexpenses","openApiOperationId":"ExpensesController_rejectMultipleExpenses","summary":"Reject multiple expenses"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectMultipleExpensesDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectMultipleExpensesDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expenses rejected successfully"},{"code":"400","description":"Bad Request - Invalid expense IDs or request body"}],"pointer":"/paths/~1expenses~1reject/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_rejectmultipleexpenses"}],"panels":[]}]},"httpPath":"/expenses/reject"},{"label":"Reject single expense","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_rejectsingleexpense","routeSlug":"/v2/openapi/expenses-review/expensescontroller_rejectsingleexpense","metadata":{"seo":{"title":"Reject single expense","description":"Reject single expense"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_rejectSingleExpense","name":"Reject single expense","isWebhook":false,"pointer":"/paths/~1expenses~1reject~1{expenseId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject single expense","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"expenseId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1reject~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1reject~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"schemaId":"components/schemas/RequestNotesDTO","pointer":"/paths/~1expenses~1reject~1{expenseId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/reject/{expenseId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"expenseId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"responseCodes":["200","404"],"pointer":"/expenses/reject/{expenseId}","href":"expenses-review/expensescontroller_rejectsingleexpense","openApiOperationId":"ExpensesController_rejectSingleExpense","summary":"Reject single expense"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RequestNotesDTO","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense rejected successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}},"schemaId":"components/schemas/ExpenseV1Dto"},{"code":"404","description":"Expense not found"}],"pointer":"/paths/~1expenses~1reject~1{expenseId}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExpenseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExpenseV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_rejectsingleexpense"}],"panels":[]}]},"httpPath":"/expenses/reject/{expenseId}"},{"label":"Request details for a specific expense with mandatory notes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-review/expensescontroller_requestexpensedetails","routeSlug":"/v2/openapi/expenses-review/expensescontroller_requestexpensedetails","metadata":{"seo":{"title":"Request details for a specific expense with mandatory notes","description":"Request details for a specific expense with mandatory notes"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_requestExpenseDetails","name":"Request details for a specific expense with mandatory notes","isWebhook":false,"pointer":"/paths/~1expenses~1requestDetails~1{expenseId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request details for a specific expense with mandatory notes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"expenseId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1requestDetails~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1requestDetails~1{expenseId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"schemaId":"components/schemas/RequestNotesDTO","pointer":"/paths/~1expenses~1requestDetails~1{expenseId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/requestDetails/{expenseId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"expenseId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"responseCodes":["200","400","404"],"pointer":"/expenses/requestDetails/{expenseId}","href":"expenses-review/expensescontroller_requestexpensedetails","openApiOperationId":"ExpensesController_requestExpenseDetails","summary":"Request details for a specific expense with mandatory notes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RequestNotesDTO","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestNotesDTO"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Expense details request submitted successfully"},{"code":"400","description":"Bad Request - Missing or invalid notes"},{"code":"404","description":"Expense not found"}],"pointer":"/paths/~1expenses~1requestDetails~1{expenseId}/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-review/expensescontroller_requestexpensedetails"}],"panels":[]}]},"httpPath":"/expenses/requestDetails/{expenseId}"}],"content":{"contentType":"group","meta":{"name":"expenses-review"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Expenses · Review & approvals","showPageActions":true},{"nodeType":"markdoc","content":"Approve, reject, request details, and annotate expenses under review."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/expenses/notes/{id}","summary":"Update an expense description or notes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_updateexpensenotes","deprecated":false},{"title":"/expenses/changeSubCategory/{expenseId}","summary":"Update expense subcategory","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_updateexpensesubcategory","deprecated":false},{"title":"/expenses/approve","summary":"Approve multiple expenses","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_approvemultipleexpenses","deprecated":false},{"title":"/expenses/approve/{expenseId}","summary":"Approve single expense","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_approvesingleexpense","deprecated":false},{"title":"/expenses/reject","summary":"Reject multiple expenses","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_rejectmultipleexpenses","deprecated":false},{"title":"/expenses/reject/{expenseId}","summary":"Reject single expense","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_rejectsingleexpense","deprecated":false},{"title":"/expenses/requestDetails/{expenseId}","summary":"Request details for a specific expense with mandatory notes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-review/expensescontroller_requestexpensedetails","deprecated":false}]}]}]}]}},{"type":"group","label":"Expenses · Reports","link":"/v2/openapi/expenses-reports","routeSlug":"/v2/openapi/expenses-reports","items":[{"label":"Get category report for expenses","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-reports/expensescontroller_getcategoryreport","routeSlug":"/v2/openapi/expenses-reports/expensescontroller_getcategoryreport","metadata":{"seo":{"title":"Get category report for expenses","description":"Get category report for expenses"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getCategoryReport","name":"Get category report for expenses","isWebhook":false,"pointer":"/paths/~1expenses~1category-report/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get category report for expenses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1category-report/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CategoryReportQueryV1Dto"}},"schemaId":"components/schemas/CategoryReportQueryV1Dto","pointer":"/paths/~1expenses~1category-report/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/category-report","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CategoryReportQueryV1Dto"}},"responseCodes":["200","400"],"pointer":"/expenses/category-report","href":"expenses-reports/expensescontroller_getcategoryreport","openApiOperationId":"ExpensesController_getCategoryReport","summary":"Get category report for expenses"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CategoryReportQueryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CategoryReportQueryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Category report generated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryReportResponseV1Dto"}},"schemaId":"components/schemas/CategoryReportResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid parameters"}],"pointer":"/paths/~1expenses~1category-report/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CategoryReportResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryReportResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-reports/expensescontroller_getcategoryreport"}],"panels":[]}]},"httpPath":"/expenses/category-report"},{"label":"Get hierarchical team-category-subcategory expense report","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-reports/expensescontroller_getteamcategoryreport","routeSlug":"/v2/openapi/expenses-reports/expensescontroller_getteamcategoryreport","metadata":{"seo":{"title":"Get hierarchical team-category-subcategory expense report","description":"Returns a hierarchical report of expenses grouped by team, category, and subcategory. Supports filtering by period, account reference, team code, and category."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getTeamCategoryReport","name":"Get hierarchical team-category-subcategory expense report","isWebhook":false,"pointer":"/paths/~1expenses~1team-category-report/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get hierarchical team-category-subcategory expense report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a hierarchical report of expenses grouped by team, category, and subcategory. Supports filtering by period, account reference, team code, and category. "},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1team-category-report/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TeamCategoryReportQueryV1Dto"}},"schemaId":"components/schemas/TeamCategoryReportQueryV1Dto","pointer":"/paths/~1expenses~1team-category-report/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/team-category-report","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TeamCategoryReportQueryV1Dto"}},"responseCodes":["200","400","401","403"],"pointer":"/expenses/team-category-report","href":"expenses-reports/expensescontroller_getteamcategoryreport","openApiOperationId":"ExpensesController_getTeamCategoryReport","summary":"Get hierarchical team-category-subcategory expense report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/TeamCategoryReportQueryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TeamCategoryReportQueryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Hierarchical expense report generated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamCategoryReportResponseV1Dto"}},"schemaId":"components/schemas/TeamCategoryReportResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid parameters"},{"code":"401","description":"Unauthorized - missing or invalid bearer token"},{"code":"403","description":"Forbidden - valid token but insufficient permissions"}],"pointer":"/paths/~1expenses~1team-category-report/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TeamCategoryReportResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamCategoryReportResponseV1Dto"}}},{"code":"400"},{"code":"401"},{"code":"403"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-reports/expensescontroller_getteamcategoryreport"}],"panels":[]}]},"httpPath":"/expenses/team-category-report"}],"content":{"contentType":"group","meta":{"name":"expenses-reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Expenses · Reports","showPageActions":true},{"nodeType":"markdoc","content":"Aggregate category and team-category expense reports."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/expenses/category-report","summary":"Get category report for expenses","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-reports/expensescontroller_getcategoryreport","deprecated":false},{"title":"/expenses/team-category-report","summary":"Get hierarchical team-category-subcategory expense report","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-reports/expensescontroller_getteamcategoryreport","deprecated":false}]}]}]}]}},{"type":"group","label":"Expenses · Exports","link":"/v2/openapi/expenses-exports","routeSlug":"/v2/openapi/expenses-exports","items":[{"label":"Start receipt export job","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-exports/expensescontroller_exportreceipts","routeSlug":"/v2/openapi/expenses-exports/expensescontroller_exportreceipts","metadata":{"seo":{"title":"Start receipt export job","description":"Forwards the receipt export request to the expenses service and returns a background job id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_exportReceipts","name":"Start receipt export job","isWebhook":false,"pointer":"/paths/~1expenses~1export-receipts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Start receipt export job","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Forwards the receipt export request to the expenses service and returns a background job id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1export-receipts/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ExportReceiptsDto"}},"schemaId":"components/schemas/ExportReceiptsDto","pointer":"/paths/~1expenses~1export-receipts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/expenses/export-receipts","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ExportReceiptsDto"}},"responseCodes":["202","403"],"pointer":"/expenses/export-receipts","href":"expenses-exports/expensescontroller_exportreceipts","openApiOperationId":"ExpensesController_exportReceipts","summary":"Start receipt export job"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ExportReceiptsDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ExportReceiptsDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Receipt export job accepted"},{"code":"403","description":"Forbidden - role is not allowed to export receipts"}],"pointer":"/paths/~1expenses~1export-receipts/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-exports/expensescontroller_exportreceipts"}],"panels":[]}]},"httpPath":"/expenses/export-receipts"},{"label":"Get receipt export job status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-exports/expensescontroller_getreceiptexportstatus","routeSlug":"/v2/openapi/expenses-exports/expensescontroller_getreceiptexportstatus","metadata":{"seo":{"title":"Get receipt export job status","description":"Returns progress, completion state, and download URL for a receipt export job."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_getReceiptExportStatus","name":"Get receipt export job status","isWebhook":false,"pointer":"/paths/~1expenses~1export-receipts~1status~1{jobId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get receipt export job status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns progress, completion state, and download URL for a receipt export job."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1export-receipts~1status~1{jobId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1export-receipts~1status~1{jobId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/export-receipts/status/{jobId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"jobId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200","403"],"pointer":"/expenses/export-receipts/status/{jobId}","href":"expenses-exports/expensescontroller_getreceiptexportstatus","openApiOperationId":"ExpensesController_getReceiptExportStatus","summary":"Get receipt export job status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Receipt export job status"},{"code":"403","description":"Forbidden - role is not allowed to access receipt export jobs"}],"pointer":"/paths/~1expenses~1export-receipts~1status~1{jobId}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-exports/expensescontroller_getreceiptexportstatus"}],"panels":[]}]},"httpPath":"/expenses/export-receipts/status/{jobId}"},{"label":"Get a signed download URL for an expense receipt","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/expenses-exports/expensescontroller_downloadexpensereceipt","routeSlug":"/v2/openapi/expenses-exports/expensescontroller_downloadexpensereceipt","metadata":{"seo":{"title":"Get a signed download URL for an expense receipt","description":"Get a signed download URL for an expense receipt"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ExpensesController_downloadExpenseReceipt","name":"Get a signed download URL for an expense receipt","isWebhook":false,"pointer":"/paths/~1expenses~1downloadExpenseReceipt~1{transactionRef}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a signed download URL for an expense receipt","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["expenses:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"transactionRef","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1expenses~1downloadExpenseReceipt~1{transactionRef}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1expenses~1downloadExpenseReceipt~1{transactionRef}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/expenses/downloadExpenseReceipt/{transactionRef}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"transactionRef","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["expenses:read"]}],"responseCodes":["200"],"pointer":"/expenses/downloadExpenseReceipt/{transactionRef}","href":"expenses-exports/expensescontroller_downloadexpensereceipt","openApiOperationId":"ExpensesController_downloadExpenseReceipt","summary":"Get a signed download URL for an expense receipt"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Signed receipt download URL"}],"pointer":"/paths/~1expenses~1downloadExpenseReceipt~1{transactionRef}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/expenses-exports/expensescontroller_downloadexpensereceipt"}],"panels":[]}]},"httpPath":"/expenses/downloadExpenseReceipt/{transactionRef}"}],"content":{"contentType":"group","meta":{"name":"expenses-exports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Expenses · Exports","showPageActions":true},{"nodeType":"markdoc","content":"Export and download expense receipts. Back-office / secondary."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/expenses/export-receipts","summary":"Start receipt export job","prefix":{"name":"post","color":"post"},"badges":[],"link":"/expenses-exports/expensescontroller_exportreceipts","deprecated":false},{"title":"/expenses/export-receipts/status/{jobId}","summary":"Get receipt export job status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses-exports/expensescontroller_getreceiptexportstatus","deprecated":false},{"title":"/expenses/downloadExpenseReceipt/{transactionRef}","summary":"Get a signed download URL for an expense receipt","prefix":{"name":"get","color":"get"},"badges":[],"link":"/expenses-exports/expensescontroller_downloadexpensereceipt","deprecated":false}]}]}]}]}},{"type":"group","label":"Cards · Manage","link":"/v2/openapi/cards","routeSlug":"/v2/openapi/cards","items":[{"label":"List user cards","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_listusercards","routeSlug":"/v2/openapi/cards/cardscontroller_listusercards","metadata":{"seo":{"title":"List user cards","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_listUserCards","name":"List user cards","isWebhook":false,"pointer":"/paths/~1cards/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List user cards","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List user cards"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1cards/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","400"],"pointer":"/cards","href":"cards/cardscontroller_listusercards","openApiOperationId":"CardsController_listUserCards","summary":"List user cards"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of user cards","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}},"schemaId":"components/schemas/PaginatedCardResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1cards/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedCardResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_listusercards"}],"panels":[]}]},"httpPath":"/cards"},{"label":"Create a new card","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_createcard","routeSlug":"/v2/openapi/cards/cardscontroller_createcard","metadata":{"seo":{"title":"Create a new card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_createCard","name":"Create a new card","isWebhook":false,"pointer":"/paths/~1cards/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new card"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCardV1Dto"}},"schemaId":"components/schemas/CreateCardV1Dto","pointer":"/paths/~1cards/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cards","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateCardV1Dto"}},"responseCodes":["201","400"],"pointer":"/cards","href":"cards/cardscontroller_createcard","openApiOperationId":"CardsController_createCard","summary":"Create a new card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateCardV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCardV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Card created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"400","description":"Bad Request - Invalid card data"}],"pointer":"/paths/~1cards/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_createcard"}],"panels":[]}]},"httpPath":"/cards"},{"label":"List cards for a specific employee","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_listemployeecards","routeSlug":"/v2/openapi/cards/cardscontroller_listemployeecards","metadata":{"seo":{"title":"List cards for a specific employee","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_listEmployeeCards","name":"List cards for a specific employee","isWebhook":false,"pointer":"/paths/~1cards~1employee~1{employeeId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List cards for a specific employee","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns paginated cards for the given employee. Accessible by CARD_USER and admin roles."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employeeId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1employee~1{employeeId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page"}],"pointer":"/paths/~1cards~1employee~1{employeeId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1employee~1{employeeId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/employee/{employeeId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employeeId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","400"],"pointer":"/cards/employee/{employeeId}","href":"cards/cardscontroller_listemployeecards","openApiOperationId":"CardsController_listEmployeeCards","summary":"List cards for a specific employee"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of employee cards","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}},"schemaId":"components/schemas/PaginatedCardResponseDto"},{"code":"400","description":"Bad Request"}],"pointer":"/paths/~1cards~1employee~1{employeeId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedCardResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_listemployeecards"}],"panels":[]}]},"httpPath":"/cards/employee/{employeeId}"},{"label":"List business cards","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_listbusinesscards","routeSlug":"/v2/openapi/cards/cardscontroller_listbusinesscards","metadata":{"seo":{"title":"List business cards","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_listBusinessCards","name":"List business cards","isWebhook":false,"pointer":"/paths/~1cards~1business/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List business cards","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List business cards"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1cards~1business/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1business/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/business","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","400"],"pointer":"/cards/business","href":"cards/cardscontroller_listbusinesscards","openApiOperationId":"CardsController_listBusinessCards","summary":"List business cards"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of user cards","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}},"schemaId":"components/schemas/PaginatedCardResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1cards~1business/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedCardResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCardResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_listbusinesscards"}],"panels":[]}]},"httpPath":"/cards/business"},{"label":"Get card by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_getcard","routeSlug":"/v2/openapi/cards/cardscontroller_getcard","metadata":{"seo":{"title":"Get card by ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getCard","name":"Get card by ID","isWebhook":false,"pointer":"/paths/~1cards~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get card by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get card by ID"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","404"],"pointer":"/cards/{id}","href":"cards/cardscontroller_getcard","openApiOperationId":"CardsController_getCard","summary":"Get card by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_getcard"}],"panels":[]}]},"httpPath":"/cards/{id}"},{"label":"Update card details","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_updatecard","routeSlug":"/v2/openapi/cards/cardscontroller_updatecard","metadata":{"seo":{"title":"Update card details","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_updateCard","name":"Update card details","isWebhook":false,"pointer":"/paths/~1cards~1{id}/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update card details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update card details"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/cards/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"responseCodes":["200","404"],"pointer":"/cards/{id}","href":"cards/cardscontroller_updatecard","openApiOperationId":"CardsController_updateCard","summary":"Update card details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_updatecard"}],"panels":[]}]},"httpPath":"/cards/{id}"},{"label":"Get card balance","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_getcardbalance","routeSlug":"/v2/openapi/cards/cardscontroller_getcardbalance","metadata":{"seo":{"title":"Get card balance","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getCardBalance","name":"Get card balance","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1balance/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get card balance","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get card balance"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1balance/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1balance/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/{id}/balance","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","404"],"pointer":"/cards/{id}/balance","href":"cards/cardscontroller_getcardbalance","openApiOperationId":"CardsController_getCardBalance","summary":"Get card balance"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card balance details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardBalanceDto"}},"schemaId":"components/schemas/CardBalanceDto"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1balance/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardBalanceDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardBalanceDto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_getcardbalance"}],"panels":[]}]},"httpPath":"/cards/{id}/balance"},{"label":"Get card transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards/cardscontroller_getcardtransactions","routeSlug":"/v2/openapi/cards/cardscontroller_getcardtransactions","metadata":{"seo":{"title":"Get card transactions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getCardTransactions","name":"Get card transactions","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get card transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get card transactions"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1cards~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/{id}/transactions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","400","404"],"pointer":"/cards/{id}/transactions","href":"cards/cardscontroller_getcardtransactions","openApiOperationId":"CardsController_getCardTransactions","summary":"Get card transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of card transactions"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1transactions/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards/cardscontroller_getcardtransactions"}],"panels":[]}]},"httpPath":"/cards/{id}/transactions"}],"content":{"contentType":"group","meta":{"name":"cards"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cards · Manage","showPageActions":true},{"nodeType":"markdoc","content":"Create, list, read, and update cards; balances and transactions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cards","summary":"List user cards","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_listusercards","deprecated":false},{"title":"/cards","summary":"Create a new card","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cards/cardscontroller_createcard","deprecated":false},{"title":"/cards/employee/{employeeId}","summary":"List cards for a specific employee","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_listemployeecards","deprecated":false},{"title":"/cards/business","summary":"List business cards","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_listbusinesscards","deprecated":false},{"title":"/cards/{id}","summary":"Get card by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_getcard","deprecated":false},{"title":"/cards/{id}","summary":"Update card details","prefix":{"name":"put","color":"put"},"badges":[],"link":"/cards/cardscontroller_updatecard","deprecated":false},{"title":"/cards/{id}/balance","summary":"Get card balance","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_getcardbalance","deprecated":false},{"title":"/cards/{id}/transactions","summary":"Get card transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards/cardscontroller_getcardtransactions","deprecated":false}]}]}]}]}},{"type":"group","label":"Cards · Controls","link":"/v2/openapi/cards-controls","routeSlug":"/v2/openapi/cards-controls","items":[{"label":"Block a card","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-controls/cardscontroller_blockcard","routeSlug":"/v2/openapi/cards-controls/cardscontroller_blockcard","metadata":{"seo":{"title":"Block a card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_blockCard","name":"Block a card","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1block/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Block a card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Blocks the card belonging to the authenticated employee. Accessible by CARD_USER and admin roles. The card must belong to the calling employee."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1block/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1block/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_128"}},"schemaId":"schema_128","pointer":"/paths/~1cards~1{id}~1block/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/cards/{id}/block","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"schema_128"}},"responseCodes":["200","403","404"],"pointer":"/cards/{id}/block","href":"cards-controls/cardscontroller_blockcard","openApiOperationId":"CardsController_blockCard","summary":"Block a card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"schema_128","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_128"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card blocked successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"403","description":"Card does not belong to this employee"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1block/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-controls/cardscontroller_blockcard"}],"panels":[]}]},"httpPath":"/cards/{id}/block"},{"label":"Unblock a card","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-controls/cardscontroller_unblockcard","routeSlug":"/v2/openapi/cards-controls/cardscontroller_unblockcard","metadata":{"seo":{"title":"Unblock a card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_unblockCard","name":"Unblock a card","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1unblock/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Unblock a card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unblocks the card belonging to the authenticated employee. Accessible by CARD_USER and admin roles. The card must belong to the calling employee."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1unblock/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1unblock/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/cards/{id}/unblock","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"responseCodes":["200","403","404"],"pointer":"/cards/{id}/unblock","href":"cards-controls/cardscontroller_unblockcard","openApiOperationId":"CardsController_unblockCard","summary":"Unblock a card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card unblocked successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"403","description":"Card does not belong to this employee"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1unblock/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-controls/cardscontroller_unblockcard"}],"panels":[]}]},"httpPath":"/cards/{id}/unblock"},{"label":"Retire (cancel) a card","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-controls/cardscontroller_retirecard","routeSlug":"/v2/openapi/cards-controls/cardscontroller_retirecard","metadata":{"seo":{"title":"Retire (cancel) a card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_retireCard","name":"Retire (cancel) a card","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1retire/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retire (cancel) a card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permanently retires the card belonging to the authenticated employee. Accessible by CARD_USER and admin roles. The card must belong to the calling employee."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1retire/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1retire/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_129"}},"schemaId":"schema_129","pointer":"/paths/~1cards~1{id}~1retire/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/cards/{id}/retire","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"schema_129"}},"responseCodes":["200","403","404"],"pointer":"/cards/{id}/retire","href":"cards-controls/cardscontroller_retirecard","openApiOperationId":"CardsController_retireCard","summary":"Retire (cancel) a card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"schema_129","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_129"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card retired successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"403","description":"Card does not belong to this employee"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1retire/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-controls/cardscontroller_retirecard"}],"panels":[]}]},"httpPath":"/cards/{id}/retire"},{"label":"Re-issue a virtual card (retire old, create new)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-controls/cardscontroller_reissuecard","routeSlug":"/v2/openapi/cards-controls/cardscontroller_reissuecard","metadata":{"seo":{"title":"Re-issue a virtual card (retire old, create new)","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_reIssueCard","name":"Re-issue a virtual card (retire old, create new)","isWebhook":false,"pointer":"/paths/~1cards~1{id}~1reissue/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Re-issue a virtual card (retire old, create new)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Re-issue a virtual card (retire old, create new)"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1{id}~1reissue/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1{id}~1reissue/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cards/{id}/reissue","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"responseCodes":["200","400","404"],"pointer":"/cards/{id}/reissue","href":"cards-controls/cardscontroller_reissuecard","openApiOperationId":"CardsController_reIssueCard","summary":"Re-issue a virtual card (retire old, create new)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card re-issued successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}},"schemaId":"components/schemas/CardV1Dto"},{"code":"400","description":"Bad Request - Card is not virtual or already retired"},{"code":"404","description":"Card not found"}],"pointer":"/paths/~1cards~1{id}~1reissue/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-controls/cardscontroller_reissuecard"}],"panels":[]}]},"httpPath":"/cards/{id}/reissue"}],"content":{"contentType":"group","meta":{"name":"cards-controls"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cards · Controls","showPageActions":true},{"nodeType":"markdoc","content":"Block, unblock, retire, and reissue cards."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cards/{id}/block","summary":"Block a card","prefix":{"name":"put","color":"put"},"badges":[],"link":"/cards-controls/cardscontroller_blockcard","deprecated":false},{"title":"/cards/{id}/unblock","summary":"Unblock a card","prefix":{"name":"put","color":"put"},"badges":[],"link":"/cards-controls/cardscontroller_unblockcard","deprecated":false},{"title":"/cards/{id}/retire","summary":"Retire (cancel) a card","prefix":{"name":"put","color":"put"},"badges":[],"link":"/cards-controls/cardscontroller_retirecard","deprecated":false},{"title":"/cards/{id}/reissue","summary":"Re-issue a virtual card (retire old, create new)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cards-controls/cardscontroller_reissuecard","deprecated":false}]}]}]}]}},{"type":"group","label":"Cards · Single-use","link":"/v2/openapi/cards-single-use","routeSlug":"/v2/openapi/cards-single-use","items":[{"label":"Request a Single Use Card","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-single-use/cardscontroller_requestsingleusecard","routeSlug":"/v2/openapi/cards-single-use/cardscontroller_requestsingleusecard","metadata":{"seo":{"title":"Request a Single Use Card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_requestSingleUseCard","name":"Request a Single Use Card","isWebhook":false,"pointer":"/paths/~1cards~1single-use~1request/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request a Single Use Card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a Single Use Card (SUC) approval request for an employee."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer resolution"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"transaction dump so it is available on expense records without an additional lookup."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1single-use~1request/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestSingleUseCardDto","exampleIds":["paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object","paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"]}},"schemaId":"components/schemas/RequestSingleUseCardDto","exampleIds":["paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object","paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"],"pointer":"/paths/~1cards~1single-use~1request/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cards/single-use/request","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RequestSingleUseCardDto","exampleIds":["paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object","paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"]}},"responseCodes":["201","400","403","404"],"pointer":"/cards/single-use/request","href":"cards-single-use/cardscontroller_requestsingleusecard","openApiOperationId":"CardsController_requestSingleUseCard","summary":"Request a Single Use Card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RequestSingleUseCardDto","exampleIds":["paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object","paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RequestSingleUseCardDto","exampleIds":["paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object","paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Single use card request created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateSingleUseCardResponseDto"}},"schemaId":"components/schemas/CreateSingleUseCardResponseDto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — missing required fields or negative amount"},"children":[]}]}]}]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — insufficient permissions"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — employee or business not found"},"children":[]}]}]}]}],"pointer":"/paths/~1cards~1single-use~1request/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateSingleUseCardResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateSingleUseCardResponseDto"}}},{"code":"400"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-single-use/cardscontroller_requestsingleusecard"}],"panels":[]}]},"httpPath":"/cards/single-use/request"},{"label":"Get the business SUC policy","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-single-use/cardscontroller_getsucpolicy","routeSlug":"/v2/openapi/cards-single-use/cardscontroller_getsucpolicy","metadata":{"seo":{"title":"Get the business SUC policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getSucPolicy","name":"Get the business SUC policy","isWebhook":false,"pointer":"/paths/~1cards~1single-use~1policy/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get the business SUC policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the Single Use Card policy for the authenticated employee"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1single-use~1policy/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/single-use/policy","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200"],"pointer":"/cards/single-use/policy","href":"cards-single-use/cardscontroller_getsucpolicy","openApiOperationId":"CardsController_getSucPolicy","summary":"Get the business SUC policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business SUC policy","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_130"}},"schemaId":"schema_130"}],"pointer":"/paths/~1cards~1single-use~1policy/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_130","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_130"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-single-use/cardscontroller_getsucpolicy"}],"panels":[]}]},"httpPath":"/cards/single-use/policy"}],"content":{"contentType":"group","meta":{"name":"cards-single-use"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cards · Single-use","showPageActions":true},{"nodeType":"markdoc","content":"Single-use card requests and policy."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cards/single-use/request","summary":"Request a Single Use Card","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cards-single-use/cardscontroller_requestsingleusecard","deprecated":false},{"title":"/cards/single-use/policy","summary":"Get the business SUC policy","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards-single-use/cardscontroller_getsucpolicy","deprecated":false}]}]}]}]}},{"type":"group","label":"Cards · Physical cards","link":"/v2/openapi/cards-physical","routeSlug":"/v2/openapi/cards-physical","items":[{"label":"List physical card orders with pagination","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-physical/cardscontroller_getphysicalcardorders","routeSlug":"/v2/openapi/cards-physical/cardscontroller_getphysicalcardorders","metadata":{"seo":{"title":"List physical card orders with pagination","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getPhysicalCardOrders","name":"List physical card orders with pagination","isWebhook":false,"pointer":"/paths/~1cards~1physical~1orders/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List physical card orders with pagination","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List physical card orders with pagination"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1cards~1physical~1orders/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1physical~1orders/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/physical/orders","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","400"],"pointer":"/cards/physical/orders","href":"cards-physical/cardscontroller_getphysicalcardorders","openApiOperationId":"CardsController_getPhysicalCardOrders","summary":"List physical card orders with pagination"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of physical card orders","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedPhysicalCardOrderResponseDto"}},"schemaId":"components/schemas/PaginatedPhysicalCardOrderResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1cards~1physical~1orders/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedPhysicalCardOrderResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedPhysicalCardOrderResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-physical/cardscontroller_getphysicalcardorders"}],"panels":[]}]},"httpPath":"/cards/physical/orders"},{"label":"Approve one or multiple physical card orders","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-physical/cardscontroller_approvephysicalcardorders","routeSlug":"/v2/openapi/cards-physical/cardscontroller_approvephysicalcardorders","metadata":{"seo":{"title":"Approve one or multiple physical card orders","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_approvePhysicalCardOrders","name":"Approve one or multiple physical card orders","isWebhook":false,"pointer":"/paths/~1cards~1physical~1orders/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve one or multiple physical card orders","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approve one or multiple physical card orders"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1physical~1orders/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApprovePhysicalCardOrdersDto"}},"schemaId":"components/schemas/ApprovePhysicalCardOrdersDto","pointer":"/paths/~1cards~1physical~1orders/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cards/physical/orders","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ApprovePhysicalCardOrdersDto"}},"responseCodes":["200","400"],"pointer":"/cards/physical/orders","href":"cards-physical/cardscontroller_approvephysicalcardorders","openApiOperationId":"CardsController_approvePhysicalCardOrders","summary":"Approve one or multiple physical card orders"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ApprovePhysicalCardOrdersDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ApprovePhysicalCardOrdersDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Physical card orders approved successfully"},{"code":"400","description":"Bad Request - Invalid order IDs or request body"}],"pointer":"/paths/~1cards~1physical~1orders/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-physical/cardscontroller_approvephysicalcardorders"}],"panels":[]}]},"httpPath":"/cards/physical/orders"},{"label":"Reject one or multiple physical card orders","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-physical/cardscontroller_rejectphysicalcardorders","routeSlug":"/v2/openapi/cards-physical/cardscontroller_rejectphysicalcardorders","metadata":{"seo":{"title":"Reject one or multiple physical card orders","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_rejectPhysicalCardOrders","name":"Reject one or multiple physical card orders","isWebhook":false,"pointer":"/paths/~1cards~1physical~1orders/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject one or multiple physical card orders","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reject one or multiple physical card orders"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1physical~1orders/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPhysicalCardOrdersDto"}},"schemaId":"components/schemas/RejectPhysicalCardOrdersDto","pointer":"/paths/~1cards~1physical~1orders/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/cards/physical/orders","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RejectPhysicalCardOrdersDto"}},"responseCodes":["200","400"],"pointer":"/cards/physical/orders","href":"cards-physical/cardscontroller_rejectphysicalcardorders","openApiOperationId":"CardsController_rejectPhysicalCardOrders","summary":"Reject one or multiple physical card orders"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RejectPhysicalCardOrdersDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RejectPhysicalCardOrdersDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Physical card orders rejected successfully"},{"code":"400","description":"Bad Request - Invalid order IDs or missing rejection notes"}],"pointer":"/paths/~1cards~1physical~1orders/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-physical/cardscontroller_rejectphysicalcardorders"}],"panels":[]}]},"httpPath":"/cards/physical/orders"}],"content":{"contentType":"group","meta":{"name":"cards-physical"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cards · Physical cards","showPageActions":true},{"nodeType":"markdoc","content":"Physical card order approvals."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cards/physical/orders","summary":"List physical card orders with pagination","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards-physical/cardscontroller_getphysicalcardorders","deprecated":false},{"title":"/cards/physical/orders","summary":"Approve one or multiple physical card orders","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cards-physical/cardscontroller_approvephysicalcardorders","deprecated":false},{"title":"/cards/physical/orders","summary":"Reject one or multiple physical card orders","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/cards-physical/cardscontroller_rejectphysicalcardorders","deprecated":false}]}]}]}]}},{"type":"group","label":"Cards · Authorization","link":"/v2/openapi/cards-auth","routeSlug":"/v2/openapi/cards-auth","items":[{"label":"Authorize a BT session for card","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-auth/cardscontroller_authorizebtsession","routeSlug":"/v2/openapi/cards-auth/cardscontroller_authorizebtsession","metadata":{"seo":{"title":"Authorize a BT session for card","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_authorizeBTSession","name":"Authorize a BT session for card","isWebhook":false,"pointer":"/paths/~1cards~1authorize/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Authorize a BT session for card","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authorizes a Basis Theory session so the caller can reveal sensitive card details (PAN/CVV). Accessible by CARD_USER and admin roles. The nonce must be obtained from a BT session created client-side, and the VCN must belong to the authenticated employee."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1authorize/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthorizeBTSessionDto"}},"schemaId":"components/schemas/AuthorizeBTSessionDto","pointer":"/paths/~1cards~1authorize/post/requestBody","description":"BT session authorization details"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cards/authorize","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AuthorizeBTSessionDto"}},"responseCodes":["200","400","403"],"pointer":"/cards/authorize","href":"cards-auth/cardscontroller_authorizebtsession","openApiOperationId":"CardsController_authorizeBTSession","summary":"Authorize a BT session for card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AuthorizeBTSessionDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthorizeBTSessionDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"BT session authorized successfully"},{"code":"400","description":"Bad Request - Invalid nonce or VCN"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden - missing business_id header or card does not belong to this employee"},"children":[]}]}]}]}],"pointer":"/paths/~1cards~1authorize/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-auth/cardscontroller_authorizebtsession"}],"panels":[]}]},"httpPath":"/cards/authorize"},{"label":"Get card fingerprint by VCN","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/cards-auth/cardscontroller_getcardfingerprint","routeSlug":"/v2/openapi/cards-auth/cardscontroller_getcardfingerprint","metadata":{"seo":{"title":"Get card fingerprint by VCN","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CardsController_getCardFingerprint","name":"Get card fingerprint by VCN","isWebhook":false,"pointer":"/paths/~1cards~1getFingerPrint~1{vcn}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get card fingerprint by VCN","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get card fingerprint by VCN"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["cards:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"vcn","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1cards~1getFingerPrint~1{vcn}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1cards~1getFingerPrint~1{vcn}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/cards/getFingerPrint/{vcn}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"vcn","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["cards:read"]}],"responseCodes":["200","404"],"pointer":"/cards/getFingerPrint/{vcn}","href":"cards-auth/cardscontroller_getcardfingerprint","openApiOperationId":"CardsController_getCardFingerprint","summary":"Get card fingerprint by VCN"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Card fingerprint retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardFingerprintDto"}},"schemaId":"components/schemas/CardFingerprintDto"},{"code":"404","description":"Card fingerprint not found"}],"pointer":"/paths/~1cards~1getFingerPrint~1{vcn}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CardFingerprintDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CardFingerprintDto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cards-auth/cardscontroller_getcardfingerprint"}],"panels":[]}]},"httpPath":"/cards/getFingerPrint/{vcn}"}],"content":{"contentType":"group","meta":{"name":"cards-auth"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cards · Authorization","showPageActions":true},{"nodeType":"markdoc","content":"Card authorization and fingerprint. Back-office / secondary."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cards/authorize","summary":"Authorize a BT session for card","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cards-auth/cardscontroller_authorizebtsession","deprecated":false},{"title":"/cards/getFingerPrint/{vcn}","summary":"Get card fingerprint by VCN","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cards-auth/cardscontroller_getcardfingerprint","deprecated":false}]}]}]}]}},{"type":"group","label":"subscriptions","link":"/v2/openapi/subscriptions","routeSlug":"/v2/openapi/subscriptions","items":[{"label":"List subscriptions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_listsubscriptions","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_listsubscriptions","metadata":{"seo":{"title":"List subscriptions","description":"Retrieves a paginated list of subscriptions with optional filtering by search term and status"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_listSubscriptions","name":"List subscriptions","isWebhook":false,"pointer":"/paths/~1subscriptions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List subscriptions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a paginated list of subscriptions with optional filtering by search term and status"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_131","description":"Number of items per page (minimum: 1, maximum: 1000)"},{"name":"search","in":"query","schemaId":"schema_132","description":"Search term to filter subscriptions by name or merchant"},{"name":"status","in":"query","schemaId":"schema_133","description":"Filter subscriptions by status"}],"pointer":"/paths/~1subscriptions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/subscriptions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":50,"schemaId":"schema_131"},{"name":"search","in":"query","required":false,"example":"Netflix","schemaId":"schema_132"},{"name":"status","in":"query","required":false,"schemaId":"schema_133"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:read"]}],"responseCodes":["200","400"],"pointer":"/subscriptions","href":"subscriptions/subscriptionscontroller_listsubscriptions","openApiOperationId":"SubscriptionsController_listSubscriptions","summary":"List subscriptions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of subscriptions","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedSubscriptionResponseDto"}},"schemaId":"components/schemas/PaginatedSubscriptionResponseDto"},{"code":"400","description":"Bad Request - Invalid query parameters"}],"pointer":"/paths/~1subscriptions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedSubscriptionResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedSubscriptionResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_listsubscriptions"}],"panels":[]}]},"httpPath":"/subscriptions"},{"label":"Get subscription expenses","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_getsubscriptionexpenses","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_getsubscriptionexpenses","metadata":{"seo":{"title":"Get subscription expenses","description":"Retrieves paginated list of expenses for a specific subscription"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_getSubscriptionExpenses","name":"Get subscription expenses","isWebhook":false,"pointer":"/paths/~1subscriptions~1expenses/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get subscription expenses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves paginated list of expenses for a specific subscription"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_110","required":true},{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"}],"pointer":"/paths/~1subscriptions~1expenses/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1expenses/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/subscriptions/expenses","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"schemaId":"schema_110"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:read"]}],"responseCodes":["200","400"],"pointer":"/subscriptions/expenses","href":"subscriptions/subscriptionscontroller_getsubscriptionexpenses","openApiOperationId":"SubscriptionsController_getSubscriptionExpenses","summary":"Get subscription expenses"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated subscription expenses","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpensesDto"}},"schemaId":"components/schemas/PaginatedExpensesDto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1expenses/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedExpensesDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedExpensesDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_getsubscriptionexpenses"}],"panels":[]}]},"httpPath":"/subscriptions/expenses"},{"label":"Get amount spent per subscription","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_getamountspent","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_getamountspent","metadata":{"seo":{"title":"Get amount spent per subscription","description":"Retrieves amount spent per subscription with period breakdown"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_getAmountSpent","name":"Get amount spent per subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1amount-spent/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get amount spent per subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves amount spent per subscription with period breakdown"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1amount-spent/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AmountSpentRequestDto"}},"schemaId":"components/schemas/AmountSpentRequestDto","pointer":"/paths/~1subscriptions~1amount-spent/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/subscriptions/amount-spent","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AmountSpentRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/amount-spent","href":"subscriptions/subscriptionscontroller_getamountspent","openApiOperationId":"SubscriptionsController_getAmountSpent","summary":"Get amount spent per subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AmountSpentRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AmountSpentRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Amount spent data with period breakdown","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AmountSpentResponseDto"}},"schemaId":"components/schemas/AmountSpentResponseDto"},{"code":"400","description":"Bad Request - Invalid request body"}],"pointer":"/paths/~1subscriptions~1amount-spent/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AmountSpentResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AmountSpentResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_getamountspent"}],"panels":[]}]},"httpPath":"/subscriptions/amount-spent"},{"label":"Create subscription","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_createsubscription","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_createsubscription","metadata":{"seo":{"title":"Create subscription","description":"Creates a new subscription with specified configuration"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_createSubscription","name":"Create subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new subscription with specified configuration"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequestDto"}},"schemaId":"components/schemas/CreateSubscriptionRequestDto","pointer":"/paths/~1subscriptions~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/subscriptions/create","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequestDto"}},"responseCodes":["201","400"],"pointer":"/subscriptions/create","href":"subscriptions/subscriptionscontroller_createsubscription","openApiOperationId":"SubscriptionsController_createSubscription","summary":"Create subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateSubscriptionRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Subscription created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":"Bad Request - Invalid request body"}],"pointer":"/paths/~1subscriptions~1create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_createsubscription"}],"panels":[]}]},"httpPath":"/subscriptions/create"},{"label":"Update subscription status","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_updatestatus","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_updatestatus","metadata":{"seo":{"title":"Update subscription status","description":"Updates the status of a subscription (ACTIVE or PAUSED)"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_updateStatus","name":"Update subscription status","isWebhook":false,"pointer":"/paths/~1subscriptions~1status/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update subscription status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the status of a subscription (ACTIVE or PAUSED)"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_134","description":"Subscription ID","required":true}],"pointer":"/paths/~1subscriptions~1status/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1status/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateStatusRequestDto"}},"schemaId":"components/schemas/UpdateStatusRequestDto","pointer":"/paths/~1subscriptions~1status/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/subscriptions/status","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"example":"67b44aea86c1ccabbe965827","schemaId":"schema_134"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateStatusRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/status","href":"subscriptions/subscriptionscontroller_updatestatus","openApiOperationId":"SubscriptionsController_updateStatus","summary":"Update subscription status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateStatusRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateStatusRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Updated subscription","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id or invalid status"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1status/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_updatestatus"}],"panels":[]}]},"httpPath":"/subscriptions/status"},{"label":"Update subscription team","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_updateteam","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_updateteam","metadata":{"seo":{"title":"Update subscription team","description":"Updates team information for a subscription"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_updateTeam","name":"Update subscription team","isWebhook":false,"pointer":"/paths/~1subscriptions~1team/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update subscription team","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates team information for a subscription"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_134","description":"Subscription ID","required":true}],"pointer":"/paths/~1subscriptions~1team/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1team/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTeamRequestDto"}},"schemaId":"components/schemas/UpdateTeamRequestDto","pointer":"/paths/~1subscriptions~1team/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/subscriptions/team","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"example":"67b44aea86c1ccabbe965827","schemaId":"schema_134"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateTeamRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/team","href":"subscriptions/subscriptionscontroller_updateteam","openApiOperationId":"SubscriptionsController_updateTeam","summary":"Update subscription team"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateTeamRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTeamRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Updated subscription with new team","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id or invalid team data"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1team/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_updateteam"}],"panels":[]}]},"httpPath":"/subscriptions/team"},{"label":"Update subscription limits and billing frequency","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_updatelimitsbillingfrequency","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_updatelimitsbillingfrequency","metadata":{"seo":{"title":"Update subscription limits and billing frequency","description":"Updates the limits and billing frequency for a subscription"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_updateLimitsBillingFrequency","name":"Update subscription limits and billing frequency","isWebhook":false,"pointer":"/paths/~1subscriptions~1limits-billing-frequency/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update subscription limits and billing frequency","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the limits and billing frequency for a subscription"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_134","description":"Subscription ID","required":true}],"pointer":"/paths/~1subscriptions~1limits-billing-frequency/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1limits-billing-frequency/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateLimitsBillingFrequencyRequestDto"}},"schemaId":"components/schemas/UpdateLimitsBillingFrequencyRequestDto","pointer":"/paths/~1subscriptions~1limits-billing-frequency/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/subscriptions/limits-billing-frequency","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"example":"67b44aea86c1ccabbe965827","schemaId":"schema_134"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateLimitsBillingFrequencyRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/limits-billing-frequency","href":"subscriptions/subscriptionscontroller_updatelimitsbillingfrequency","openApiOperationId":"SubscriptionsController_updateLimitsBillingFrequency","summary":"Update subscription limits and billing frequency"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateLimitsBillingFrequencyRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateLimitsBillingFrequencyRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Updated subscription with new limits and billing frequency","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id or invalid data"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1limits-billing-frequency/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_updatelimitsbillingfrequency"}],"panels":[]}]},"httpPath":"/subscriptions/limits-billing-frequency"},{"label":"Assign employee to subscription","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_assignemployee","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_assignemployee","metadata":{"seo":{"title":"Assign employee to subscription","description":"Assigns an employee and card to a subscription"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_assignEmployee","name":"Assign employee to subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1assign-employee/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Assign employee to subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Assigns an employee and card to a subscription"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_134","description":"Subscription ID","required":true}],"pointer":"/paths/~1subscriptions~1assign-employee/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1assign-employee/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AssignEmployeeRequestDto"}},"schemaId":"components/schemas/AssignEmployeeRequestDto","pointer":"/paths/~1subscriptions~1assign-employee/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/subscriptions/assign-employee","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"example":"67b44aea86c1ccabbe965827","schemaId":"schema_134"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AssignEmployeeRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/assign-employee","href":"subscriptions/subscriptionscontroller_assignemployee","openApiOperationId":"SubscriptionsController_assignEmployee","summary":"Assign employee to subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AssignEmployeeRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AssignEmployeeRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Updated subscription with assigned employee","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id or invalid data"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1assign-employee/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_assignemployee"}],"panels":[]}]},"httpPath":"/subscriptions/assign-employee"},{"label":"Update subscription subcategory","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_updatesubcategory","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_updatesubcategory","metadata":{"seo":{"title":"Update subscription subcategory","description":"Updates the subcategory for a subscription"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_updateSubcategory","name":"Update subscription subcategory","isWebhook":false,"pointer":"/paths/~1subscriptions~1subcategory/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update subscription subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the subcategory for a subscription"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"subscription_id","in":"query","schemaId":"schema_134","description":"Subscription ID","required":true}],"pointer":"/paths/~1subscriptions~1subcategory/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1subcategory/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryRequestDto"}},"schemaId":"components/schemas/UpdateSubcategoryRequestDto","pointer":"/paths/~1subscriptions~1subcategory/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/subscriptions/subcategory","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"subscription_id","in":"query","required":true,"example":"67b44aea86c1ccabbe965827","schemaId":"schema_134"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryRequestDto"}},"responseCodes":["200","400"],"pointer":"/subscriptions/subcategory","href":"subscriptions/subscriptionscontroller_updatesubcategory","openApiOperationId":"SubscriptionsController_updateSubcategory","summary":"Update subscription subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateSubcategoryRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Updated subscription with new subcategory","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}},"schemaId":"components/schemas/SubscriptionV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - Missing subscription_id or invalid data"},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions~1subcategory/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubscriptionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubscriptionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_updatesubcategory"}],"panels":[]}]},"httpPath":"/subscriptions/subcategory"},{"label":"Auto generate subscriptions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/subscriptions/subscriptionscontroller_autogeneratesubscriptions","routeSlug":"/v2/openapi/subscriptions/subscriptionscontroller_autogeneratesubscriptions","metadata":{"seo":{"title":"Auto generate subscriptions","description":"Automatically generates subscriptions from transaction patterns"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"SubscriptionsController_autoGenerateSubscriptions","name":"Auto generate subscriptions","isWebhook":false,"pointer":"/paths/~1subscriptions~1auto-generate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Auto generate subscriptions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Automatically generates subscriptions from transaction patterns"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["subscriptions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1subscriptions~1auto-generate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/subscriptions/auto-generate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["subscriptions:write"]}],"responseCodes":["200","400"],"pointer":"/subscriptions/auto-generate","href":"subscriptions/subscriptionscontroller_autogeneratesubscriptions","openApiOperationId":"SubscriptionsController_autoGenerateSubscriptions","summary":"Auto generate subscriptions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Auto generated subscriptions response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AutoGenerateResponseDto"}},"schemaId":"components/schemas/AutoGenerateResponseDto"},{"code":"400","description":"Bad Request"}],"pointer":"/paths/~1subscriptions~1auto-generate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AutoGenerateResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AutoGenerateResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscriptions/subscriptionscontroller_autogeneratesubscriptions"}],"panels":[]}]},"httpPath":"/subscriptions/auto-generate"}],"content":{"contentType":"group","meta":{"name":"subscriptions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"subscriptions","showPageActions":true},{"nodeType":"markdoc","content":"Recurring spend management."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/subscriptions","summary":"List subscriptions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/subscriptions/subscriptionscontroller_listsubscriptions","deprecated":false},{"title":"/subscriptions/expenses","summary":"Get subscription expenses","prefix":{"name":"get","color":"get"},"badges":[],"link":"/subscriptions/subscriptionscontroller_getsubscriptionexpenses","deprecated":false},{"title":"/subscriptions/amount-spent","summary":"Get amount spent per subscription","prefix":{"name":"post","color":"post"},"badges":[],"link":"/subscriptions/subscriptionscontroller_getamountspent","deprecated":false},{"title":"/subscriptions/create","summary":"Create subscription","prefix":{"name":"post","color":"post"},"badges":[],"link":"/subscriptions/subscriptionscontroller_createsubscription","deprecated":false},{"title":"/subscriptions/status","summary":"Update subscription status","prefix":{"name":"put","color":"put"},"badges":[],"link":"/subscriptions/subscriptionscontroller_updatestatus","deprecated":false},{"title":"/subscriptions/team","summary":"Update subscription team","prefix":{"name":"put","color":"put"},"badges":[],"link":"/subscriptions/subscriptionscontroller_updateteam","deprecated":false},{"title":"/subscriptions/limits-billing-frequency","summary":"Update subscription limits and billing frequency","prefix":{"name":"put","color":"put"},"badges":[],"link":"/subscriptions/subscriptionscontroller_updatelimitsbillingfrequency","deprecated":false},{"title":"/subscriptions/assign-employee","summary":"Assign employee to subscription","prefix":{"name":"put","color":"put"},"badges":[],"link":"/subscriptions/subscriptionscontroller_assignemployee","deprecated":false},{"title":"/subscriptions/subcategory","summary":"Update subscription subcategory","prefix":{"name":"put","color":"put"},"badges":[],"link":"/subscriptions/subscriptionscontroller_updatesubcategory","deprecated":false},{"title":"/subscriptions/auto-generate","summary":"Auto generate subscriptions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/subscriptions/subscriptionscontroller_autogeneratesubscriptions","deprecated":false}]}]}]}]}},{"type":"group","label":"tags","link":"/v2/openapi/tags","routeSlug":"/v2/openapi/tags","items":[{"label":"List all expense tags","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/tags/tagscontroller_listtags","routeSlug":"/v2/openapi/tags/tagscontroller_listtags","metadata":{"seo":{"title":"List all expense tags","description":"Returns all active expense tags for the business. Used to populate the tags dropdown on the single-use card request form and expense forms."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TagsController_listTags","name":"List all expense tags","isWebhook":false,"pointer":"/paths/~1tags/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all expense tags","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns all active expense tags for the business. Used to populate the tags dropdown on the single-use card request form and expense forms."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["tags:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1tags/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tags","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["tags:read"]}],"responseCodes":["200","400","401"],"pointer":"/tags","href":"tags/tagscontroller_listtags","openApiOperationId":"TagsController_listTags","summary":"List all expense tags"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of tags returned successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — business_id header missing"},"children":[]}]}]}]},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1tags/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tags/tagscontroller_listtags"}],"panels":[]}]},"httpPath":"/tags"},{"label":"List tag groups with their tags","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/tags/tagscontroller_listtaggroups","routeSlug":"/v2/openapi/tags/tagscontroller_listtaggroups","metadata":{"seo":{"title":"List tag groups with their tags","description":"Returns all tag groups (e.g. \"Project\", \"Department\") and their associated tags for the business."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TagsController_listTagGroups","name":"List tag groups with their tags","isWebhook":false,"pointer":"/paths/~1tags~1groups/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List tag groups with their tags","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns all tag groups (e.g. \"Project\", \"Department\") and their associated tags for the business."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["tags:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1tags~1groups/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tags/groups","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["tags:read"]}],"responseCodes":["200","401","403"],"pointer":"/tags/groups","href":"tags/tagscontroller_listtaggroups","openApiOperationId":"TagsController_listTagGroups","summary":"List tag groups with their tags"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Tag groups returned successfully"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]}],"pointer":"/paths/~1tags~1groups/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tags/tagscontroller_listtaggroups"}],"panels":[]}]},"httpPath":"/tags/groups"}],"content":{"contentType":"group","meta":{"name":"tags"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"tags","showPageActions":true},{"nodeType":"markdoc","content":"Expense tag metadata."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/tags","summary":"List all expense tags","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tags/tagscontroller_listtags","deprecated":false},{"title":"/tags/groups","summary":"List tag groups with their tags","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tags/tagscontroller_listtaggroups","deprecated":false}]}]}]}]}},{"type":"separator","label":"Ledger & accounting","content":null},{"type":"group","label":"transactions","link":"/v2/openapi/transactions","routeSlug":"/v2/openapi/transactions","items":[{"label":"Create a new transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_createtransaction","routeSlug":"/v2/openapi/transactions/transactionscontroller_createtransaction","metadata":{"seo":{"title":"Create a new transaction","description":"Create a new transaction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_createTransaction","name":"Create a new transaction","isWebhook":false,"pointer":"/paths/~1transactions~1new/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1new/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTransactionV1Dto"}},"schemaId":"components/schemas/CreateTransactionV1Dto","pointer":"/paths/~1transactions~1new/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/transactions/new","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateTransactionV1Dto"}},"responseCodes":["201"],"pointer":"/transactions/new","href":"transactions/transactionscontroller_createtransaction","openApiOperationId":"TransactionsController_createTransaction","summary":"Create a new transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateTransactionV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTransactionV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Transaction created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}},"schemaId":"components/schemas/TransactionDto"}],"pointer":"/paths/~1transactions~1new/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/TransactionDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_createtransaction"}],"panels":[]}]},"httpPath":"/transactions/new"},{"label":"Get money movement analytics for a specific month","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_getmoneymovement","routeSlug":"/v2/openapi/transactions/transactionscontroller_getmoneymovement","metadata":{"seo":{"title":"Get money movement analytics for a specific month","description":"Returns aggregated money in/out data with top sources, top spends, and last 3 months trend"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_getMoneyMovement","name":"Get money movement analytics for a specific month","isWebhook":false,"pointer":"/paths/~1transactions~1money-movement/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get money movement analytics for a specific month","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns aggregated money in/out data with top sources, top spends, and last 3 months trend"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"month","in":"query","schemaId":"schema_135","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Month (0-11, where 0 = January, 11 = December)"},"children":[]}]}]}],"required":true},{"name":"year","in":"query","schemaId":"schema_136","description":"Year (4-digit year)","required":true},{"name":"currency","in":"query","schemaId":"schema_111","description":"Currency code (e.g., KES, USD)","required":true}],"pointer":"/paths/~1transactions~1money-movement/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1money-movement/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/transactions/money-movement","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"month","in":"query","required":true,"example":0,"schemaId":"schema_135"},{"name":"year","in":"query","required":true,"example":2026,"schemaId":"schema_136"},{"name":"currency","in":"query","required":true,"example":"KES","schemaId":"schema_111"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:read"]}],"responseCodes":["200","400"],"pointer":"/transactions/money-movement","href":"transactions/transactionscontroller_getmoneymovement","openApiOperationId":"TransactionsController_getMoneyMovement","summary":"Get money movement analytics for a specific month"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Money movement analytics data","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MoneyMovementResponseV1Dto"}},"schemaId":"components/schemas/MoneyMovementResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid query parameters"}],"pointer":"/paths/~1transactions~1money-movement/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MoneyMovementResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MoneyMovementResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_getmoneymovement"}],"panels":[]}]},"httpPath":"/transactions/money-movement"},{"label":"Get transaction fees","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_getfees","routeSlug":"/v2/openapi/transactions/transactionscontroller_getfees","metadata":{"seo":{"title":"Get transaction fees","description":"Get transaction fees"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_getFees","name":"Get transaction fees","isWebhook":false,"pointer":"/paths/~1transactions~1fees/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get transaction fees","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1fees/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/transactions/fees","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:read"]}],"responseCodes":["200"],"pointer":"/transactions/fees","href":"transactions/transactionscontroller_getfees","openApiOperationId":"TransactionsController_getFees","summary":"Get transaction fees"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction fees retrieved successfully"}],"pointer":"/paths/~1transactions~1fees/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_getfees"}],"panels":[]}]},"httpPath":"/transactions/fees"},{"label":"Get recent transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_getrecenttransactions","routeSlug":"/v2/openapi/transactions/transactionscontroller_getrecenttransactions","metadata":{"seo":{"title":"Get recent transactions","description":"Get recent transactions"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_getRecentTransactions","name":"Get recent transactions","isWebhook":false,"pointer":"/paths/~1transactions~1recent/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get recent transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1recent/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/transactions/recent","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:read"]}],"responseCodes":["200"],"pointer":"/transactions/recent","href":"transactions/transactionscontroller_getrecenttransactions","openApiOperationId":"TransactionsController_getRecentTransactions","summary":"Get recent transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Recent transactions retrieved successfully"}],"pointer":"/paths/~1transactions~1recent/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_getrecenttransactions"}],"panels":[]}]},"httpPath":"/transactions/recent"},{"label":"Get transaction by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_gettransaction","routeSlug":"/v2/openapi/transactions/transactionscontroller_gettransaction","metadata":{"seo":{"title":"Get transaction by ID","description":"Get transaction by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_getTransaction","name":"Get transaction by ID","isWebhook":false,"pointer":"/paths/~1transactions~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get transaction by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/transactions/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:read"]}],"responseCodes":["200"],"pointer":"/transactions/{id}","href":"transactions/transactionscontroller_gettransaction","openApiOperationId":"TransactionsController_getTransaction","summary":"Get transaction by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}},"schemaId":"components/schemas/TransactionDto"}],"pointer":"/paths/~1transactions~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_gettransaction"}],"panels":[]}]},"httpPath":"/transactions/{id}"},{"label":"List transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_listalltransactions","routeSlug":"/v2/openapi/transactions/transactionscontroller_listalltransactions","metadata":{"seo":{"title":"List transactions","description":"List transactions"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_listAllTransactions","name":"List transactions","isWebhook":false,"pointer":"/paths/~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_137","required":true},{"name":"limit","in":"query","schemaId":"schema_137","required":true},{"name":"account","in":"query","schemaId":"schema_110"},{"name":"export","in":"query","schemaId":"schema_110"},{"name":"search","in":"query","schemaId":"schema_110","description":"Search across description, reference"},{"name":"to","in":"query","schemaId":"schema_138","description":"To Date"},{"name":"from","in":"query","schemaId":"schema_139","description":"From Date"}],"pointer":"/paths/~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/transactions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":true,"schemaId":"schema_137"},{"name":"limit","in":"query","required":true,"schemaId":"schema_137"},{"name":"account","in":"query","required":false,"schemaId":"schema_110"},{"name":"export","in":"query","required":false,"schemaId":"schema_110"},{"name":"search","in":"query","required":false,"schemaId":"schema_110"},{"name":"to","in":"query","required":false,"example":"2026-01-01T23:59:59","schemaId":"schema_138"},{"name":"from","in":"query","required":false,"example":"2025-11-01","schemaId":"schema_139"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:read"]}],"responseCodes":["200"],"pointer":"/transactions","href":"transactions/transactionscontroller_listalltransactions","openApiOperationId":"TransactionsController_listAllTransactions","summary":"List transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of transactions","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTransactionResponseDto"}},"schemaId":"components/schemas/PaginatedTransactionResponseDto"}],"pointer":"/paths/~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedTransactionResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTransactionResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_listalltransactions"}],"panels":[]}]},"httpPath":"/transactions"},{"label":"Approve a transaction","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_approvetransaction","routeSlug":"/v2/openapi/transactions/transactionscontroller_approvetransaction","metadata":{"seo":{"title":"Approve a transaction","description":"Approve a transaction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_approveTransaction","name":"Approve a transaction","isWebhook":false,"pointer":"/paths/~1transactions~1{id}~1approve/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}~1approve/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}~1approve/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/transactions/{id}/approve","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"responseCodes":["200"],"pointer":"/transactions/{id}/approve","href":"transactions/transactionscontroller_approvetransaction","openApiOperationId":"TransactionsController_approveTransaction","summary":"Approve a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction approved","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}},"schemaId":"components/schemas/TransactionDto"}],"pointer":"/paths/~1transactions~1{id}~1approve/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_approvetransaction"}],"panels":[]}]},"httpPath":"/transactions/{id}/approve"},{"label":"Reject a transaction","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_rejecttransaction","routeSlug":"/v2/openapi/transactions/transactionscontroller_rejecttransaction","metadata":{"seo":{"title":"Reject a transaction","description":"Reject a transaction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_rejectTransaction","name":"Reject a transaction","isWebhook":false,"pointer":"/paths/~1transactions~1{id}~1reject/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}~1reject/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}~1reject/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/transactions/{id}/reject","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"responseCodes":["200"],"pointer":"/transactions/{id}/reject","href":"transactions/transactionscontroller_rejecttransaction","openApiOperationId":"TransactionsController_rejectTransaction","summary":"Reject a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction rejected","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}},"schemaId":"components/schemas/TransactionDto"}],"pointer":"/paths/~1transactions~1{id}~1reject/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_rejecttransaction"}],"panels":[]}]},"httpPath":"/transactions/{id}/reject"},{"label":"Tag a transaction with a subcategory","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_tagtransaction","routeSlug":"/v2/openapi/transactions/transactionscontroller_tagtransaction","metadata":{"seo":{"title":"Tag a transaction with a subcategory","description":"Tags an expense or topup transaction with a subcategory. IFT and REFUND transactions are not supported."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_tagTransaction","name":"Tag a transaction with a subcategory","isWebhook":false,"pointer":"/paths/~1transactions~1{id}~1tag/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Tag a transaction with a subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Tags an expense or topup transaction with a subcategory. IFT and REFUND transactions are not supported."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}~1tag/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}~1tag/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagTransactionDto"}},"schemaId":"components/schemas/TagTransactionDto","pointer":"/paths/~1transactions~1{id}~1tag/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/transactions/{id}/tag","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TagTransactionDto"}},"responseCodes":["200","400"],"pointer":"/transactions/{id}/tag","href":"transactions/transactionscontroller_tagtransaction","openApiOperationId":"TransactionsController_tagTransaction","summary":"Tag a transaction with a subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/TagTransactionDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagTransactionDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction tagged successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionV1Dto"}},"schemaId":"components/schemas/TransactionV1Dto"},{"code":"400","description":"Bad Request - Transaction type does not support tagging or subcategory not found/inactive"}],"pointer":"/paths/~1transactions~1{id}~1tag/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_tagtransaction"}],"panels":[]}]},"httpPath":"/transactions/{id}/tag"},{"label":"Upload a supporting document for a transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_uploadsupportingdocument","routeSlug":"/v2/openapi/transactions/transactionscontroller_uploadsupportingdocument","metadata":{"seo":{"title":"Upload a supporting document for a transaction","description":"Uploads a supporting document (PDF, XLS, XLSX, DOCX, CSV, PNG, JPEG) to S3 for a specific transaction. Maximum file size is 10MB."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_uploadSupportingDocument","name":"Upload a supporting document for a transaction","isWebhook":false,"pointer":"/paths/~1transactions~1{id}~1supporting-document/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload a supporting document for a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Uploads a supporting document (PDF, XLS, XLSX, DOCX, CSV, PNG, JPEG) to S3 for a specific transaction. Maximum file size is 10MB."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}~1supporting-document/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}~1supporting-document/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"schemaId":"components/schemas/UploadSupportingDocumentDto","pointer":"/paths/~1transactions~1{id}~1supporting-document/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/transactions/{id}/supporting-document","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"responseCodes":["201","400","404"],"pointer":"/transactions/{id}/supporting-document","href":"transactions/transactionscontroller_uploadsupportingdocument","openApiOperationId":"TransactionsController_uploadSupportingDocument","summary":"Upload a supporting document for a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UploadSupportingDocumentDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Document uploaded successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"}},"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"},{"code":"400","description":"Bad Request - Invalid content type, file format, or file size exceeds limit"},{"code":"404","description":"Transaction not found"}],"pointer":"/paths/~1transactions~1{id}~1supporting-document/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/UploadSupportingDocumentResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_uploadsupportingdocument"}],"panels":[]}]},"httpPath":"/transactions/{id}/supporting-document"},{"label":"Remove a document from a transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_removetransactiondocument","routeSlug":"/v2/openapi/transactions/transactionscontroller_removetransactiondocument","metadata":{"seo":{"title":"Remove a document from a transaction","description":"Removes an attachment from an EXPENSE or TOPUP transaction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_removeTransactionDocument","name":"Remove a document from a transaction","isWebhook":false,"pointer":"/paths/~1transactions~1{id}~1remove-document/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove a document from a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes an attachment from an EXPENSE or TOPUP transaction"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1{id}~1remove-document/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1{id}~1remove-document/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RemoveDocumentDto"}},"schemaId":"components/schemas/RemoveDocumentDto","pointer":"/paths/~1transactions~1{id}~1remove-document/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/transactions/{id}/remove-document","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RemoveDocumentDto"}},"responseCodes":["200","400"],"pointer":"/transactions/{id}/remove-document","href":"transactions/transactionscontroller_removetransactiondocument","openApiOperationId":"TransactionsController_removeTransactionDocument","summary":"Remove a document from a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RemoveDocumentDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RemoveDocumentDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Document removed successfully"},{"code":"400","description":"Bad Request - Transaction not found or unsupported transaction type"}],"pointer":"/paths/~1transactions~1{id}~1remove-document/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_removetransactiondocument"}],"panels":[]}]},"httpPath":"/transactions/{id}/remove-document"},{"label":"Upload a supporting document for a transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/transactions/transactionscontroller_uploadanysupportingdocument","routeSlug":"/v2/openapi/transactions/transactionscontroller_uploadanysupportingdocument","metadata":{"seo":{"title":"Upload a supporting document for a transaction","description":"Uploads a supporting document (PDF, XLS, XLSX, DOCX, CSV, PNG, JPEG) to S3 for a specific transaction. Maximum file size is 10MB."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TransactionsController_uploadAnySupportingDocument","name":"Upload a supporting document for a transaction","isWebhook":false,"pointer":"/paths/~1transactions~1supporting-document/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload a supporting document for a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Uploads a supporting document (PDF, XLS, XLSX, DOCX, CSV, PNG, JPEG) to S3 for a specific transaction. Maximum file size is 10MB."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"id","in":"query","schemaId":"schema_110","required":true}],"pointer":"/paths/~1transactions~1supporting-document/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1transactions~1supporting-document/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"schemaId":"components/schemas/UploadSupportingDocumentDto","pointer":"/paths/~1transactions~1supporting-document/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/transactions/supporting-document","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"id","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"responseCodes":["201","400","404"],"pointer":"/transactions/supporting-document","href":"transactions/transactionscontroller_uploadanysupportingdocument","openApiOperationId":"TransactionsController_uploadAnySupportingDocument","summary":"Upload a supporting document for a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UploadSupportingDocumentDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Document uploaded successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"}},"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"},{"code":"400","description":"Bad Request - Invalid content type, file format, or file size exceeds limit"},{"code":"404","description":"Transaction not found"}],"pointer":"/paths/~1transactions~1supporting-document/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/UploadSupportingDocumentResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadSupportingDocumentResponseDto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/transactionscontroller_uploadanysupportingdocument"}],"panels":[]}]},"httpPath":"/transactions/supporting-document"}],"content":{"contentType":"group","meta":{"name":"transactions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"transactions","showPageActions":true},{"nodeType":"markdoc","content":"Read the transaction ledger, tag transactions and attach documents."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/transactions/new","summary":"Create a new transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/transactionscontroller_createtransaction","deprecated":false},{"title":"/transactions/money-movement","summary":"Get money movement analytics for a specific month","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/transactionscontroller_getmoneymovement","deprecated":false},{"title":"/transactions/fees","summary":"Get transaction fees","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/transactionscontroller_getfees","deprecated":false},{"title":"/transactions/recent","summary":"Get recent transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/transactionscontroller_getrecenttransactions","deprecated":false},{"title":"/transactions/{id}","summary":"Get transaction by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/transactionscontroller_gettransaction","deprecated":false},{"title":"/transactions","summary":"List transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/transactionscontroller_listalltransactions","deprecated":false},{"title":"/transactions/{id}/approve","summary":"Approve a transaction","prefix":{"name":"put","color":"put"},"badges":[],"link":"/transactions/transactionscontroller_approvetransaction","deprecated":false},{"title":"/transactions/{id}/reject","summary":"Reject a transaction","prefix":{"name":"put","color":"put"},"badges":[],"link":"/transactions/transactionscontroller_rejecttransaction","deprecated":false},{"title":"/transactions/{id}/tag","summary":"Tag a transaction with a subcategory","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/transactionscontroller_tagtransaction","deprecated":false},{"title":"/transactions/{id}/supporting-document","summary":"Upload a supporting document for a transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/transactionscontroller_uploadsupportingdocument","deprecated":false},{"title":"/transactions/{id}/remove-document","summary":"Remove a document from a transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/transactionscontroller_removetransactiondocument","deprecated":false},{"title":"/transactions/supporting-document","summary":"Upload a supporting document for a transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/transactionscontroller_uploadanysupportingdocument","deprecated":false}]}]}]}]}},{"type":"group","label":"accounts","link":"/v2/openapi/accounts","routeSlug":"/v2/openapi/accounts","items":[{"label":"List user accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_listuseraccounts","routeSlug":"/v2/openapi/accounts/accountscontroller_listuseraccounts","metadata":{"seo":{"title":"List user accounts","description":"List user accounts"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_listUserAccounts","name":"List user accounts","isWebhook":false,"pointer":"/paths/~1accounts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List user accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1accounts/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","400"],"pointer":"/accounts","href":"accounts/accountscontroller_listuseraccounts","openApiOperationId":"AccountsController_listUserAccounts","summary":"List user accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of user accounts","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedResponseDto"}},"schemaId":"components/schemas/PaginatedResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedResponseDto"}}},{"code":"400","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_listuseraccounts"}],"panels":[]}]},"httpPath":"/accounts"},{"label":"Create a new account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_createaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_createaccount","metadata":{"seo":{"title":"Create a new account","description":"Create a new account"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_createAccount","name":"Create a new account","isWebhook":false,"pointer":"/paths/~1accounts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateAccountV1Dto"}},"schemaId":"components/schemas/CreateAccountV1Dto","pointer":"/paths/~1accounts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accounts","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateAccountV1Dto"}},"responseCodes":["201","400"],"pointer":"/accounts","href":"accounts/accountscontroller_createaccount","openApiOperationId":"AccountsController_createAccount","summary":"Create a new account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateAccountV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateAccountV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Account created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}},"schemaId":"components/schemas/BaseResponseDto"},{"code":"400","description":"Bad Request - Invalid account data","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BaseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}}},{"code":"400","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_createaccount"}],"panels":[]}]},"httpPath":"/accounts"},{"label":"Get business wallet references/currencies","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_getbusinesscurrencies","routeSlug":"/v2/openapi/accounts/accountscontroller_getbusinesscurrencies","metadata":{"seo":{"title":"Get business wallet references/currencies","description":"Get business wallet references/currencies"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_getBusinessCurrencies","name":"Get business wallet references/currencies","isWebhook":false,"pointer":"/paths/~1accounts~1business-currencies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get business wallet references/currencies","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1business-currencies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts/business-currencies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","400"],"pointer":"/accounts/business-currencies","href":"accounts/accountscontroller_getbusinesscurrencies","openApiOperationId":"AccountsController_getBusinessCurrencies","summary":"Get business wallet references/currencies"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of business wallet references with their currencies","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_140"}},"schemaId":"schema_140"},{"code":"400","description":"Bad Request - Missing required headers"}],"pointer":"/paths/~1accounts~1business-currencies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_140","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_140"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_getbusinesscurrencies"}],"panels":[]}]},"httpPath":"/accounts/business-currencies"},{"label":"Provision a new business currency","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_createnewcurrency","routeSlug":"/v2/openapi/accounts/accountscontroller_createnewcurrency","metadata":{"seo":{"title":"Provision a new business currency","description":"Creates a new currency record for the business on the upstream service. The currency is required before any wallet can be created in that currency."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_createNewCurrency","name":"Provision a new business currency","isWebhook":false,"pointer":"/paths/~1accounts~1create-new-currency/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Provision a new business currency","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new currency record for the business on the upstream service. The currency is required before any wallet can be created in that currency."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1create-new-currency/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCurrencyV1Dto"}},"schemaId":"components/schemas/CreateCurrencyV1Dto","pointer":"/paths/~1accounts~1create-new-currency/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accounts/create-new-currency","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateCurrencyV1Dto"}},"responseCodes":["201","400","409"],"pointer":"/accounts/create-new-currency","href":"accounts/accountscontroller_createnewcurrency","openApiOperationId":"AccountsController_createNewCurrency","summary":"Provision a new business currency"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateCurrencyV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCurrencyV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Currency provisioned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}},"schemaId":"components/schemas/BaseResponseDto"},{"code":"400","description":"Bad Request - Invalid currency code","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"},{"code":"409","description":"Currency already exists for this business","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts~1create-new-currency/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BaseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}}},{"code":"400","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}},{"code":"409","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_createnewcurrency"}],"panels":[]}]},"httpPath":"/accounts/create-new-currency"},{"label":"Create a new account (wallet) for the business","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_addnewaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_addnewaccount","metadata":{"seo":{"title":"Create a new account (wallet) for the business","description":"Creates a wallet for the business in the requested currency. If the currency does not yet exist for the business it is provisioned first. Wallets are unique per (currency, walletType)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_addNewAccount","name":"Create a new account (wallet) for the business","isWebhook":false,"pointer":"/paths/~1accounts~1add-new-account/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new account (wallet) for the business","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a wallet for the business in the requested currency. If the currency does not yet exist for the business it is provisioned first. Wallets are unique per (currency, walletType)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1add-new-account/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddAccountV1Dto"}},"schemaId":"components/schemas/AddAccountV1Dto","pointer":"/paths/~1accounts~1add-new-account/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accounts/add-new-account","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddAccountV1Dto"}},"responseCodes":["201","400","409"],"pointer":"/accounts/add-new-account","href":"accounts/accountscontroller_addnewaccount","openApiOperationId":"AccountsController_addNewAccount","summary":"Create a new account (wallet) for the business"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddAccountV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddAccountV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Account created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddAccountResponseV1Dto"}},"schemaId":"components/schemas/AddAccountResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid payload or wallet type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"},{"code":"409","description":"Account already exists for the requested currency and wallet type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts~1add-new-account/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/AddAccountResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddAccountResponseV1Dto"}}},{"code":"400","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}},{"code":"409","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_addnewaccount"}],"panels":[]}]},"httpPath":"/accounts/add-new-account"},{"label":"Get cashflow report for accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_getcashflowreport","routeSlug":"/v2/openapi/accounts/accountscontroller_getcashflowreport","metadata":{"seo":{"title":"Get cashflow report for accounts","description":"Get cashflow report for accounts"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_getCashflowReport","name":"Get cashflow report for accounts","isWebhook":false,"pointer":"/paths/~1accounts~1cashflow-report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get cashflow report for accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"from","in":"query","schemaId":"schema_141","description":"Start date for the report period (YYYY-MM-DD)","required":true},{"name":"to","in":"query","schemaId":"schema_142","description":"End date for the report period (YYYY-MM-DD)","required":true},{"name":"org_wallet_ref","in":"query","schemaId":"schema_126","description":"Organization wallet reference ID to filter by specific currency"},{"name":"account","in":"query","schemaId":"schema_143","description":"Account filter"}],"pointer":"/paths/~1accounts~1cashflow-report/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1cashflow-report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts/cashflow-report","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"from","in":"query","required":true,"example":"2026-04-18","schemaId":"schema_141"},{"name":"to","in":"query","required":true,"example":"2026-05-18","schemaId":"schema_142"},{"name":"org_wallet_ref","in":"query","required":false,"example":"1","schemaId":"schema_126"},{"name":"account","in":"query","required":false,"example":"acc-123","schemaId":"schema_143"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","400"],"pointer":"/accounts/cashflow-report","href":"accounts/accountscontroller_getcashflowreport","openApiOperationId":"AccountsController_getCashflowReport","summary":"Get cashflow report for accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Cashflow report generated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CashflowReportResponseV1Dto"}},"schemaId":"components/schemas/CashflowReportResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts~1cashflow-report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CashflowReportResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CashflowReportResponseV1Dto"}}},{"code":"400","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_getcashflowreport"}],"panels":[]}]},"httpPath":"/accounts/cashflow-report"},{"label":"Get account by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_getaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_getaccount","metadata":{"seo":{"title":"Get account by ID","description":"Get account by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_getAccount","name":"Get account by ID","isWebhook":false,"pointer":"/paths/~1accounts~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get account by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","404"],"pointer":"/accounts/{id}","href":"accounts/accountscontroller_getaccount","openApiOperationId":"AccountsController_getAccount","summary":"Get account by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Account details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}},"schemaId":"components/schemas/BaseResponseDto"},{"code":"404","description":"Account not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}},"schemaId":"components/schemas/ErrorResponseDto"}],"pointer":"/paths/~1accounts~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BaseResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BaseResponseDto"}}},{"code":"404","schemaId":"components/schemas/ErrorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_getaccount"}],"panels":[]}]},"httpPath":"/accounts/{id}"},{"label":"Update account details","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_updateaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_updateaccount","metadata":{"seo":{"title":"Update account details","description":"Update account details"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_updateAccount","name":"Update account details","isWebhook":false,"pointer":"/paths/~1accounts~1{id}/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update account details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/accounts/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"responseCodes":["200","404"],"pointer":"/accounts/{id}","href":"accounts/accountscontroller_updateaccount","openApiOperationId":"AccountsController_updateAccount","summary":"Update account details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Account updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}},"schemaId":"components/schemas/AccountV1Dto"},{"code":"404","description":"Account not found"}],"pointer":"/paths/~1accounts~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AccountV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_updateaccount"}],"panels":[]}]},"httpPath":"/accounts/{id}"},{"label":"Get account balance","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_getaccountbalance","routeSlug":"/v2/openapi/accounts/accountscontroller_getaccountbalance","metadata":{"seo":{"title":"Get account balance","description":"Get account balance"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_getAccountBalance","name":"Get account balance","isWebhook":false,"pointer":"/paths/~1accounts~1{id}~1balance/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get account balance","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}~1balance/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}~1balance/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts/{id}/balance","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","404"],"pointer":"/accounts/{id}/balance","href":"accounts/accountscontroller_getaccountbalance","openApiOperationId":"AccountsController_getAccountBalance","summary":"Get account balance"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Account balance details"},{"code":"404","description":"Account not found"}],"pointer":"/paths/~1accounts~1{id}~1balance/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_getaccountbalance"}],"panels":[]}]},"httpPath":"/accounts/{id}/balance"},{"label":"Get account transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_getaccounttransactions","routeSlug":"/v2/openapi/accounts/accountscontroller_getaccounttransactions","metadata":{"seo":{"title":"Get account transactions","description":"Get account transactions"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_getAccountTransactions","name":"Get account transactions","isWebhook":false,"pointer":"/paths/~1accounts~1{id}~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get account transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"},{"name":"to","in":"query","schemaId":"schema_144","description":"To Date"},{"name":"from","in":"query","schemaId":"schema_145","description":"From Date"}],"pointer":"/paths/~1accounts~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/accounts/{id}/transactions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"},{"name":"to","in":"query","required":false,"example":"2025-12-01","schemaId":"schema_144"},{"name":"from","in":"query","required":false,"example":"2025-10-01","schemaId":"schema_145"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:read"]}],"responseCodes":["200","400","404"],"pointer":"/accounts/{id}/transactions","href":"accounts/accountscontroller_getaccounttransactions","openApiOperationId":"AccountsController_getAccountTransactions","summary":"Get account transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of account transactions"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"},{"code":"404","description":"Account not found"}],"pointer":"/paths/~1accounts~1{id}~1transactions/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_getaccounttransactions"}],"panels":[]}]},"httpPath":"/accounts/{id}/transactions"},{"label":"Suspend account","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_suspendaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_suspendaccount","metadata":{"seo":{"title":"Suspend account","description":"Suspend account"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_suspendAccount","name":"Suspend account","isWebhook":false,"pointer":"/paths/~1accounts~1{id}~1suspend/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suspend account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}~1suspend/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}~1suspend/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/accounts/{id}/suspend","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"responseCodes":["200","404"],"pointer":"/accounts/{id}/suspend","href":"accounts/accountscontroller_suspendaccount","openApiOperationId":"AccountsController_suspendAccount","summary":"Suspend account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Account suspended successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}},"schemaId":"components/schemas/AccountV1Dto"},{"code":"404","description":"Account not found"}],"pointer":"/paths/~1accounts~1{id}~1suspend/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AccountV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_suspendaccount"}],"panels":[]}]},"httpPath":"/accounts/{id}/suspend"},{"label":"Activate account","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/accounts/accountscontroller_activateaccount","routeSlug":"/v2/openapi/accounts/accountscontroller_activateaccount","metadata":{"seo":{"title":"Activate account","description":"Activate account"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AccountsController_activateAccount","name":"Activate account","isWebhook":false,"pointer":"/paths/~1accounts~1{id}~1activate/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Activate account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["accounts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1accounts~1{id}~1activate/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1accounts~1{id}~1activate/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/accounts/{id}/activate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["accounts:write"]}],"responseCodes":["200","404"],"pointer":"/accounts/{id}/activate","href":"accounts/accountscontroller_activateaccount","openApiOperationId":"AccountsController_activateAccount","summary":"Activate account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Account activated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}},"schemaId":"components/schemas/AccountV1Dto"},{"code":"404","description":"Account not found"}],"pointer":"/paths/~1accounts~1{id}~1activate/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AccountV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccountV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/accountscontroller_activateaccount"}],"panels":[]}]},"httpPath":"/accounts/{id}/activate"}],"content":{"contentType":"group","meta":{"name":"accounts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"accounts","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Business wallets — balances, transactions and cashflow."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/accounts","summary":"List user accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_listuseraccounts","deprecated":false},{"title":"/accounts","summary":"Create a new account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accounts/accountscontroller_createaccount","deprecated":false},{"title":"/accounts/business-currencies","summary":"Get business wallet references/currencies","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_getbusinesscurrencies","deprecated":false},{"title":"/accounts/create-new-currency","summary":"Provision a new business currency","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accounts/accountscontroller_createnewcurrency","deprecated":false},{"title":"/accounts/add-new-account","summary":"Create a new account (wallet) for the business","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accounts/accountscontroller_addnewaccount","deprecated":false},{"title":"/accounts/cashflow-report","summary":"Get cashflow report for accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_getcashflowreport","deprecated":false},{"title":"/accounts/{id}","summary":"Get account by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_getaccount","deprecated":false},{"title":"/accounts/{id}","summary":"Update account details","prefix":{"name":"put","color":"put"},"badges":[],"link":"/accounts/accountscontroller_updateaccount","deprecated":false},{"title":"/accounts/{id}/balance","summary":"Get account balance","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_getaccountbalance","deprecated":false},{"title":"/accounts/{id}/transactions","summary":"Get account transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/accounts/accountscontroller_getaccounttransactions","deprecated":false},{"title":"/accounts/{id}/suspend","summary":"Suspend account","prefix":{"name":"put","color":"put"},"badges":[],"link":"/accounts/accountscontroller_suspendaccount","deprecated":false},{"title":"/accounts/{id}/activate","summary":"Activate account","prefix":{"name":"put","color":"put"},"badges":[],"link":"/accounts/accountscontroller_activateaccount","deprecated":false}]}]}]}]}},{"type":"group","label":"categories","link":"/v2/openapi/categories","routeSlug":"/v2/openapi/categories","items":[{"label":"List categories","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_listcategories","routeSlug":"/v2/openapi/categories/categoriescontroller_listcategories","metadata":{"seo":{"title":"List categories","description":"List categories"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_listCategories","name":"List categories","isWebhook":false,"pointer":"/paths/~1categories/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List categories","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Items per page (max 1000)"}],"pointer":"/paths/~1categories/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/categories","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:read"]}],"responseCodes":["200"],"pointer":"/categories","href":"categories/categoriescontroller_listcategories","openApiOperationId":"CategoriesController_listCategories","summary":"List categories"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of categories","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCategoryResponseDto"}},"schemaId":"components/schemas/PaginatedCategoryResponseDto"}],"pointer":"/paths/~1categories/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedCategoryResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedCategoryResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_listcategories"}],"panels":[]}]},"httpPath":"/categories"},{"label":"Create a new category","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_createcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_createcategory","metadata":{"seo":{"title":"Create a new category","description":"Create a new category"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_createCategory","name":"Create a new category","isWebhook":false,"pointer":"/paths/~1categories/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCategoryV1Dto"}},"schemaId":"components/schemas/CreateCategoryV1Dto","pointer":"/paths/~1categories/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/categories","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateCategoryV1Dto"}},"responseCodes":["201"],"pointer":"/categories","href":"categories/categoriescontroller_createcategory","openApiOperationId":"CategoriesController_createCategory","summary":"Create a new category"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateCategoryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCategoryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Category created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}},"schemaId":"components/schemas/CategoryV1Dto"}],"pointer":"/paths/~1categories/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/CategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_createcategory"}],"panels":[]}]},"httpPath":"/categories"},{"label":"Get category by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_getcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_getcategory","metadata":{"seo":{"title":"Get category by ID","description":"Get category by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_getCategory","name":"Get category by ID","isWebhook":false,"pointer":"/paths/~1categories~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get category by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/categories/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:read"]}],"responseCodes":["200"],"pointer":"/categories/{id}","href":"categories/categoriescontroller_getcategory","openApiOperationId":"CategoriesController_getCategory","summary":"Get category by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Category details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}},"schemaId":"components/schemas/CategoryV1Dto"}],"pointer":"/paths/~1categories~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_getcategory"}],"panels":[]}]},"httpPath":"/categories/{id}"},{"label":"Update a category","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_updatecategory","routeSlug":"/v2/openapi/categories/categoriescontroller_updatecategory","metadata":{"seo":{"title":"Update a category","description":"Update a category"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_updateCategory","name":"Update a category","isWebhook":false,"pointer":"/paths/~1categories~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateCategoryV1Dto"}},"schemaId":"components/schemas/UpdateCategoryV1Dto","pointer":"/paths/~1categories~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/categories/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateCategoryV1Dto"}},"responseCodes":["200"],"pointer":"/categories/{id}","href":"categories/categoriescontroller_updatecategory","openApiOperationId":"CategoriesController_updateCategory","summary":"Update a category"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateCategoryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateCategoryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Category updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}},"schemaId":"components/schemas/CategoryV1Dto"}],"pointer":"/paths/~1categories~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CategoryV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_updatecategory"}],"panels":[]}]},"httpPath":"/categories/{id}"},{"label":"Delete category","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_deletecategory","routeSlug":"/v2/openapi/categories/categoriescontroller_deletecategory","metadata":{"seo":{"title":"Delete category","description":"Delete category"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_deleteCategory","name":"Delete category","isWebhook":false,"pointer":"/paths/~1categories~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/categories/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"responseCodes":["200"],"pointer":"/categories/{id}","href":"categories/categoriescontroller_deletecategory","openApiOperationId":"CategoriesController_deleteCategory","summary":"Delete category"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Category deleted successfully"}],"pointer":"/paths/~1categories~1{id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_deletecategory"}],"panels":[]}]},"httpPath":"/categories/{id}"},{"label":"Bulk create categories and subcategories","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_bulkcreatecategories","routeSlug":"/v2/openapi/categories/categoriescontroller_bulkcreatecategories","metadata":{"seo":{"title":"Bulk create categories and subcategories","description":"Creates multiple categories and subcategories in a single request. Automatically groups subcategories under their parent categories."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_bulkCreateCategories","name":"Bulk create categories and subcategories","isWebhook":false,"pointer":"/paths/~1categories~1bulk/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bulk create categories and subcategories","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates multiple categories and subcategories in a single request. Automatically groups subcategories under their parent categories."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1bulk/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BulkCreateCategoryV1Dto"}},"schemaId":"components/schemas/BulkCreateCategoryV1Dto","pointer":"/paths/~1categories~1bulk/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/categories/bulk","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BulkCreateCategoryV1Dto"}},"responseCodes":["201","400"],"pointer":"/categories/bulk","href":"categories/categoriescontroller_bulkcreatecategories","openApiOperationId":"CategoriesController_bulkCreateCategories","summary":"Bulk create categories and subcategories"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/BulkCreateCategoryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BulkCreateCategoryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Categories and subcategories created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkCreateCategoryResponseV1Dto"}},"schemaId":"components/schemas/BulkCreateCategoryResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid input data or empty array"}],"pointer":"/paths/~1categories~1bulk/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BulkCreateCategoryResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BulkCreateCategoryResponseV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_bulkcreatecategories"}],"panels":[]}]},"httpPath":"/categories/bulk"},{"label":"List subcategories for a category","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_listsubcategories","routeSlug":"/v2/openapi/categories/categoriescontroller_listsubcategories","metadata":{"seo":{"title":"List subcategories for a category","description":"List subcategories for a category"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_listSubcategories","name":"List subcategories for a category","isWebhook":false,"pointer":"/paths/~1categories~1{categoryId}~1subcategories/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List subcategories for a category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Items per page (max 1000)"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/categories/{categoryId}/subcategories","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:read"]}],"responseCodes":["200"],"pointer":"/categories/{categoryId}/subcategories","href":"categories/categoriescontroller_listsubcategories","openApiOperationId":"CategoriesController_listSubcategories","summary":"List subcategories for a category"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of subcategories","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedSubcategoryResponseDto"}},"schemaId":"components/schemas/PaginatedSubcategoryResponseDto"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedSubcategoryResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedSubcategoryResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_listsubcategories"}],"panels":[]}]},"httpPath":"/categories/{categoryId}/subcategories"},{"label":"Create a new subcategory","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_createsubcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_createsubcategory","metadata":{"seo":{"title":"Create a new subcategory","description":"Create a new subcategory"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_createSubcategory","name":"Create a new subcategory","isWebhook":false,"pointer":"/paths/~1categories~1{categoryId}~1subcategories/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","description":"Category ID","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubcategoryV1Dto"}},"schemaId":"components/schemas/CreateSubcategoryV1Dto","pointer":"/paths/~1categories~1{categoryId}~1subcategories/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/categories/{categoryId}/subcategories","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSubcategoryV1Dto"}},"responseCodes":["201","400","404"],"pointer":"/categories/{categoryId}/subcategories","href":"categories/categoriescontroller_createsubcategory","openApiOperationId":"CategoriesController_createSubcategory","summary":"Create a new subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateSubcategoryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubcategoryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Subcategory created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}},"schemaId":"components/schemas/SubcategoryV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Category not found"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/SubcategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_createsubcategory"}],"panels":[]}]},"httpPath":"/categories/{categoryId}/subcategories"},{"label":"Get subcategory by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_getsubcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_getsubcategory","metadata":{"seo":{"title":"Get subcategory by ID","description":"Get subcategory by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_getSubcategory","name":"Get subcategory by ID","isWebhook":false,"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get subcategory by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","required":true},{"name":"subcategoryId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/categories/{categoryId}/subcategories/{subcategoryId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"},{"name":"subcategoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:read"]}],"responseCodes":["200"],"pointer":"/categories/{categoryId}/subcategories/{subcategoryId}","href":"categories/categoriescontroller_getsubcategory","openApiOperationId":"CategoriesController_getSubcategory","summary":"Get subcategory by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subcategory details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}},"schemaId":"components/schemas/SubcategoryV1Dto"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubcategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_getsubcategory"}],"panels":[]}]},"httpPath":"/categories/{categoryId}/subcategories/{subcategoryId}"},{"label":"Update a subcategory","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_updatesubcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_updatesubcategory","metadata":{"seo":{"title":"Update a subcategory","description":"Update a subcategory"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_updateSubcategory","name":"Update a subcategory","isWebhook":false,"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","description":"Category ID","required":true},{"name":"subcategoryId","in":"path","schemaId":"schema_110","description":"Subcategory ID","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryV1Dto"}},"schemaId":"components/schemas/UpdateSubcategoryV1Dto","pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/categories/{categoryId}/subcategories/{subcategoryId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"},{"name":"subcategoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/categories/{categoryId}/subcategories/{subcategoryId}","href":"categories/categoriescontroller_updatesubcategory","openApiOperationId":"CategoriesController_updateSubcategory","summary":"Update a subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateSubcategoryV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubcategoryV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subcategory updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}},"schemaId":"components/schemas/SubcategoryV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Category or subcategory not found"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SubcategoryV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubcategoryV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_updatesubcategory"}],"panels":[]}]},"httpPath":"/categories/{categoryId}/subcategories/{subcategoryId}"},{"label":"Delete subcategory","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/categories/categoriescontroller_deletesubcategory","routeSlug":"/v2/openapi/categories/categoriescontroller_deletesubcategory","metadata":{"seo":{"title":"Delete subcategory","description":"Delete subcategory"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CategoriesController_deleteSubcategory","name":"Delete subcategory","isWebhook":false,"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete subcategory","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["categories:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"categoryId","in":"path","schemaId":"schema_110","required":true},{"name":"subcategoryId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/categories/{categoryId}/subcategories/{subcategoryId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"categoryId","in":"path","required":true,"schemaId":"schema_110"},{"name":"subcategoryId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["categories:write"]}],"responseCodes":["200"],"pointer":"/categories/{categoryId}/subcategories/{subcategoryId}","href":"categories/categoriescontroller_deletesubcategory","openApiOperationId":"CategoriesController_deleteSubcategory","summary":"Delete subcategory"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subcategory deleted successfully"}],"pointer":"/paths/~1categories~1{categoryId}~1subcategories~1{subcategoryId}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/categoriescontroller_deletesubcategory"}],"panels":[]}]},"httpPath":"/categories/{categoryId}/subcategories/{subcategoryId}"}],"content":{"contentType":"group","meta":{"name":"categories"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"categories","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Chart of accounts — categories and subcategories for accounting."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/categories","summary":"List categories","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/categoriescontroller_listcategories","deprecated":false},{"title":"/categories","summary":"Create a new category","prefix":{"name":"post","color":"post"},"badges":[],"link":"/categories/categoriescontroller_createcategory","deprecated":false},{"title":"/categories/{id}","summary":"Get category by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/categoriescontroller_getcategory","deprecated":false},{"title":"/categories/{id}","summary":"Update a category","prefix":{"name":"put","color":"put"},"badges":[],"link":"/categories/categoriescontroller_updatecategory","deprecated":false},{"title":"/categories/{id}","summary":"Delete category","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/categories/categoriescontroller_deletecategory","deprecated":false},{"title":"/categories/bulk","summary":"Bulk create categories and subcategories","prefix":{"name":"post","color":"post"},"badges":[],"link":"/categories/categoriescontroller_bulkcreatecategories","deprecated":false},{"title":"/categories/{categoryId}/subcategories","summary":"List subcategories for a category","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/categoriescontroller_listsubcategories","deprecated":false},{"title":"/categories/{categoryId}/subcategories","summary":"Create a new subcategory","prefix":{"name":"post","color":"post"},"badges":[],"link":"/categories/categoriescontroller_createsubcategory","deprecated":false},{"title":"/categories/{categoryId}/subcategories/{subcategoryId}","summary":"Get subcategory by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/categoriescontroller_getsubcategory","deprecated":false},{"title":"/categories/{categoryId}/subcategories/{subcategoryId}","summary":"Update a subcategory","prefix":{"name":"put","color":"put"},"badges":[],"link":"/categories/categoriescontroller_updatesubcategory","deprecated":false},{"title":"/categories/{categoryId}/subcategories/{subcategoryId}","summary":"Delete subcategory","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/categories/categoriescontroller_deletesubcategory","deprecated":false}]}]}]}]}},{"type":"group","label":"taxes","link":"/v2/openapi/taxes","routeSlug":"/v2/openapi/taxes","items":[{"label":"List all withholding tax settings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/taxes/taxescontroller_listtaxes","routeSlug":"/v2/openapi/taxes/taxescontroller_listtaxes","metadata":{"seo":{"title":"List all withholding tax settings","description":"List all withholding tax settings"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TaxesController_listTaxes","name":"List all withholding tax settings","isWebhook":false,"pointer":"/paths/~1taxes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all withholding tax settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["taxes:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1taxes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/taxes","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["taxes:read"]}],"responseCodes":["200"],"pointer":"/taxes","href":"taxes/taxescontroller_listtaxes","openApiOperationId":"TaxesController_listTaxes","summary":"List all withholding tax settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of tax settings","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTaxResponseDto"}},"schemaId":"components/schemas/PaginatedTaxResponseDto"}],"pointer":"/paths/~1taxes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedTaxResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTaxResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/taxes/taxescontroller_listtaxes"}],"panels":[]}]},"httpPath":"/taxes"},{"label":"Create a new withholding tax setting","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/taxes/taxescontroller_createtax","routeSlug":"/v2/openapi/taxes/taxescontroller_createtax","metadata":{"seo":{"title":"Create a new withholding tax setting","description":"Create a new withholding tax setting"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TaxesController_createTax","name":"Create a new withholding tax setting","isWebhook":false,"pointer":"/paths/~1taxes~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new withholding tax setting","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["taxes:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1taxes~1create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTaxV1Dto"}},"schemaId":"components/schemas/CreateTaxV1Dto","pointer":"/paths/~1taxes~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/taxes/create","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["taxes:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateTaxV1Dto"}},"responseCodes":["201","400"],"pointer":"/taxes/create","href":"taxes/taxescontroller_createtax","openApiOperationId":"TaxesController_createTax","summary":"Create a new withholding tax setting"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateTaxV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTaxV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Tax setting created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}},"schemaId":"components/schemas/TaxV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"}],"pointer":"/paths/~1taxes~1create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/TaxV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/taxes/taxescontroller_createtax"}],"panels":[]}]},"httpPath":"/taxes/create"},{"label":"Edit a withholding tax setting","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/taxes/taxescontroller_updatetax","routeSlug":"/v2/openapi/taxes/taxescontroller_updatetax","metadata":{"seo":{"title":"Edit a withholding tax setting","description":"Edit a withholding tax setting"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TaxesController_updateTax","name":"Edit a withholding tax setting","isWebhook":false,"pointer":"/paths/~1taxes~1{taxId}~1edit/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Edit a withholding tax setting","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["taxes:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"taxId","in":"path","schemaId":"schema_110","description":"Tax ID","required":true}],"pointer":"/paths/~1taxes~1{taxId}~1edit/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1taxes~1{taxId}~1edit/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTaxV1Dto"}},"schemaId":"components/schemas/UpdateTaxV1Dto","pointer":"/paths/~1taxes~1{taxId}~1edit/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/taxes/{taxId}/edit","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"taxId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["taxes:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateTaxV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/taxes/{taxId}/edit","href":"taxes/taxescontroller_updatetax","openApiOperationId":"TaxesController_updateTax","summary":"Edit a withholding tax setting"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateTaxV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTaxV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Tax setting updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}},"schemaId":"components/schemas/TaxV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Tax setting not found"}],"pointer":"/paths/~1taxes~1{taxId}~1edit/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TaxV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/taxes/taxescontroller_updatetax"}],"panels":[]}]},"httpPath":"/taxes/{taxId}/edit"},{"label":"Archive/delete a withholding tax setting","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/taxes/taxescontroller_archivetax","routeSlug":"/v2/openapi/taxes/taxescontroller_archivetax","metadata":{"seo":{"title":"Archive/delete a withholding tax setting","description":"Archive/delete a withholding tax setting"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TaxesController_archiveTax","name":"Archive/delete a withholding tax setting","isWebhook":false,"pointer":"/paths/~1taxes~1{taxId}~1archive/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Archive/delete a withholding tax setting","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["taxes:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"taxId","in":"path","schemaId":"schema_110","description":"Tax ID","required":true}],"pointer":"/paths/~1taxes~1{taxId}~1archive/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1taxes~1{taxId}~1archive/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/taxes/{taxId}/archive","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"taxId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["taxes:write"]}],"responseCodes":["200","404"],"pointer":"/taxes/{taxId}/archive","href":"taxes/taxescontroller_archivetax","openApiOperationId":"TaxesController_archiveTax","summary":"Archive/delete a withholding tax setting"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Tax setting archived successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}},"schemaId":"components/schemas/TaxV1Dto"},{"code":"404","description":"Tax setting not found"}],"pointer":"/paths/~1taxes~1{taxId}~1archive/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TaxV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/taxes/taxescontroller_archivetax"}],"panels":[]}]},"httpPath":"/taxes/{taxId}/archive"},{"label":"Fetch all withholding tax transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/taxes/taxescontroller_gettaxtransactions","routeSlug":"/v2/openapi/taxes/taxescontroller_gettaxtransactions","metadata":{"seo":{"title":"Fetch all withholding tax transactions","description":"Fetch all withholding tax transactions"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TaxesController_getTaxTransactions","name":"Fetch all withholding tax transactions","isWebhook":false,"pointer":"/paths/~1taxes~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch all withholding tax transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["taxes:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1taxes~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/taxes/transactions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["taxes:read"]}],"responseCodes":["200","400","401"],"pointer":"/taxes/transactions","href":"taxes/taxescontroller_gettaxtransactions","openApiOperationId":"TaxesController_getTaxTransactions","summary":"Fetch all withholding tax transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of tax transactions retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxTransactionsResponseV1Dto"}},"schemaId":"components/schemas/TaxTransactionsResponseV1Dto"},{"code":"400","description":"Bad Request - Missing required headers"},{"code":"401","description":"Unauthorized - Invalid or missing authentication token"}],"pointer":"/paths/~1taxes~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TaxTransactionsResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TaxTransactionsResponseV1Dto"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/taxes/taxescontroller_gettaxtransactions"}],"panels":[]}]},"httpPath":"/taxes/transactions"}],"content":{"contentType":"group","meta":{"name":"taxes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"taxes","showPageActions":true},{"nodeType":"markdoc","content":"Withholding tax configuration and transactions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/taxes","summary":"List all withholding tax settings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/taxes/taxescontroller_listtaxes","deprecated":false},{"title":"/taxes/create","summary":"Create a new withholding tax setting","prefix":{"name":"post","color":"post"},"badges":[],"link":"/taxes/taxescontroller_createtax","deprecated":false},{"title":"/taxes/{taxId}/edit","summary":"Edit a withholding tax setting","prefix":{"name":"put","color":"put"},"badges":[],"link":"/taxes/taxescontroller_updatetax","deprecated":false},{"title":"/taxes/{taxId}/archive","summary":"Archive/delete a withholding tax setting","prefix":{"name":"put","color":"put"},"badges":[],"link":"/taxes/taxescontroller_archivetax","deprecated":false},{"title":"/taxes/transactions","summary":"Fetch all withholding tax transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/taxes/taxescontroller_gettaxtransactions","deprecated":false}]}]}]}]}},{"type":"separator","label":"Relationships","content":null},{"type":"group","label":"vendors","link":"/v2/openapi/vendors","routeSlug":"/v2/openapi/vendors","items":[{"label":"List vendors","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_listvendors","routeSlug":"/v2/openapi/vendors/vendorscontroller_listvendors","metadata":{"seo":{"title":"List vendors","description":"List vendors"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_listVendors","name":"List vendors","isWebhook":false,"pointer":"/paths/~1vendors/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List vendors","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Items per page (max 1000)"}],"pointer":"/paths/~1vendors/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/vendors","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:read"]}],"responseCodes":["200"],"pointer":"/vendors","href":"vendors/vendorscontroller_listvendors","openApiOperationId":"VendorsController_listVendors","summary":"List vendors"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of vendors","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedVendorResponseDto"}},"schemaId":"components/schemas/PaginatedVendorResponseDto"}],"pointer":"/paths/~1vendors/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedVendorResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedVendorResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_listvendors"}],"panels":[]}]},"httpPath":"/vendors"},{"label":"Create a new vendor","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_createvendor","routeSlug":"/v2/openapi/vendors/vendorscontroller_createvendor","metadata":{"seo":{"title":"Create a new vendor","description":"Create a new vendor"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_createVendor","name":"Create a new vendor","isWebhook":false,"pointer":"/paths/~1vendors/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new vendor","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateVendorV1Dto"}},"schemaId":"components/schemas/CreateVendorV1Dto","pointer":"/paths/~1vendors/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/vendors","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateVendorV1Dto"}},"responseCodes":["201","400"],"pointer":"/vendors","href":"vendors/vendorscontroller_createvendor","openApiOperationId":"VendorsController_createVendor","summary":"Create a new vendor"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateVendorV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateVendorV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Vendor created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}},"schemaId":"components/schemas/VendorV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"}],"pointer":"/paths/~1vendors/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/VendorV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_createvendor"}],"panels":[]}]},"httpPath":"/vendors"},{"label":"Get recent vendors by channel","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_getrecentvendors","routeSlug":"/v2/openapi/vendors/vendorscontroller_getrecentvendors","metadata":{"seo":{"title":"Get recent vendors by channel","description":"Returns a merged list of recently paid vendors from suppliers and expenses. Vendors from suppliers have an _id, while vendors derived from expenses lack an _id to indicate they can be created as new vendors."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_getRecentVendors","name":"Get recent vendors by channel","isWebhook":false,"pointer":"/paths/~1vendors~1recent~1{channel}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get recent vendors by channel","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a merged list of recently paid vendors from suppliers and expenses. Vendors from suppliers have an _id, while vendors derived from expenses lack an _id to indicate they can be created as new vendors."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"channel","in":"path","schemaId":"schema_146","description":"Payment channel type","required":true}],"pointer":"/paths/~1vendors~1recent~1{channel}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1recent~1{channel}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/vendors/recent/{channel}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"channel","in":"path","required":true,"schemaId":"schema_146"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:read"]}],"responseCodes":["200"],"pointer":"/vendors/recent/{channel}","href":"vendors/vendorscontroller_getrecentvendors","openApiOperationId":"VendorsController_getRecentVendors","summary":"Get recent vendors by channel"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of recent vendors","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}},"schemaId":"schema_147"}],"pointer":"/paths/~1vendors~1recent~1{channel}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_147","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_getrecentvendors"}],"panels":[]}]},"httpPath":"/vendors/recent/{channel}"},{"label":"Get vendor by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_getvendor","routeSlug":"/v2/openapi/vendors/vendorscontroller_getvendor","metadata":{"seo":{"title":"Get vendor by ID","description":"Get vendor by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_getVendor","name":"Get vendor by ID","isWebhook":false,"pointer":"/paths/~1vendors~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get vendor by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","description":"Vendor ID","required":true}],"pointer":"/paths/~1vendors~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/vendors/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:read"]}],"responseCodes":["200","404"],"pointer":"/vendors/{id}","href":"vendors/vendorscontroller_getvendor","openApiOperationId":"VendorsController_getVendor","summary":"Get vendor by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Vendor details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}},"schemaId":"components/schemas/VendorV1Dto"},{"code":"404","description":"Vendor not found"}],"pointer":"/paths/~1vendors~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/VendorV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_getvendor"}],"panels":[]}]},"httpPath":"/vendors/{id}"},{"label":"Update a vendor","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_updatevendor","routeSlug":"/v2/openapi/vendors/vendorscontroller_updatevendor","metadata":{"seo":{"title":"Update a vendor","description":"Update a vendor"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_updateVendor","name":"Update a vendor","isWebhook":false,"pointer":"/paths/~1vendors~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a vendor","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","description":"Vendor ID","required":true}],"pointer":"/paths/~1vendors~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateVendorV1Dto"}},"schemaId":"components/schemas/UpdateVendorV1Dto","pointer":"/paths/~1vendors~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/vendors/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateVendorV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/vendors/{id}","href":"vendors/vendorscontroller_updatevendor","openApiOperationId":"VendorsController_updateVendor","summary":"Update a vendor"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateVendorV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateVendorV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Vendor updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}},"schemaId":"components/schemas/VendorV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Vendor not found"}],"pointer":"/paths/~1vendors~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/VendorV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_updatevendor"}],"panels":[]}]},"httpPath":"/vendors/{id}"},{"label":"Delete vendor","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_deletevendor","routeSlug":"/v2/openapi/vendors/vendorscontroller_deletevendor","metadata":{"seo":{"title":"Delete vendor","description":"Delete vendor"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_deleteVendor","name":"Delete vendor","isWebhook":false,"pointer":"/paths/~1vendors~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete vendor","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","description":"Vendor ID","required":true}],"pointer":"/paths/~1vendors~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/vendors/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:write"]}],"responseCodes":["200","404"],"pointer":"/vendors/{id}","href":"vendors/vendorscontroller_deletevendor","openApiOperationId":"VendorsController_deleteVendor","summary":"Delete vendor"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Vendor deleted successfully"},{"code":"404","description":"Vendor not found"}],"pointer":"/paths/~1vendors~1{id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_deletevendor"}],"panels":[]}]},"httpPath":"/vendors/{id}"},{"label":"Update vendor payment instruction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_updatepaymentinstruction","routeSlug":"/v2/openapi/vendors/vendorscontroller_updatepaymentinstruction","metadata":{"seo":{"title":"Update vendor payment instruction","description":"Update vendor payment instruction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_updatePaymentInstruction","name":"Update vendor payment instruction","isWebhook":false,"pointer":"/paths/~1vendors~1{id}~1payment-instruction/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update vendor payment instruction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","description":"Vendor ID","required":true}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdatePaymentInstructionV1Dto"}},"schemaId":"components/schemas/UpdatePaymentInstructionV1Dto","pointer":"/paths/~1vendors~1{id}~1payment-instruction/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/vendors/{id}/payment-instruction","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdatePaymentInstructionV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/vendors/{id}/payment-instruction","href":"vendors/vendorscontroller_updatepaymentinstruction","openApiOperationId":"VendorsController_updatePaymentInstruction","summary":"Update vendor payment instruction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdatePaymentInstructionV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdatePaymentInstructionV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment instruction updated successfully"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Vendor not found"}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_updatepaymentinstruction"}],"panels":[]}]},"httpPath":"/vendors/{id}/payment-instruction"},{"label":"Add vendor payment instruction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/vendors/vendorscontroller_addpaymentinstruction","routeSlug":"/v2/openapi/vendors/vendorscontroller_addpaymentinstruction","metadata":{"seo":{"title":"Add vendor payment instruction","description":"Add vendor payment instruction"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"VendorsController_addPaymentInstruction","name":"Add vendor payment instruction","isWebhook":false,"pointer":"/paths/~1vendors~1{id}~1payment-instruction~1add/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add vendor payment instruction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["vendors:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","description":"Vendor ID","required":true}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction~1add/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction~1add/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddPaymentInstructionV1Dto"}},"schemaId":"components/schemas/AddPaymentInstructionV1Dto","pointer":"/paths/~1vendors~1{id}~1payment-instruction~1add/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/vendors/{id}/payment-instruction/add","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["vendors:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddPaymentInstructionV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/vendors/{id}/payment-instruction/add","href":"vendors/vendorscontroller_addpaymentinstruction","openApiOperationId":"VendorsController_addPaymentInstruction","summary":"Add vendor payment instruction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddPaymentInstructionV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddPaymentInstructionV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment instruction added successfully"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Vendor not found"}],"pointer":"/paths/~1vendors~1{id}~1payment-instruction~1add/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/vendorscontroller_addpaymentinstruction"}],"panels":[]}]},"httpPath":"/vendors/{id}/payment-instruction/add"}],"content":{"contentType":"group","meta":{"name":"vendors"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"vendors","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payables master data — the businesses you pay."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/vendors","summary":"List vendors","prefix":{"name":"get","color":"get"},"badges":[],"link":"/vendors/vendorscontroller_listvendors","deprecated":false},{"title":"/vendors","summary":"Create a new vendor","prefix":{"name":"post","color":"post"},"badges":[],"link":"/vendors/vendorscontroller_createvendor","deprecated":false},{"title":"/vendors/recent/{channel}","summary":"Get recent vendors by channel","prefix":{"name":"get","color":"get"},"badges":[],"link":"/vendors/vendorscontroller_getrecentvendors","deprecated":false},{"title":"/vendors/{id}","summary":"Get vendor by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/vendors/vendorscontroller_getvendor","deprecated":false},{"title":"/vendors/{id}","summary":"Update a vendor","prefix":{"name":"put","color":"put"},"badges":[],"link":"/vendors/vendorscontroller_updatevendor","deprecated":false},{"title":"/vendors/{id}","summary":"Delete vendor","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/vendors/vendorscontroller_deletevendor","deprecated":false},{"title":"/vendors/{id}/payment-instruction","summary":"Update vendor payment instruction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/vendors/vendorscontroller_updatepaymentinstruction","deprecated":false},{"title":"/vendors/{id}/payment-instruction/add","summary":"Add vendor payment instruction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/vendors/vendorscontroller_addpaymentinstruction","deprecated":false}]}]}]}]}},{"type":"group","label":"customers","link":"/v2/openapi/customers","routeSlug":"/v2/openapi/customers","items":[{"label":"List business customers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_listcustomers","routeSlug":"/v2/openapi/customers/customerscontroller_listcustomers","metadata":{"seo":{"title":"List business customers","description":"Returns customers associated with the business. By default returns only ACTIVE customers; pass ?status=DELETED to list soft-deleted customers or ?status=ALL to list both populations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_listCustomers","name":"List business customers","isWebhook":false,"pointer":"/paths/~1customers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List business customers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns customers associated with the business. By default returns only ACTIVE customers; pass ?status=DELETED to list soft-deleted customers or ?status=ALL to list both populations."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108"},{"name":"limit","in":"query","schemaId":"schema_131"},{"name":"status","in":"query","schemaId":"schema_148","description":"Filter by customer status. Defaults to ACTIVE when omitted."}],"pointer":"/paths/~1customers/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":50,"schemaId":"schema_131"},{"name":"status","in":"query","required":false,"schemaId":"schema_148"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:read"]}],"responseCodes":["200","400","401","403"],"pointer":"/customers","href":"customers/customerscontroller_listcustomers","openApiOperationId":"CustomersController_listCustomers","summary":"List business customers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer list returned successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — invalid status filter"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]}],"pointer":"/paths/~1customers/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_listcustomers"}],"panels":[]}]},"httpPath":"/customers"},{"label":"Create a customer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_createcustomer","routeSlug":"/v2/openapi/customers/customerscontroller_createcustomer","metadata":{"seo":{"title":"Create a customer","description":"Creates a new customer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_createCustomer","name":"Create a customer","isWebhook":false,"pointer":"/paths/~1customers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a customer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a new customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"regular"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"taxPin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"person"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"walkIn"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. Name is auto-set to \"WalkIn\" and all other fields are null. Only one Walk-In customer is allowed per business at a time (active OR archived)."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCustomerDto","exampleIds":["paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer","paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"]}},"schemaId":"components/schemas/CreateCustomerDto","exampleIds":["paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer","paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"],"pointer":"/paths/~1customers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/customers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateCustomerDto","exampleIds":["paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer","paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"]}},"responseCodes":["201","400","401","409"],"pointer":"/customers","href":"customers/customerscontroller_createcustomer","openApiOperationId":"CustomersController_createCustomer","summary":"Create a customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateCustomerDto","exampleIds":["paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer","paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateCustomerDto","exampleIds":["paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer","paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Customer created successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — invalid type, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"taxPin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" missing when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"regular"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict — an active Walk-In customer already exists"},"children":[]}]}]}]}],"pointer":"/paths/~1customers/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_createcustomer"}],"panels":[]}]},"httpPath":"/customers"},{"label":"Get a customer by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_getcustomer","routeSlug":"/v2/openapi/customers/customerscontroller_getcustomer","metadata":{"seo":{"title":"Get a customer by ID","description":"Fetches a single customer document by its MongoDB ObjectId."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_getCustomer","name":"Get a customer by ID","isWebhook":false,"pointer":"/paths/~1customers~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a customer by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches a single customer document by its MongoDB ObjectId."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_149","description":"Customer MongoDB ObjectId","required":true}],"pointer":"/paths/~1customers~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customers/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"64f4205154a6357a7f85f656","schemaId":"schema_149"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:read"]}],"responseCodes":["200","400","401","404"],"pointer":"/customers/{id}","href":"customers/customerscontroller_getcustomer","openApiOperationId":"CustomersController_getCustomer","summary":"Get a customer by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer returned successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — customer ID is required"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — customer not found"},"children":[]}]}]}]}],"pointer":"/paths/~1customers~1{id}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_getcustomer"}],"panels":[]}]},"httpPath":"/customers/{id}"},{"label":"Update a customer by ID","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_updatecustomer","routeSlug":"/v2/openapi/customers/customerscontroller_updatecustomer","metadata":{"seo":{"title":"Update a customer by ID","description":"Updates an active regular customer. Walk-In customers are immutable and cannot be edited."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_updateCustomer","name":"Update a customer by ID","isWebhook":false,"pointer":"/paths/~1customers~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a customer by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates an active regular customer. Walk-In customers are immutable and cannot be edited."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_149","description":"Customer MongoDB ObjectId","required":true}],"pointer":"/paths/~1customers~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateCustomerDto"}},"schemaId":"components/schemas/UpdateCustomerDto","pointer":"/paths/~1customers~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/customers/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"64f4205154a6357a7f85f656","schemaId":"schema_149"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateCustomerDto"}},"responseCodes":["200","400","401","404"],"pointer":"/customers/{id}","href":"customers/customerscontroller_updatecustomer","openApiOperationId":"CustomersController_updateCustomer","summary":"Update a customer by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateCustomerDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateCustomerDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer updated successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — empty payload, or Walk-In customer"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — customer not found"},"children":[]}]}]}]}],"pointer":"/paths/~1customers~1{id}/put/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_updatecustomer"}],"panels":[]}]},"httpPath":"/customers/{id}"},{"label":"Soft-delete a customer by ID","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_deletecustomer","routeSlug":"/v2/openapi/customers/customerscontroller_deletecustomer","metadata":{"seo":{"title":"Soft-delete a customer by ID","description":"Marks an active customer as deleted. The record is retained but excluded from all active customer queries."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_deleteCustomer","name":"Soft-delete a customer by ID","isWebhook":false,"pointer":"/paths/~1customers~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Soft-delete a customer by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Marks an active customer as deleted. The record is retained but excluded from all active customer queries."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_149","description":"Customer MongoDB ObjectId","required":true}],"pointer":"/paths/~1customers~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/customers/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"64f4205154a6357a7f85f656","schemaId":"schema_149"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:write"]}],"responseCodes":["200","401","404"],"pointer":"/customers/{id}","href":"customers/customerscontroller_deletecustomer","openApiOperationId":"CustomersController_deleteCustomer","summary":"Soft-delete a customer by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer deleted successfully"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — active customer not found"},"children":[]}]}]}]}],"pointer":"/paths/~1customers~1{id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_deletecustomer"}],"panels":[]}]},"httpPath":"/customers/{id}"},{"label":"Reactivate a soft-deleted customer by ID","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_reactivatecustomer","routeSlug":"/v2/openapi/customers/customerscontroller_reactivatecustomer","metadata":{"seo":{"title":"Reactivate a soft-deleted customer by ID","description":"Flips a soft-deleted customer back to ACTIVE. Idempotent: calling on an already-active customer is a no-op."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_reactivateCustomer","name":"Reactivate a soft-deleted customer by ID","isWebhook":false,"pointer":"/paths/~1customers~1{id}~1reactivate/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reactivate a soft-deleted customer by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Flips a soft-deleted customer back to ACTIVE. Idempotent: calling on an already-active customer is a no-op."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_149","description":"Customer MongoDB ObjectId","required":true}],"pointer":"/paths/~1customers~1{id}~1reactivate/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers~1{id}~1reactivate/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/customers/{id}/reactivate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"64f4205154a6357a7f85f656","schemaId":"schema_149"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:write"]}],"responseCodes":["200","401","404"],"pointer":"/customers/{id}/reactivate","href":"customers/customerscontroller_reactivatecustomer","openApiOperationId":"CustomersController_reactivateCustomer","summary":"Reactivate a soft-deleted customer by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer reactivated successfully"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — customer not found"},"children":[]}]}]}]}],"pointer":"/paths/~1customers~1{id}~1reactivate/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_reactivatecustomer"}],"panels":[]}]},"httpPath":"/customers/{id}/reactivate"},{"label":"Search active customers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/customers/customerscontroller_searchcustomers","routeSlug":"/v2/openapi/customers/customerscontroller_searchcustomers","metadata":{"seo":{"title":"Search active customers","description":"Full-text search across customer name, phone, and email. Returns up to 10 active matches."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CustomersController_searchCustomers","name":"Search active customers","isWebhook":false,"pointer":"/paths/~1customers~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search active customers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Full-text search across customer name, phone, and email. Returns up to 10 active matches."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["customers:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"q","in":"query","schemaId":"schema_150","description":"Search query string","required":true}],"pointer":"/paths/~1customers~1search/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1customers~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customers/search","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"q","in":"query","required":true,"example":"Acme","schemaId":"schema_150"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["customers:read"]}],"responseCodes":["200","400","401"],"pointer":"/customers/search","href":"customers/customerscontroller_searchcustomers","openApiOperationId":"CustomersController_searchCustomers","summary":"Search active customers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Search results returned successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — search query is required"},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid bearer token"},"children":[]}]}]}]}],"pointer":"/paths/~1customers~1search/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customers/customerscontroller_searchcustomers"}],"panels":[]}]},"httpPath":"/customers/search"}],"content":{"contentType":"group","meta":{"name":"customers"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"customers","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Receivables master data — the businesses that pay you."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/customers","summary":"List business customers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customers/customerscontroller_listcustomers","deprecated":false},{"title":"/customers","summary":"Create a customer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/customers/customerscontroller_createcustomer","deprecated":false},{"title":"/customers/{id}","summary":"Get a customer by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customers/customerscontroller_getcustomer","deprecated":false},{"title":"/customers/{id}","summary":"Update a customer by ID","prefix":{"name":"put","color":"put"},"badges":[],"link":"/customers/customerscontroller_updatecustomer","deprecated":false},{"title":"/customers/{id}","summary":"Soft-delete a customer by ID","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/customers/customerscontroller_deletecustomer","deprecated":false},{"title":"/customers/{id}/reactivate","summary":"Reactivate a soft-deleted customer by ID","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/customers/customerscontroller_reactivatecustomer","deprecated":false},{"title":"/customers/search","summary":"Search active customers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customers/customerscontroller_searchcustomers","deprecated":false}]}]}]}]}},{"type":"group","label":"employees","link":"/v2/openapi/employees","routeSlug":"/v2/openapi/employees","items":[{"label":"List employees","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_listemployees","routeSlug":"/v2/openapi/employees/employeescontroller_listemployees","metadata":{"seo":{"title":"List employees","description":"List employees"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_listEmployees","name":"List employees","isWebhook":false,"pointer":"/paths/~1employees/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List employees","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"},{"name":"team_id","in":"query","schemaId":"schema_110","description":"Filter by team ID"},{"name":"status","in":"query","schemaId":"schema_151","description":"Filter by employee status (e.g., ACTIVE, INACTIVE)"}],"pointer":"/paths/~1employees/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/employees","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"},{"name":"team_id","in":"query","required":false,"schemaId":"schema_110"},{"name":"status","in":"query","required":false,"example":"ACTIVE","schemaId":"schema_151"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:read"]}],"responseCodes":["200","400"],"pointer":"/employees","href":"employees/employeescontroller_listemployees","openApiOperationId":"EmployeesController_listEmployees","summary":"List employees"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of employees","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedEmployeeResponseDto"}},"schemaId":"components/schemas/PaginatedEmployeeResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1employees/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedEmployeeResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedEmployeeResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_listemployees"}],"panels":[]}]},"httpPath":"/employees"},{"label":"Create new employee","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_createemployee","routeSlug":"/v2/openapi/employees/employeescontroller_createemployee","metadata":{"seo":{"title":"Create new employee","description":"Create new employee"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_createEmployee","name":"Create new employee","isWebhook":false,"pointer":"/paths/~1employees/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create new employee","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateEmployeeV1Dto"}},"schemaId":"components/schemas/CreateEmployeeV1Dto","pointer":"/paths/~1employees/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateEmployeeV1Dto"}},"responseCodes":["201"],"pointer":"/employees","href":"employees/employeescontroller_createemployee","openApiOperationId":"EmployeesController_createEmployee","summary":"Create new employee"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateEmployeeV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateEmployeeV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Employee created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmployeeV1Dto"}},"schemaId":"components/schemas/EmployeeV1Dto"}],"pointer":"/paths/~1employees/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/EmployeeV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmployeeV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_createemployee"}],"panels":[]}]},"httpPath":"/employees"},{"label":"Get employee wallet balances","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_getemployeebalances","routeSlug":"/v2/openapi/employees/employeescontroller_getemployeebalances","metadata":{"seo":{"title":"Get employee wallet balances","description":"Get employee wallet balances"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_getEmployeeBalances","name":"Get employee wallet balances","isWebhook":false,"pointer":"/paths/~1employees~1balances/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get employee wallet balances","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"employee_id","in":"query","schemaId":"schema_110","description":"Employee identifier","required":true}],"pointer":"/paths/~1employees~1balances/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1balances/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/employees/balances","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"employee_id","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:read"]}],"responseCodes":["200","400","404"],"pointer":"/employees/balances","href":"employees/employeescontroller_getemployeebalances","openApiOperationId":"EmployeesController_getEmployeeBalances","summary":"Get employee wallet balances"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee wallet balances","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_152"}},"schemaId":"schema_152"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - employee_id is required"},"children":[]}]}]}]},{"code":"404","description":"Not Found - Employee not found"}],"pointer":"/paths/~1employees~1balances/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_152","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_152"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_getemployeebalances"}],"panels":[]}]},"httpPath":"/employees/balances"},{"label":"View employee transaction statement","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_viewstatement","routeSlug":"/v2/openapi/employees/employeescontroller_viewstatement","metadata":{"seo":{"title":"View employee transaction statement","description":"View employee transaction statement"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_viewStatement","name":"View employee transaction statement","isWebhook":false,"pointer":"/paths/~1employees~1view-statement/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"View employee transaction statement","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"employee_id","in":"query","schemaId":"schema_110","description":"Employee identifier","required":true},{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"},{"name":"from","in":"query","schemaId":"schema_153","description":"Start date filter (ISO 8601 format)"},{"name":"to","in":"query","schemaId":"schema_154","description":"End date filter (ISO 8601 format)"}],"pointer":"/paths/~1employees~1view-statement/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1view-statement/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/employees/view-statement","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"employee_id","in":"query","required":true,"schemaId":"schema_110"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"},{"name":"from","in":"query","required":false,"example":"2024-01-01T00:00:00Z","schemaId":"schema_153"},{"name":"to","in":"query","required":false,"example":"2024-12-31T23:59:59Z","schemaId":"schema_154"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:read"]}],"responseCodes":["200","400","401","404"],"pointer":"/employees/view-statement","href":"employees/employeescontroller_viewstatement","openApiOperationId":"EmployeesController_viewStatement","summary":"View employee transaction statement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated employee statement","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedStatementResponseDto"}},"schemaId":"components/schemas/PaginatedStatementResponseDto"},{"code":"400","description":"Bad Request - Invalid parameters"},{"code":"401","description":"Unauthorized"},{"code":"404","description":"Not Found - Employee not found"}],"pointer":"/paths/~1employees~1view-statement/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedStatementResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedStatementResponseDto"}}},{"code":"400"},{"code":"401"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_viewstatement"}],"panels":[]}]},"httpPath":"/employees/view-statement"},{"label":"Get employee by employee_id","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_getemployee","routeSlug":"/v2/openapi/employees/employeescontroller_getemployee","metadata":{"seo":{"title":"Get employee by employee_id","description":"Get employee by employee_id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_getEmployee","name":"Get employee by employee_id","isWebhook":false,"pointer":"/paths/~1employees~1{employee_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get employee by employee_id","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employee_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1employees~1{employee_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1{employee_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/employees/{employee_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employee_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:read"]}],"responseCodes":["200"],"pointer":"/employees/{employee_id}","href":"employees/employeescontroller_getemployee","openApiOperationId":"EmployeesController_getEmployee","summary":"Get employee by employee_id"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmployeeV1Dto"}},"schemaId":"components/schemas/EmployeeV1Dto"}],"pointer":"/paths/~1employees~1{employee_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EmployeeV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmployeeV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_getemployee"}],"panels":[]}]},"httpPath":"/employees/{employee_id}"},{"label":"Delete employee","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_deleteemployee","routeSlug":"/v2/openapi/employees/employeescontroller_deleteemployee","metadata":{"seo":{"title":"Delete employee","description":"Delete employee"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_deleteEmployee","name":"Delete employee","isWebhook":false,"pointer":"/paths/~1employees~1{employee_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete employee","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employee_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1employees~1{employee_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1{employee_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/employees/{employee_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employee_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"responseCodes":["200"],"pointer":"/employees/{employee_id}","href":"employees/employeescontroller_deleteemployee","openApiOperationId":"EmployeesController_deleteEmployee","summary":"Delete employee"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee deleted successfully"}],"pointer":"/paths/~1employees~1{employee_id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_deleteemployee"}],"panels":[]}]},"httpPath":"/employees/{employee_id}"},{"label":"Remove employee from team reviewers","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_removeemployeeteamreviewer","routeSlug":"/v2/openapi/employees/employeescontroller_removeemployeeteamreviewer","metadata":{"seo":{"title":"Remove employee from team reviewers","description":"Remove employee from team reviewers"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_removeEmployeeTeamReviewer","name":"Remove employee from team reviewers","isWebhook":false,"pointer":"/paths/~1employees~1remove-employee-team-reviewer/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove employee from team reviewers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1remove-employee-team-reviewer/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"schemaId":"components/schemas/ReviewerManagementV1Dto","pointer":"/paths/~1employees~1remove-employee-team-reviewer/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/employees/remove-employee-team-reviewer","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/employees/remove-employee-team-reviewer","href":"employees/employeescontroller_removeemployeeteamreviewer","openApiOperationId":"EmployeesController_removeEmployeeTeamReviewer","summary":"Remove employee from team reviewers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ReviewerManagementV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee successfully removed from team reviewers"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Not Found - Employee or team not found"}],"pointer":"/paths/~1employees~1remove-employee-team-reviewer/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_removeemployeeteamreviewer"}],"panels":[]}]},"httpPath":"/employees/remove-employee-team-reviewer"},{"label":"Move employee to a different team","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_moveemployeetoteam","routeSlug":"/v2/openapi/employees/employeescontroller_moveemployeetoteam","metadata":{"seo":{"title":"Move employee to a different team","description":"Move employee to a different team"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_moveEmployeeToTeam","name":"Move employee to a different team","isWebhook":false,"pointer":"/paths/~1employees~1move-to-team/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Move employee to a different team","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1move-to-team/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/MoveEmployeeToTeamV1Dto"}},"schemaId":"components/schemas/MoveEmployeeToTeamV1Dto","pointer":"/paths/~1employees~1move-to-team/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/move-to-team","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/MoveEmployeeToTeamV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/employees/move-to-team","href":"employees/employeescontroller_moveemployeetoteam","openApiOperationId":"EmployeesController_moveEmployeeToTeam","summary":"Move employee to a different team"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/MoveEmployeeToTeamV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/MoveEmployeeToTeamV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee successfully moved to team"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Not Found - Employee or team not found"}],"pointer":"/paths/~1employees~1move-to-team/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_moveemployeetoteam"}],"panels":[]}]},"httpPath":"/employees/move-to-team"},{"label":"Add employee as team reviewer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_makeemployeeteamreviewer","routeSlug":"/v2/openapi/employees/employeescontroller_makeemployeeteamreviewer","metadata":{"seo":{"title":"Add employee as team reviewer","description":"Add employee as team reviewer"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_makeEmployeeTeamReviewer","name":"Add employee as team reviewer","isWebhook":false,"pointer":"/paths/~1employees~1make-employee-team-reviewer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add employee as team reviewer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1make-employee-team-reviewer/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"schemaId":"components/schemas/ReviewerManagementV1Dto","pointer":"/paths/~1employees~1make-employee-team-reviewer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/make-employee-team-reviewer","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/employees/make-employee-team-reviewer","href":"employees/employeescontroller_makeemployeeteamreviewer","openApiOperationId":"EmployeesController_makeEmployeeTeamReviewer","summary":"Add employee as team reviewer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ReviewerManagementV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReviewerManagementV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee successfully added as team reviewer"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Not Found - Employee or team not found"}],"pointer":"/paths/~1employees~1make-employee-team-reviewer/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_makeemployeeteamreviewer"}],"panels":[]}]},"httpPath":"/employees/make-employee-team-reviewer"},{"label":"Update employee profile","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_updateemployeeprofile","routeSlug":"/v2/openapi/employees/employeescontroller_updateemployeeprofile","metadata":{"seo":{"title":"Update employee profile","description":"Update employee profile"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_updateEmployeeProfile","name":"Update employee profile","isWebhook":false,"pointer":"/paths/~1employees~1update-profile/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update employee profile","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1update-profile/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateProfileV1Dto"}},"schemaId":"components/schemas/UpdateProfileV1Dto","pointer":"/paths/~1employees~1update-profile/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/update-profile","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateProfileV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/employees/update-profile","href":"employees/employeescontroller_updateemployeeprofile","openApiOperationId":"EmployeesController_updateEmployeeProfile","summary":"Update employee profile"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateProfileV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateProfileV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee profile updated successfully"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Not Found - Employee not found"}],"pointer":"/paths/~1employees~1update-profile/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_updateemployeeprofile"}],"panels":[]}]},"httpPath":"/employees/update-profile"},{"label":"Activate an employee","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_activateemployee","routeSlug":"/v2/openapi/employees/employeescontroller_activateemployee","metadata":{"seo":{"title":"Activate an employee","description":"Activate an employee"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_activateEmployee","name":"Activate an employee","isWebhook":false,"pointer":"/paths/~1employees~1activate-employee/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Activate an employee","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1activate-employee/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ActivateEmployeeV1Dto"}},"schemaId":"components/schemas/ActivateEmployeeV1Dto","pointer":"/paths/~1employees~1activate-employee/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/employees/activate-employee","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ActivateEmployeeV1Dto"}},"responseCodes":["200"],"pointer":"/employees/activate-employee","href":"employees/employeescontroller_activateemployee","openApiOperationId":"EmployeesController_activateEmployee","summary":"Activate an employee"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ActivateEmployeeV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ActivateEmployeeV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee activated successfully"}],"pointer":"/paths/~1employees~1activate-employee/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_activateemployee"}],"panels":[]}]},"httpPath":"/employees/activate-employee"},{"label":"Suspend an employee","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_suspendemployee","routeSlug":"/v2/openapi/employees/employeescontroller_suspendemployee","metadata":{"seo":{"title":"Suspend an employee","description":"Suspend an employee"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_suspendEmployee","name":"Suspend an employee","isWebhook":false,"pointer":"/paths/~1employees~1{_id}~1suspend-employee/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suspend an employee","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1employees~1{_id}~1suspend-employee/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1{_id}~1suspend-employee/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/employees/{_id}/suspend-employee","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"responseCodes":["200"],"pointer":"/employees/{_id}/suspend-employee","href":"employees/employeescontroller_suspendemployee","openApiOperationId":"EmployeesController_suspendEmployee","summary":"Suspend an employee"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee suspended successfully"}],"pointer":"/paths/~1employees~1{_id}~1suspend-employee/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_suspendemployee"}],"panels":[]}]},"httpPath":"/employees/{_id}/suspend-employee"},{"label":"Transfer employee ownership to a new person","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_transferownership","routeSlug":"/v2/openapi/employees/employeescontroller_transferownership","metadata":{"seo":{"title":"Transfer employee ownership to a new person","description":"Suspends (or deletes) the existing employee account and provisions a new employee in its place, inheriting the same team and supervisor. Requires the caller to have PEOPLE_EDIT permission."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_transferOwnership","name":"Transfer employee ownership to a new person","isWebhook":false,"pointer":"/paths/~1employees~1transfer-ownership/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Transfer employee ownership to a new person","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Suspends (or deletes) the existing employee account and provisions a new employee in its place, inheriting the same team and supervisor. Requires the caller to have PEOPLE_EDIT permission."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1transfer-ownership/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransferOwnershipV1Dto"}},"schemaId":"components/schemas/TransferOwnershipV1Dto","pointer":"/paths/~1employees~1transfer-ownership/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/transfer-ownership","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TransferOwnershipV1Dto"}},"responseCodes":["200","400","401","404"],"pointer":"/employees/transfer-ownership","href":"employees/employeescontroller_transferownership","openApiOperationId":"EmployeesController_transferOwnership","summary":"Transfer employee ownership to a new person"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/TransferOwnershipV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransferOwnershipV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Ownership transferred successfully. Returns the new employee ID and the old employee's updated status.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransferOwnershipResponseV1Dto"}},"schemaId":"components/schemas/TransferOwnershipResponseV1Dto"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request – missing required fields (employee_id/external_id, name, email, phone), or the provided email/phone is already in use by an active user."},"children":[]}]}]}]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – the authenticated user does not have PEOPLE_EDIT permission."},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found – no employee record matches the provided employee_id or external_id."},"children":[]}]}]}]}],"pointer":"/paths/~1employees~1transfer-ownership/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransferOwnershipResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransferOwnershipResponseV1Dto"}}},{"code":"400"},{"code":"401"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_transferownership"}],"panels":[]}]},"httpPath":"/employees/transfer-ownership"},{"label":"Allocate funds to employee wallet","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_allocatefunds","routeSlug":"/v2/openapi/employees/employeescontroller_allocatefunds","metadata":{"seo":{"title":"Allocate funds to employee wallet","description":"Allocate funds to employee wallet"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_allocateFunds","name":"Allocate funds to employee wallet","isWebhook":false,"pointer":"/paths/~1employees~1allocate-funds/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Allocate funds to employee wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1allocate-funds/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AllocateFundsV1Dto"}},"schemaId":"components/schemas/AllocateFundsV1Dto","pointer":"/paths/~1employees~1allocate-funds/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/allocate-funds","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AllocateFundsV1Dto"}},"responseCodes":["200","400","401","404"],"pointer":"/employees/allocate-funds","href":"employees/employeescontroller_allocatefunds","openApiOperationId":"EmployeesController_allocateFunds","summary":"Allocate funds to employee wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AllocateFundsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AllocateFundsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Funds allocated successfully"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"401","description":"Unauthorized"},{"code":"404","description":"Not Found - Employee not found"}],"pointer":"/paths/~1employees~1allocate-funds/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_allocatefunds"}],"panels":[]}]},"httpPath":"/employees/allocate-funds"},{"label":"Remove funds from employee wallet","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/employees/employeescontroller_removefunds","routeSlug":"/v2/openapi/employees/employeescontroller_removefunds","metadata":{"seo":{"title":"Remove funds from employee wallet","description":"Remove funds from employee wallet"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"EmployeesController_removeFunds","name":"Remove funds from employee wallet","isWebhook":false,"pointer":"/paths/~1employees~1remove-funds/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove funds from employee wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["employees:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1employees~1remove-funds/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeductFundsV1Dto"}},"schemaId":"components/schemas/DeductFundsV1Dto","pointer":"/paths/~1employees~1remove-funds/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/employees/remove-funds","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["employees:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/DeductFundsV1Dto"}},"responseCodes":["200","400","401","404"],"pointer":"/employees/remove-funds","href":"employees/employeescontroller_removefunds","openApiOperationId":"EmployeesController_removeFunds","summary":"Remove funds from employee wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/DeductFundsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeductFundsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Funds removed successfully"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"401","description":"Unauthorized"},{"code":"404","description":"Not Found - Employee not found"}],"pointer":"/paths/~1employees~1remove-funds/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/employees/employeescontroller_removefunds"}],"panels":[]}]},"httpPath":"/employees/remove-funds"}],"content":{"contentType":"group","meta":{"name":"employees"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"employees","showPageActions":true},{"nodeType":"markdoc","content":"Team members and their wallets."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/employees","summary":"List employees","prefix":{"name":"get","color":"get"},"badges":[],"link":"/employees/employeescontroller_listemployees","deprecated":false},{"title":"/employees","summary":"Create new employee","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_createemployee","deprecated":false},{"title":"/employees/balances","summary":"Get employee wallet balances","prefix":{"name":"get","color":"get"},"badges":[],"link":"/employees/employeescontroller_getemployeebalances","deprecated":false},{"title":"/employees/view-statement","summary":"View employee transaction statement","prefix":{"name":"get","color":"get"},"badges":[],"link":"/employees/employeescontroller_viewstatement","deprecated":false},{"title":"/employees/{employee_id}","summary":"Get employee by employee_id","prefix":{"name":"get","color":"get"},"badges":[],"link":"/employees/employeescontroller_getemployee","deprecated":false},{"title":"/employees/{employee_id}","summary":"Delete employee","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/employees/employeescontroller_deleteemployee","deprecated":false},{"title":"/employees/remove-employee-team-reviewer","summary":"Remove employee from team reviewers","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/employees/employeescontroller_removeemployeeteamreviewer","deprecated":false},{"title":"/employees/move-to-team","summary":"Move employee to a different team","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_moveemployeetoteam","deprecated":false},{"title":"/employees/make-employee-team-reviewer","summary":"Add employee as team reviewer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_makeemployeeteamreviewer","deprecated":false},{"title":"/employees/update-profile","summary":"Update employee profile","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_updateemployeeprofile","deprecated":false},{"title":"/employees/activate-employee","summary":"Activate an employee","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/employees/employeescontroller_activateemployee","deprecated":false},{"title":"/employees/{_id}/suspend-employee","summary":"Suspend an employee","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/employees/employeescontroller_suspendemployee","deprecated":false},{"title":"/employees/transfer-ownership","summary":"Transfer employee ownership to a new person","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_transferownership","deprecated":false},{"title":"/employees/allocate-funds","summary":"Allocate funds to employee wallet","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_allocatefunds","deprecated":false},{"title":"/employees/remove-funds","summary":"Remove funds from employee wallet","prefix":{"name":"post","color":"post"},"badges":[],"link":"/employees/employeescontroller_removefunds","deprecated":false}]}]}]}]}},{"type":"group","label":"teams","link":"/v2/openapi/teams","routeSlug":"/v2/openapi/teams","items":[{"label":"List teams","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/teams/teamscontroller_listteams","routeSlug":"/v2/openapi/teams/teamscontroller_listteams","metadata":{"seo":{"title":"List teams","description":"List teams"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TeamsController_listTeams","name":"List teams","isWebhook":false,"pointer":"/paths/~1teams/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List teams","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["teams:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number (minimum: 1)"},{"name":"limit","in":"query","schemaId":"schema_125","description":"Number of items per page (minimum: 1, maximum: 1000)"}],"pointer":"/paths/~1teams/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1teams/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/teams","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":20,"schemaId":"schema_125"}],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["teams:read"]}],"responseCodes":["200","400"],"pointer":"/teams","href":"teams/teamscontroller_listteams","openApiOperationId":"TeamsController_listTeams","summary":"List teams"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of teams","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTeamResponseDto"}},"schemaId":"components/schemas/PaginatedTeamResponseDto"},{"code":"400","description":"Bad Request - Invalid page or limit parameters"}],"pointer":"/paths/~1teams/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedTeamResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedTeamResponseDto"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/teams/teamscontroller_listteams"}],"panels":[]}]},"httpPath":"/teams"},{"label":"Create new team","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/teams/teamscontroller_createteam","routeSlug":"/v2/openapi/teams/teamscontroller_createteam","metadata":{"seo":{"title":"Create new team","description":"Create new team"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TeamsController_createTeam","name":"Create new team","isWebhook":false,"pointer":"/paths/~1teams/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create new team","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["teams:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1teams/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTeamV1Dto"}},"schemaId":"components/schemas/CreateTeamV1Dto","pointer":"/paths/~1teams/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/teams","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["teams:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateTeamV1Dto"}},"responseCodes":["201"],"pointer":"/teams","href":"teams/teamscontroller_createteam","openApiOperationId":"TeamsController_createTeam","summary":"Create new team"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateTeamV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateTeamV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Team created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}},"schemaId":"components/schemas/TeamV1Dto"}],"pointer":"/paths/~1teams/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/TeamV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/teams/teamscontroller_createteam"}],"panels":[]}]},"httpPath":"/teams"},{"label":"Get team by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/teams/teamscontroller_getteam","routeSlug":"/v2/openapi/teams/teamscontroller_getteam","metadata":{"seo":{"title":"Get team by ID","description":"Get team by ID"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TeamsController_getTeam","name":"Get team by ID","isWebhook":false,"pointer":"/paths/~1teams~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get team by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["teams:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1teams~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1teams~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/teams/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["teams:read"]}],"responseCodes":["200"],"pointer":"/teams/{id}","href":"teams/teamscontroller_getteam","openApiOperationId":"TeamsController_getTeam","summary":"Get team by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Team details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}},"schemaId":"components/schemas/TeamV1Dto"}],"pointer":"/paths/~1teams~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TeamV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/teams/teamscontroller_getteam"}],"panels":[]}]},"httpPath":"/teams/{id}"},{"label":"Update team","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/teams/teamscontroller_updateteam","routeSlug":"/v2/openapi/teams/teamscontroller_updateteam","metadata":{"seo":{"title":"Update team","description":"Update team"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TeamsController_updateTeam","name":"Update team","isWebhook":false,"pointer":"/paths/~1teams~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update team","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["teams:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1teams~1{id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1teams~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTeamV1Dto"}},"schemaId":"components/schemas/UpdateTeamV1Dto","pointer":"/paths/~1teams~1{id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/teams/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["teams:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateTeamV1Dto"}},"responseCodes":["200"],"pointer":"/teams/{id}","href":"teams/teamscontroller_updateteam","openApiOperationId":"TeamsController_updateTeam","summary":"Update team"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateTeamV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTeamV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Team updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}},"schemaId":"components/schemas/TeamV1Dto"}],"pointer":"/paths/~1teams~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TeamV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TeamV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/teams/teamscontroller_updateteam"}],"panels":[]}]},"httpPath":"/teams/{id}"},{"label":"Delete team","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/teams/teamscontroller_deleteteam","routeSlug":"/v2/openapi/teams/teamscontroller_deleteteam","metadata":{"seo":{"title":"Delete team","description":"Delete team"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TeamsController_deleteTeam","name":"Delete team","isWebhook":false,"pointer":"/paths/~1teams~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete team","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["teams:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1teams~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"org_wallet_ref","in":"header","schemaId":"schema_110","description":"Organization wallet reference, defaults to \"1\" if not provided"},{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1teams~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/teams/{id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["teams:write"]}],"responseCodes":["200"],"pointer":"/teams/{id}","href":"teams/teamscontroller_deleteteam","openApiOperationId":"TeamsController_deleteTeam","summary":"Delete team"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Team deleted successfully"}],"pointer":"/paths/~1teams~1{id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/teams/teamscontroller_deleteteam"}],"panels":[]}]},"httpPath":"/teams/{id}"}],"content":{"contentType":"group","meta":{"name":"teams"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"teams","showPageActions":true},{"nodeType":"markdoc","content":"Organisational teams and their members."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/teams","summary":"List teams","prefix":{"name":"get","color":"get"},"badges":[],"link":"/teams/teamscontroller_listteams","deprecated":false},{"title":"/teams","summary":"Create new team","prefix":{"name":"post","color":"post"},"badges":[],"link":"/teams/teamscontroller_createteam","deprecated":false},{"title":"/teams/{id}","summary":"Get team by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/teams/teamscontroller_getteam","deprecated":false},{"title":"/teams/{id}","summary":"Update team","prefix":{"name":"put","color":"put"},"badges":[],"link":"/teams/teamscontroller_updateteam","deprecated":false},{"title":"/teams/{id}","summary":"Delete team","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/teams/teamscontroller_deleteteam","deprecated":false}]}]}]}]}},{"type":"separator","label":"Treasury","content":null},{"type":"group","label":"Investments · Portfolio & accounts","link":"/v2/openapi/investments","routeSlug":"/v2/openapi/investments","items":[{"label":"List fund catalogue","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_listfunds","routeSlug":"/v2/openapi/investments/investmentscontroller_listfunds","metadata":{"seo":{"title":"List fund catalogue","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_listFunds","name":"List fund catalogue","isWebhook":false,"pointer":"/paths/~1investments~1funds/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List fund catalogue","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns available funds with yield, minimum, currency, asset manager."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1funds/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/funds","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/funds","href":"investments/investmentscontroller_listfunds","openApiOperationId":"InvestmentsController_listFunds","summary":"List fund catalogue"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FundsCatalogueResponseDto"}},"schemaId":"components/schemas/FundsCatalogueResponseDto"}],"pointer":"/paths/~1investments~1funds/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FundsCatalogueResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FundsCatalogueResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_listfunds"}],"panels":[]}]},"httpPath":"/investments/funds"},{"label":"List business's investment accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_listaccounts","routeSlug":"/v2/openapi/investments/investmentscontroller_listaccounts","metadata":{"seo":{"title":"List business's investment accounts","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_listAccounts","name":"List business's investment accounts","isWebhook":false,"pointer":"/paths/~1investments~1accounts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List business's investment accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List business's investment accounts"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"refresh","in":"query","schemaId":"schema_110","required":true},{"name":"management","in":"query","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"refresh","in":"query","required":true,"schemaId":"schema_110"},{"name":"management","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/accounts","href":"investments/investmentscontroller_listaccounts","openApiOperationId":"InvestmentsController_listAccounts","summary":"List business's investment accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListInvestmentAccountsResponseDto"}},"schemaId":"components/schemas/ListInvestmentAccountsResponseDto"}],"pointer":"/paths/~1investments~1accounts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListInvestmentAccountsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListInvestmentAccountsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_listaccounts"}],"panels":[]}]},"httpPath":"/investments/accounts"},{"label":"Single fund account detail (header + KPIs + cash allocation)","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getaccount","routeSlug":"/v2/openapi/investments/investmentscontroller_getaccount","metadata":{"seo":{"title":"Single fund account detail (header + KPIs + cash allocation)","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getAccount","name":"Single fund account detail (header + KPIs + cash allocation)","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Single fund account detail (header + KPIs + cash allocation)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single fund account detail (header + KPIs + cash allocation)"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"refresh","in":"query","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"refresh","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200","404"],"pointer":"/investments/accounts/{fundAccountId}","href":"investments/investmentscontroller_getaccount","openApiOperationId":"InvestmentsController_getAccount","summary":"Single fund account detail (header + KPIs + cash allocation)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FundAccountDetailDto"}},"schemaId":"components/schemas/FundAccountDetailDto"},{"code":"404","description":"Fund account not found for this business"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FundAccountDetailDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FundAccountDetailDto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getaccount"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}"},{"label":"Interest credited series for the account","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getinterestseries","routeSlug":"/v2/openapi/investments/investmentscontroller_getinterestseries","metadata":{"seo":{"title":"Interest credited series for the account","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getInterestSeries","name":"Interest credited series for the account","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1interest-series/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Interest credited series for the account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Interest credited series for the account"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1interest-series/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"range","in":"query","schemaId":"schema_155"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1interest-series/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1interest-series/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}/interest-series","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"range","in":"query","required":false,"schemaId":"schema_155"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/accounts/{fundAccountId}/interest-series","href":"investments/investmentscontroller_getinterestseries","openApiOperationId":"InvestmentsController_getInterestSeries","summary":"Interest credited series for the account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InterestSeriesResponseDto"}},"schemaId":"components/schemas/InterestSeriesResponseDto"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1interest-series/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InterestSeriesResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InterestSeriesResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getinterestseries"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/interest-series"},{"label":"Projected interest at EOM / 3M / 6M / 12M horizons","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getprojections","routeSlug":"/v2/openapi/investments/investmentscontroller_getprojections","metadata":{"seo":{"title":"Projected interest at EOM / 3M / 6M / 12M horizons","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getProjections","name":"Projected interest at EOM / 3M / 6M / 12M horizons","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1projections/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Projected interest at EOM / 3M / 6M / 12M horizons","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Projected interest at EOM / 3M / 6M / 12M horizons"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1projections/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"yield","in":"query","schemaId":"schema_156","description":"Override annualised yield (percent). Defaults to fund effective yield."}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1projections/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1projections/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}/projections","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"yield","in":"query","required":false,"example":9,"schemaId":"schema_156"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/accounts/{fundAccountId}/projections","href":"investments/investmentscontroller_getprojections","openApiOperationId":"InvestmentsController_getProjections","summary":"Projected interest at EOM / 3M / 6M / 12M horizons"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProjectionsResponseDto"}},"schemaId":"components/schemas/ProjectionsResponseDto"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1projections/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ProjectionsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProjectionsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getprojections"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/projections"},{"label":"Transaction history with type filter + pagination","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_gettransactions","routeSlug":"/v2/openapi/investments/investmentscontroller_gettransactions","metadata":{"seo":{"title":"Transaction history with type filter + pagination","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getTransactions","name":"Transaction history with type filter + pagination","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Transaction history with type filter + pagination","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Transaction history with type filter + pagination"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"type","in":"query","schemaId":"schema_157"},{"name":"page","in":"query","schemaId":"schema_158"},{"name":"page_size","in":"query","schemaId":"schema_159"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}/transactions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"type","in":"query","required":false,"schemaId":"schema_157"},{"name":"page","in":"query","required":false,"schemaId":"schema_158"},{"name":"page_size","in":"query","required":false,"schemaId":"schema_159"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/accounts/{fundAccountId}/transactions","href":"investments/investmentscontroller_gettransactions","openApiOperationId":"InvestmentsController_getTransactions","summary":"Transaction history with type filter + pagination"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentTransactionsResponseDto"}},"schemaId":"components/schemas/InvestmentTransactionsResponseDto"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InvestmentTransactionsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentTransactionsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_gettransactions"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/transactions"},{"label":"Aggregate portfolio across all fund accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getportfolio","routeSlug":"/v2/openapi/investments/investmentscontroller_getportfolio","metadata":{"seo":{"title":"Aggregate portfolio across all fund accounts","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getPortfolio","name":"Aggregate portfolio across all fund accounts","isWebhook":false,"pointer":"/paths/~1investments~1portfolio/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Aggregate portfolio across all fund accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Aggregate portfolio across all fund accounts"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"refresh","in":"query","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1portfolio/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1portfolio/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/portfolio","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"refresh","in":"query","required":true,"schemaId":"schema_110"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/portfolio","href":"investments/investmentscontroller_getportfolio","openApiOperationId":"InvestmentsController_getPortfolio","summary":"Aggregate portfolio across all fund accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioResponseDto"}},"schemaId":"components/schemas/PortfolioResponseDto"}],"pointer":"/paths/~1investments~1portfolio/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PortfolioResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getportfolio"}],"panels":[]}]},"httpPath":"/investments/portfolio"},{"label":"Portfolio performance grouped by currency","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getportfolioperformance","routeSlug":"/v2/openapi/investments/investmentscontroller_getportfolioperformance","metadata":{"seo":{"title":"Portfolio performance grouped by currency","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getPortfolioPerformance","name":"Portfolio performance grouped by currency","isWebhook":false,"pointer":"/paths/~1investments~1portfolio~1performance-by-currency/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Portfolio performance grouped by currency","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portfolio performance grouped by currency"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"range","in":"query","schemaId":"schema_160"}],"pointer":"/paths/~1investments~1portfolio~1performance-by-currency/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1portfolio~1performance-by-currency/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/portfolio/performance-by-currency","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"range","in":"query","required":false,"schemaId":"schema_160"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/portfolio/performance-by-currency","href":"investments/investmentscontroller_getportfolioperformance","openApiOperationId":"InvestmentsController_getPortfolioPerformance","summary":"Portfolio performance grouped by currency"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioPerformanceResponseDto"}},"schemaId":"components/schemas/PortfolioPerformanceResponseDto"}],"pointer":"/paths/~1investments~1portfolio~1performance-by-currency/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PortfolioPerformanceResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioPerformanceResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getportfolioperformance"}],"panels":[]}]},"httpPath":"/investments/portfolio/performance-by-currency"},{"label":"Unified activity feed across fund accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments/investmentscontroller_getportfolioactivity","routeSlug":"/v2/openapi/investments/investmentscontroller_getportfolioactivity","metadata":{"seo":{"title":"Unified activity feed across fund accounts","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getPortfolioActivity","name":"Unified activity feed across fund accounts","isWebhook":false,"pointer":"/paths/~1investments~1portfolio~1activity/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Unified activity feed across fund accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unified activity feed across fund accounts"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"range","in":"query","schemaId":"schema_161"},{"name":"type","in":"query","schemaId":"schema_162"}],"pointer":"/paths/~1investments~1portfolio~1activity/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1portfolio~1activity/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/portfolio/activity","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"range","in":"query","required":false,"schemaId":"schema_161"},{"name":"type","in":"query","required":false,"schemaId":"schema_162"}],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/portfolio/activity","href":"investments/investmentscontroller_getportfolioactivity","openApiOperationId":"InvestmentsController_getPortfolioActivity","summary":"Unified activity feed across fund accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioActivityResponseDto"}},"schemaId":"components/schemas/PortfolioActivityResponseDto"}],"pointer":"/paths/~1investments~1portfolio~1activity/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PortfolioActivityResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortfolioActivityResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments/investmentscontroller_getportfolioactivity"}],"panels":[]}]},"httpPath":"/investments/portfolio/activity"}],"content":{"contentType":"group","meta":{"name":"investments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Investments · Portfolio & accounts","showPageActions":true},{"nodeType":"markdoc","content":"Fund catalogue, accounts, and portfolio analytics."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/investments/funds","summary":"List fund catalogue","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_listfunds","deprecated":false},{"title":"/investments/accounts","summary":"List business's investment accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_listaccounts","deprecated":false},{"title":"/investments/accounts/{fundAccountId}","summary":"Single fund account detail (header + KPIs + cash allocation)","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getaccount","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/interest-series","summary":"Interest credited series for the account","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getinterestseries","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/projections","summary":"Projected interest at EOM / 3M / 6M / 12M horizons","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getprojections","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/transactions","summary":"Transaction history with type filter + pagination","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_gettransactions","deprecated":false},{"title":"/investments/portfolio","summary":"Aggregate portfolio across all fund accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getportfolio","deprecated":false},{"title":"/investments/portfolio/performance-by-currency","summary":"Portfolio performance grouped by currency","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getportfolioperformance","deprecated":false},{"title":"/investments/portfolio/activity","summary":"Unified activity feed across fund accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments/investmentscontroller_getportfolioactivity","deprecated":false}]}]}]}]}},{"type":"group","label":"Investments · Fund movements","link":"/v2/openapi/investments-movements","routeSlug":"/v2/openapi/investments-movements","items":[{"label":"Opt in to a fund","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_optin","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_optin","metadata":{"seo":{"title":"Opt in to a fund","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_optIn","name":"Opt in to a fund","isWebhook":false,"pointer":"/paths/~1investments~1opt-in/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Opt in to a fund","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Opt in to a fund"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1opt-in/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/OptInRequestDto"}},"schemaId":"components/schemas/OptInRequestDto","pointer":"/paths/~1investments~1opt-in/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investments/opt-in","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/OptInRequestDto"}},"responseCodes":["200","400","409"],"pointer":"/investments/opt-in","href":"investments-movements/investmentscontroller_optin","openApiOperationId":"InvestmentsController_optIn","summary":"Opt in to a fund"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/OptInRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/OptInRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInResponseDto"}},"schemaId":"components/schemas/OptInResponseDto"},{"code":"400","description":"Missing or malformed Idempotency-Key header"},{"code":"409","description":"Concurrent request with the same Idempotency-Key"}],"pointer":"/paths/~1investments~1opt-in/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/OptInResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInResponseDto"}}},{"code":"400"},{"code":"409"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_optin"}],"panels":[]}]},"httpPath":"/investments/opt-in"},{"label":"Fetch pending MMF opt-in approval request","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_getoptinapproval","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_getoptinapproval","metadata":{"seo":{"title":"Fetch pending MMF opt-in approval request","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getOptInApproval","name":"Fetch pending MMF opt-in approval request","isWebhook":false,"pointer":"/paths/~1investments~1opt-in~1{ref}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch pending MMF opt-in approval request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fetch pending MMF opt-in approval request"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"ref","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1opt-in~1{ref}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1opt-in~1{ref}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/opt-in/{ref}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"ref","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/opt-in/{ref}","href":"investments-movements/investmentscontroller_getoptinapproval","openApiOperationId":"InvestmentsController_getOptInApproval","summary":"Fetch pending MMF opt-in approval request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInApprovalResponseDto"}},"schemaId":"components/schemas/OptInApprovalResponseDto"}],"pointer":"/paths/~1investments~1opt-in~1{ref}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/OptInApprovalResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInApprovalResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_getoptinapproval"}],"panels":[]}]},"httpPath":"/investments/opt-in/{ref}"},{"label":"Approve pending MMF opt-in request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_approveoptin","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_approveoptin","metadata":{"seo":{"title":"Approve pending MMF opt-in request","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_approveOptIn","name":"Approve pending MMF opt-in request","isWebhook":false,"pointer":"/paths/~1investments~1opt-in~1{ref}~1approve/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Approve pending MMF opt-in request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approve pending MMF opt-in request"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"ref","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1opt-in~1{ref}~1approve/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1opt-in~1{ref}~1approve/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investments/opt-in/{ref}/approve","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"ref","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"responseCodes":["200"],"pointer":"/investments/opt-in/{ref}/approve","href":"investments-movements/investmentscontroller_approveoptin","openApiOperationId":"InvestmentsController_approveOptIn","summary":"Approve pending MMF opt-in request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInApprovalResponseDto"}},"schemaId":"components/schemas/OptInApprovalResponseDto"}],"pointer":"/paths/~1investments~1opt-in~1{ref}~1approve/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/OptInApprovalResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OptInApprovalResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_approveoptin"}],"panels":[]}]},"httpPath":"/investments/opt-in/{ref}/approve"},{"label":"Top up an existing fund account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_invest","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_invest","metadata":{"seo":{"title":"Top up an existing fund account","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_invest","name":"Top up an existing fund account","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1invest/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Top up an existing fund account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Top up an existing fund account"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1invest/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1invest/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InvestRequestDto"}},"schemaId":"components/schemas/InvestRequestDto","pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1invest/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investments/accounts/{fundAccountId}/invest","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/InvestRequestDto"}},"responseCodes":["200","400","409"],"pointer":"/investments/accounts/{fundAccountId}/invest","href":"investments-movements/investmentscontroller_invest","openApiOperationId":"InvestmentsController_invest","summary":"Top up an existing fund account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/InvestRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InvestRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestResponseDto"}},"schemaId":"components/schemas/InvestResponseDto"},{"code":"400","description":"Missing or malformed Idempotency-Key header"},{"code":"409","description":"Concurrent request with the same Idempotency-Key"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1invest/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InvestResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestResponseDto"}}},{"code":"400"},{"code":"409"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_invest"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/invest"},{"label":"Top up an MMF investment wallet from a business wallet","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_topup","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_topup","metadata":{"seo":{"title":"Top up an MMF investment wallet from a business wallet","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_topUp","name":"Top up an MMF investment wallet from a business wallet","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1top-up/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Top up an MMF investment wallet from a business wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Top up an MMF investment wallet from a business wallet"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1top-up/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1top-up/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TopUpRequestDto"}},"schemaId":"components/schemas/TopUpRequestDto","pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1top-up/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investments/accounts/{fundAccountId}/top-up","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TopUpRequestDto"}},"responseCodes":["201"],"pointer":"/investments/accounts/{fundAccountId}/top-up","href":"investments-movements/investmentscontroller_topup","openApiOperationId":"InvestmentsController_topUp","summary":"Top up an MMF investment wallet from a business wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/TopUpRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TopUpRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1top-up/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_topup"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/top-up"},{"label":"Withdraw from a fund account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-movements/investmentscontroller_withdraw","routeSlug":"/v2/openapi/investments-movements/investmentscontroller_withdraw","metadata":{"seo":{"title":"Withdraw from a fund account","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_withdraw","name":"Withdraw from a fund account","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1withdraw/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Withdraw from a fund account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Withdraw from a fund account"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1withdraw/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1withdraw/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WithdrawRequestDto"}},"schemaId":"components/schemas/WithdrawRequestDto","pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1withdraw/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investments/accounts/{fundAccountId}/withdraw","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/WithdrawRequestDto"}},"responseCodes":["200","400","409"],"pointer":"/investments/accounts/{fundAccountId}/withdraw","href":"investments-movements/investmentscontroller_withdraw","openApiOperationId":"InvestmentsController_withdraw","summary":"Withdraw from a fund account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/WithdrawRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WithdrawRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WithdrawResponseDto"}},"schemaId":"components/schemas/WithdrawResponseDto"},{"code":"400","description":"Missing or malformed Idempotency-Key header"},{"code":"409","description":"Concurrent request with the same Idempotency-Key"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1withdraw/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WithdrawResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WithdrawResponseDto"}}},{"code":"400"},{"code":"409"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-movements/investmentscontroller_withdraw"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/withdraw"}],"content":{"contentType":"group","meta":{"name":"investments-movements"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Investments · Fund movements","showPageActions":true},{"nodeType":"markdoc","content":"Opt-in, invest, top-up, and withdraw."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/investments/opt-in","summary":"Opt in to a fund","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investments-movements/investmentscontroller_optin","deprecated":false},{"title":"/investments/opt-in/{ref}","summary":"Fetch pending MMF opt-in approval request","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments-movements/investmentscontroller_getoptinapproval","deprecated":false},{"title":"/investments/opt-in/{ref}/approve","summary":"Approve pending MMF opt-in request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investments-movements/investmentscontroller_approveoptin","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/invest","summary":"Top up an existing fund account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investments-movements/investmentscontroller_invest","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/top-up","summary":"Top up an MMF investment wallet from a business wallet","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investments-movements/investmentscontroller_topup","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/withdraw","summary":"Withdraw from a fund account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investments-movements/investmentscontroller_withdraw","deprecated":false}]}]}]}]}},{"type":"group","label":"Investments · Access & permissions","link":"/v2/openapi/investments-access","routeSlug":"/v2/openapi/investments-access","items":[{"label":"Treasury operators allowed to transfer funds from this account","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-access/investmentscontroller_getpermissions","routeSlug":"/v2/openapi/investments-access/investmentscontroller_getpermissions","metadata":{"seo":{"title":"Treasury operators allowed to transfer funds from this account","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getPermissions","name":"Treasury operators allowed to transfer funds from this account","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Treasury operators allowed to transfer funds from this account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Treasury operators allowed to transfer funds from this account"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}/permissions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200","404"],"pointer":"/investments/accounts/{fundAccountId}/permissions","href":"investments-access/investmentscontroller_getpermissions","openApiOperationId":"InvestmentsController_getPermissions","summary":"Treasury operators allowed to transfer funds from this account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentAccountPermissionsDto"}},"schemaId":"components/schemas/InvestmentAccountPermissionsDto"},{"code":"404","description":"Fund account not found for this business"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InvestmentAccountPermissionsDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentAccountPermissionsDto"}}},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-access/investmentscontroller_getpermissions"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/permissions"},{"label":"Replace the treasury operators for this account","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-access/investmentscontroller_updatepermissions","routeSlug":"/v2/openapi/investments-access/investmentscontroller_updatepermissions","metadata":{"seo":{"title":"Replace the treasury operators for this account","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_updatePermissions","name":"Replace the treasury operators for this account","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Replace the treasury operators for this account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replace the treasury operators for this account"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateInvestmentPermissionsRequestDto"}},"schemaId":"components/schemas/UpdateInvestmentPermissionsRequestDto","pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/investments/accounts/{fundAccountId}/permissions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateInvestmentPermissionsRequestDto"}},"responseCodes":["200","403","404"],"pointer":"/investments/accounts/{fundAccountId}/permissions","href":"investments-access/investmentscontroller_updatepermissions","openApiOperationId":"InvestmentsController_updatePermissions","summary":"Replace the treasury operators for this account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateInvestmentPermissionsRequestDto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateInvestmentPermissionsRequestDto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentAccountPermissionsDto"}},"schemaId":"components/schemas/InvestmentAccountPermissionsDto"},{"code":"403","description":"Requires APPROVER role"},{"code":"404","description":"Fund account not found for this business"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1permissions/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InvestmentAccountPermissionsDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InvestmentAccountPermissionsDto"}}},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-access/investmentscontroller_updatepermissions"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/permissions"},{"label":"Current employee's effective MMF access","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/investments-access/investmentscontroller_getcurrentaccess","routeSlug":"/v2/openapi/investments-access/investmentscontroller_getcurrentaccess","metadata":{"seo":{"title":"Current employee's effective MMF access","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InvestmentsController_getCurrentAccess","name":"Current employee's effective MMF access","isWebhook":false,"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1access/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Current employee's effective MMF access","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current employee's effective MMF access"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["investments:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"fundAccountId","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1access/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Idempotency-Key","in":"header","schemaId":"schema_110","description":"Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h."},{"name":"org_wallet_ref","in":"header","schemaId":"schema_110"},{"name":"business_id","in":"header","schemaId":"schema_110","required":true}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1access/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/investments/accounts/{fundAccountId}/access","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"fundAccountId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"Idempotency-Key","in":"header","required":false,"schemaId":"schema_110"},{"name":"org_wallet_ref","in":"header","required":false,"schemaId":"schema_110"},{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["investments:read"]}],"responseCodes":["200"],"pointer":"/investments/accounts/{fundAccountId}/access","href":"investments-access/investmentscontroller_getcurrentaccess","openApiOperationId":"InvestmentsController_getCurrentAccess","summary":"Current employee's effective MMF access"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200"}],"pointer":"/paths/~1investments~1accounts~1{fundAccountId}~1access/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investments-access/investmentscontroller_getcurrentaccess"}],"panels":[]}]},"httpPath":"/investments/accounts/{fundAccountId}/access"}],"content":{"contentType":"group","meta":{"name":"investments-access"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Investments · Access & permissions","showPageActions":true},{"nodeType":"markdoc","content":"Treasury operator access and permissions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/investments/accounts/{fundAccountId}/permissions","summary":"Treasury operators allowed to transfer funds from this account","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments-access/investmentscontroller_getpermissions","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/permissions","summary":"Replace the treasury operators for this account","prefix":{"name":"put","color":"put"},"badges":[],"link":"/investments-access/investmentscontroller_updatepermissions","deprecated":false},{"title":"/investments/accounts/{fundAccountId}/access","summary":"Current employee's effective MMF access","prefix":{"name":"get","color":"get"},"badges":[],"link":"/investments-access/investmentscontroller_getcurrentaccess","deprecated":false}]}]}]}]}},{"type":"separator","label":"Governance","content":null},{"type":"group","label":"business-policies","link":"/v2/openapi/business-policies","routeSlug":"/v2/openapi/business-policies","items":[{"label":"List all business policy groups","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_listpolicygroups","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_listpolicygroups","metadata":{"seo":{"title":"List all business policy groups","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_listPolicyGroups","name":"List all business policy groups","isWebhook":false,"pointer":"/paths/~1business-policies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all business policy groups","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns all policy groups configured for the authenticated business, each containing their associated policies and rules."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403"],"pointer":"/business-policies","href":"business-policies/businesspoliciescontroller_listpolicygroups","openApiOperationId":"BusinessPoliciesController_listPolicyGroups","summary":"List all business policy groups"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy groups returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163"}},"schemaId":"schema_163"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_163","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163"}}},{"code":"401"},{"code":"403"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_listpolicygroups"}],"panels":[]}]},"httpPath":"/business-policies"},{"label":"Fetch all policy groups with their policies","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicygrouppolicies","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicygrouppolicies","metadata":{"seo":{"title":"Fetch all policy groups with their policies","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getPolicyGroupPolicies","name":"Fetch all policy groups with their policies","isWebhook":false,"pointer":"/paths/~1business-policies~1policy-group-policies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch all policy groups with their policies","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns all policy groups, each with their associated policy types (CHANNELS, SUBCATEGORY, VENDORS, TIME, RECEIPTS, TAGS, etc.) including both business-specific policies and default rules."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1policy-group-policies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/policy-group-policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403"],"pointer":"/business-policies/policy-group-policies","href":"business-policies/businesspoliciescontroller_getpolicygrouppolicies","openApiOperationId":"BusinessPoliciesController_getPolicyGroupPolicies","summary":"Fetch all policy groups with their policies"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy groups with policies returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_164"}},"schemaId":"schema_164"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies~1policy-group-policies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_164","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_164"}}},{"code":"401"},{"code":"403"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getpolicygrouppolicies"}],"panels":[]}]},"httpPath":"/business-policies/policy-group-policies"},{"label":"Get business policies by policy group ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getpoliciesbygroupid","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getpoliciesbygroupid","metadata":{"seo":{"title":"Get business policies by policy group ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getPoliciesByGroupId","name":"Get business policies by policy group ID","isWebhook":false,"pointer":"/paths/~1business-policies~1{policyId}~1policies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get business policies by policy group ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the policy group and all its associated business policies, including rules, conditions, targets, and funding strategies."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_165","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Policy group ID (the _id of a policy group from GET /v1/business-policies)"},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1business-policies~1{policyId}~1policies/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1{policyId}~1policies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/{policyId}/policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"example":"66788af92805e9ffbda6dcee","schemaId":"schema_165"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403","404"],"pointer":"/business-policies/{policyId}/policies","href":"business-policies/businesspoliciescontroller_getpoliciesbygroupid","openApiOperationId":"BusinessPoliciesController_getPoliciesByGroupId","summary":"Get business policies by policy group ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policies returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyWithBusinessPoliciesV1Dto"}},"schemaId":"components/schemas/PolicyWithBusinessPoliciesV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Policy group not found"}],"pointer":"/paths/~1business-policies~1{policyId}~1policies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyWithBusinessPoliciesV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyWithBusinessPoliciesV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getpoliciesbygroupid"}],"panels":[]}]},"httpPath":"/business-policies/{policyId}/policies"},{"label":"Get a single business policy by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicybyid","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicybyid","metadata":{"seo":{"title":"Get a single business policy by ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getPolicyById","name":"Get a single business policy by ID","isWebhook":false,"pointer":"/paths/~1business-policies~1single~1{businessPolicyId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a single business policy by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a specific business policy document by its ID. Includes the associated policy type, rules, conditions, targets, and funding strategy."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessPolicyId","in":"path","schemaId":"schema_166","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique business policy document ID (the _id from a business_policies entry)"},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1business-policies~1single~1{businessPolicyId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1single~1{businessPolicyId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/single/{businessPolicyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessPolicyId","in":"path","required":true,"example":"697b6c810a21d470ffaca828","schemaId":"schema_166"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403","404"],"pointer":"/business-policies/single/{businessPolicyId}","href":"business-policies/businesspoliciescontroller_getpolicybyid","openApiOperationId":"BusinessPoliciesController_getPolicyById","summary":"Get a single business policy by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Business policy not found"}],"pointer":"/paths/~1business-policies~1single~1{businessPolicyId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getpolicybyid"}],"panels":[]}]},"httpPath":"/business-policies/single/{businessPolicyId}"},{"label":"Get full business policy summary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getbusinesspolicysummary","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getbusinesspolicysummary","metadata":{"seo":{"title":"Get full business policy summary","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getBusinessPolicySummary","name":"Get full business policy summary","isWebhook":false,"pointer":"/paths/~1business-policies~1summary~1{businessId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get full business policy summary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the full policy summary for the given business, covering all configured policy codes. Used by the single-use card request form to determine form field requirements."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessId","in":"path","schemaId":"schema_167","description":"Business ID to fetch policy summary for","required":true}],"pointer":"/paths/~1business-policies~1summary~1{businessId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"employee_id","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The employee's internal employee_id from the B2B system"},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1business-policies~1summary~1{businessId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1summary~1{businessId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/summary/{businessId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessId","in":"path","required":true,"example":"CDCAF716DC722","schemaId":"schema_167"}],"query":[{"name":"employee_id","in":"query","required":true,"example":"abcdefghijklmnopqrstuvwxyzabcd","schemaId":"schema_168"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","400","401"],"pointer":"/business-policies/summary/{businessId}","href":"business-policies/businesspoliciescontroller_getbusinesspolicysummary","openApiOperationId":"BusinessPoliciesController_getBusinessPolicySummary","summary":"Get full business policy summary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy summary returned successfully"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"employee_id query param is required"},"children":[]}]}]}]},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1business-policies~1summary~1{businessId}/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getbusinesspolicysummary"}],"panels":[]}]},"httpPath":"/business-policies/summary/{businessId}"},{"label":"Get category or subcategory policies","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getcategorypolicies","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getcategorypolicies","metadata":{"seo":{"title":"Get category or subcategory policies","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getCategoryPolicies","name":"Get category or subcategory policies","isWebhook":false,"pointer":"/paths/~1business-policies~1category-policies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get category or subcategory policies","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns all business policies for the given type (SUBCATEGORY or CATEGORY). The policy group ID is resolved automatically — no need to pass it explicitly. When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is omitted, returns the combined CATEGORY + SUBCATEGORY policies (empty array if neither group exists — no 404 on that path)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"type","in":"query","schemaId":"schema_169","description":"Policy type to fetch. Case-insensitive. Omit to return all category and subcategory policies."}],"pointer":"/paths/~1business-policies~1category-policies/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1category-policies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/category-policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"type","in":"query","required":false,"schemaId":"schema_169"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403","404"],"pointer":"/business-policies/category-policies","href":"business-policies/businesspoliciescontroller_getcategorypolicies","openApiOperationId":"BusinessPoliciesController_getCategoryPolicies","summary":"Get category or subcategory policies"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policies returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_170"}},"schemaId":"schema_170"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Policy group not found for the given type (only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided)"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies~1category-policies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_170","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_170"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getcategorypolicies"}],"panels":[]}]},"httpPath":"/business-policies/category-policies"},{"label":"Create or update a category / subcategory policy","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_upsertcategorypolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_upsertcategorypolicy","metadata":{"seo":{"title":"Create or update a category / subcategory policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_upsertCategoryPolicy","name":"Create or update a category / subcategory policy","isWebhook":false,"pointer":"/paths/~1business-policies~1category-policies/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create or update a category / subcategory policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Upserts a business policy under the SUBCATEGORY or CATEGORY policy group."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": initializes a new policy then applies the full payload in one call."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": updates the existing policy directly."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The policy group is resolved automatically from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" query param."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"type","in":"query","schemaId":"schema_169","description":"Policy group to operate under. Case-insensitive.","required":true}],"pointer":"/paths/~1business-policies~1category-policies/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1category-policies/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpsertCategoryPolicyV1Dto"}},"schemaId":"components/schemas/UpsertCategoryPolicyV1Dto","pointer":"/paths/~1business-policies~1category-policies/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/business-policies/category-policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"type","in":"query","required":true,"schemaId":"schema_169"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpsertCategoryPolicyV1Dto"}},"responseCodes":["200","400","401","403","404"],"pointer":"/business-policies/category-policies","href":"business-policies/businesspoliciescontroller_upsertcategorypolicy","openApiOperationId":"BusinessPoliciesController_upsertCategoryPolicy","summary":"Create or update a category / subcategory policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpsertCategoryPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpsertCategoryPolicyV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy created or updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"400","description":"type query param is required"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Policy group not found for the given type"}],"pointer":"/paths/~1business-policies~1category-policies/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"400"},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_upsertcategorypolicy"}],"panels":[]}]},"httpPath":"/business-policies/category-policies"},{"label":"Update a category or subcategory policy","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_updatecategorypolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_updatecategorypolicy","metadata":{"seo":{"title":"Update a category or subcategory policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_updateCategoryPolicy","name":"Update a category or subcategory policy","isWebhook":false,"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a category or subcategory policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates an existing SUBCATEGORY or CATEGORY business policy. Pass status: \"DISABLED\" or \"INACTIVE\" to disable (INACTIVE is normalized to DISABLED)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessPolicyId","in":"path","schemaId":"schema_171","description":"Business policy document ID","required":true}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto","pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/business-policies/category-policies/{businessPolicyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessPolicyId","in":"path","required":true,"example":"6a3ebb7893bb2649e19cb8a6","schemaId":"schema_171"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"responseCodes":["200","401","403","404"],"pointer":"/business-policies/category-policies/{businessPolicyId}","href":"business-policies/businesspoliciescontroller_updatecategorypolicy","openApiOperationId":"BusinessPoliciesController_updateCategoryPolicy","summary":"Update a category or subcategory policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Business policy not found"}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_updatecategorypolicy"}],"panels":[]}]},"httpPath":"/business-policies/category-policies/{businessPolicyId}"},{"label":"Delete a category or subcategory policy","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_deletecategorypolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_deletecategorypolicy","metadata":{"seo":{"title":"Delete a category or subcategory policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_deleteCategoryPolicy","name":"Delete a category or subcategory policy","isWebhook":false,"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a category or subcategory policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marks the SUBCATEGORY or CATEGORY business policy as DELETED."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessPolicyId","in":"path","schemaId":"schema_171","description":"Business policy document ID","required":true}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/business-policies/category-policies/{businessPolicyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessPolicyId","in":"path","required":true,"example":"6a3ebb7893bb2649e19cb8a6","schemaId":"schema_171"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"responseCodes":["200","401","403","404"],"pointer":"/business-policies/category-policies/{businessPolicyId}","href":"business-policies/businesspoliciescontroller_deletecategorypolicy","openApiOperationId":"BusinessPoliciesController_deleteCategoryPolicy","summary":"Delete a category or subcategory policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy deleted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Business policy not found"}],"pointer":"/paths/~1business-policies~1category-policies~1{businessPolicyId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_deletecategorypolicy"}],"panels":[]}]},"httpPath":"/business-policies/category-policies/{businessPolicyId}"},{"label":"List policy approval workflows for the selected currency","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicyworkflows","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_getpolicyworkflows","metadata":{"seo":{"title":"List policy approval workflows for the selected currency","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_getPolicyWorkflows","name":"List policy approval workflows for the selected currency","isWebhook":false,"pointer":"/paths/~1business-policies~1workflows/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List policy approval workflows for the selected currency","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns POLICY_BASED (action_type 11) approval workflows for the business, scoped to the currency indicated by the org_wallet_ref header. Used to pick an existing approval workflow when configuring a subcategory policy."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1workflows/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/business-policies/workflows","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:read"]}],"responseCodes":["200","401","403"],"pointer":"/business-policies/workflows","href":"business-policies/businesspoliciescontroller_getpolicyworkflows","openApiOperationId":"BusinessPoliciesController_getPolicyWorkflows","summary":"List policy approval workflows for the selected currency"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Workflows returned successfully"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — required headers missing"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies~1workflows/get/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_getpolicyworkflows"}],"panels":[]}]},"httpPath":"/business-policies/workflows"},{"label":"Create a policy approval workflow for a currency","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_createpolicyworkflow","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_createpolicyworkflow","metadata":{"seo":{"title":"Create a policy approval workflow for a currency","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_createPolicyWorkflow","name":"Create a policy approval workflow for a currency","isWebhook":false,"pointer":"/paths/~1business-policies~1workflows/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a policy approval workflow for a currency","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a POLICY_BASED (action_type 11) approval workflow scoped to a currency. The wallet reference is resolved from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field when present, otherwise from the org_wallet_ref header."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1workflows/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PolicyWorkflowV1Dto"}},"schemaId":"components/schemas/PolicyWorkflowV1Dto","pointer":"/paths/~1business-policies~1workflows/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/business-policies/workflows","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PolicyWorkflowV1Dto"}},"responseCodes":["201","400","401","403"],"pointer":"/business-policies/workflows","href":"business-policies/businesspoliciescontroller_createpolicyworkflow","openApiOperationId":"BusinessPoliciesController_createPolicyWorkflow","summary":"Create a policy approval workflow for a currency"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/PolicyWorkflowV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PolicyWorkflowV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Workflow created successfully"},{"code":"400","description":"No wallet reference found for currency"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — required headers missing"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies~1workflows/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_createpolicyworkflow"}],"panels":[]}]},"httpPath":"/business-policies/workflows"},{"label":"Create a new business policy","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_createbusinesspolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_createbusinesspolicy","metadata":{"seo":{"title":"Create a new business policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_createBusinessPolicy","name":"Create a new business policy","isWebhook":false,"pointer":"/paths/~1business-policies~1create~1{policyId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new business policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Initializes a new business policy (e.g. SUBCATEGORY or CATEGORY) under the given policy group."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_172","description":"Policy group ID","required":true}],"pointer":"/paths/~1business-policies~1create~1{policyId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1create~1{policyId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBusinessPolicyV1Dto"}},"schemaId":"components/schemas/CreateBusinessPolicyV1Dto","pointer":"/paths/~1business-policies~1create~1{policyId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/business-policies/create/{policyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"example":"66788b3e2805e9ffbda6dcf7","schemaId":"schema_172"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBusinessPolicyV1Dto"}},"responseCodes":["201","401","403"],"pointer":"/business-policies/create/{policyId}","href":"business-policies/businesspoliciescontroller_createbusinesspolicy","openApiOperationId":"BusinessPoliciesController_createBusinessPolicy","summary":"Create a new business policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CreateBusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBusinessPolicyV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Business policy created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]}],"pointer":"/paths/~1business-policies~1create~1{policyId}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_createbusinesspolicy"}],"panels":[]}]},"httpPath":"/business-policies/create/{policyId}"},{"label":"Update a business policy","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_updatebusinesspolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_updatebusinesspolicy","metadata":{"seo":{"title":"Update a business policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_updateBusinessPolicy","name":"Update a business policy","isWebhook":false,"pointer":"/paths/~1business-policies~1{businessPolicyId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a business policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates rules, workflow, status, or other fields of an existing business policy. Pass status: \"DISABLED\" to disable the policy."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessPolicyId","in":"path","schemaId":"schema_171","description":"Business policy document ID","required":true}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto","pointer":"/paths/~1business-policies~1{businessPolicyId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/business-policies/{businessPolicyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessPolicyId","in":"path","required":true,"example":"6a3ebb7893bb2649e19cb8a6","schemaId":"schema_171"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"responseCodes":["200","401","403","404"],"pointer":"/business-policies/{businessPolicyId}","href":"business-policies/businesspoliciescontroller_updatebusinesspolicy","openApiOperationId":"BusinessPoliciesController_updateBusinessPolicy","summary":"Update a business policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBusinessPolicyV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Business policy not found"}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_updatebusinesspolicy"}],"panels":[]}]},"httpPath":"/business-policies/{businessPolicyId}"},{"label":"Delete a business policy","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/business-policies/businesspoliciescontroller_deletebusinesspolicy","routeSlug":"/v2/openapi/business-policies/businesspoliciescontroller_deletebusinesspolicy","metadata":{"seo":{"title":"Delete a business policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"BusinessPoliciesController_deleteBusinessPolicy","name":"Delete a business policy","isWebhook":false,"pointer":"/paths/~1business-policies~1{businessPolicyId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a business policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marks the business policy as DELETED."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["business-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"businessPolicyId","in":"path","schemaId":"schema_171","description":"Business policy document ID","required":true}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/business-policies/{businessPolicyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"businessPolicyId","in":"path","required":true,"example":"6a3ebb7893bb2649e19cb8a6","schemaId":"schema_171"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["business-policies:write"]}],"responseCodes":["200","401","403","404"],"pointer":"/business-policies/{businessPolicyId}","href":"business-policies/businesspoliciescontroller_deletebusinesspolicy","openApiOperationId":"BusinessPoliciesController_deleteBusinessPolicy","summary":"Delete a business policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Business policy deleted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}},"schemaId":"components/schemas/BusinessPolicyV1Dto"},{"code":"401","description":"Unauthorized"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — business_id header missing"},"children":[]}]}]}]},{"code":"404","description":"Business policy not found"}],"pointer":"/paths/~1business-policies~1{businessPolicyId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BusinessPolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BusinessPolicyV1Dto"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/business-policies/businesspoliciescontroller_deletebusinesspolicy"}],"panels":[]}]},"httpPath":"/business-policies/{businessPolicyId}"}],"content":{"contentType":"group","meta":{"name":"business-policies"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"business-policies","showPageActions":true},{"nodeType":"markdoc","content":"Spend policy configuration. Private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/business-policies","summary":"List all business policy groups","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_listpolicygroups","deprecated":false},{"title":"/business-policies/policy-group-policies","summary":"Fetch all policy groups with their policies","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getpolicygrouppolicies","deprecated":false},{"title":"/business-policies/{policyId}/policies","summary":"Get business policies by policy group ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getpoliciesbygroupid","deprecated":false},{"title":"/business-policies/single/{businessPolicyId}","summary":"Get a single business policy by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getpolicybyid","deprecated":false},{"title":"/business-policies/summary/{businessId}","summary":"Get full business policy summary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getbusinesspolicysummary","deprecated":false},{"title":"/business-policies/category-policies","summary":"Get category or subcategory policies","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getcategorypolicies","deprecated":false},{"title":"/business-policies/category-policies","summary":"Create or update a category / subcategory policy","prefix":{"name":"put","color":"put"},"badges":[],"link":"/business-policies/businesspoliciescontroller_upsertcategorypolicy","deprecated":false},{"title":"/business-policies/category-policies/{businessPolicyId}","summary":"Update a category or subcategory policy","prefix":{"name":"put","color":"put"},"badges":[],"link":"/business-policies/businesspoliciescontroller_updatecategorypolicy","deprecated":false},{"title":"/business-policies/category-policies/{businessPolicyId}","summary":"Delete a category or subcategory policy","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/business-policies/businesspoliciescontroller_deletecategorypolicy","deprecated":false},{"title":"/business-policies/workflows","summary":"List policy approval workflows for the selected currency","prefix":{"name":"get","color":"get"},"badges":[],"link":"/business-policies/businesspoliciescontroller_getpolicyworkflows","deprecated":false},{"title":"/business-policies/workflows","summary":"Create a policy approval workflow for a currency","prefix":{"name":"post","color":"post"},"badges":[],"link":"/business-policies/businesspoliciescontroller_createpolicyworkflow","deprecated":false},{"title":"/business-policies/create/{policyId}","summary":"Create a new business policy","prefix":{"name":"post","color":"post"},"badges":[],"link":"/business-policies/businesspoliciescontroller_createbusinesspolicy","deprecated":false},{"title":"/business-policies/{businessPolicyId}","summary":"Update a business policy","prefix":{"name":"put","color":"put"},"badges":[],"link":"/business-policies/businesspoliciescontroller_updatebusinesspolicy","deprecated":false},{"title":"/business-policies/{businessPolicyId}","summary":"Delete a business policy","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/business-policies/businesspoliciescontroller_deletebusinesspolicy","deprecated":false}]}]}]}]}},{"type":"group","label":"Wallet policies · Policies","link":"/v2/openapi/wallet-policies","routeSlug":"/v2/openapi/wallet-policies","items":[{"label":"Get policies by wallet ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpoliciesbywallet","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpoliciesbywallet","metadata":{"seo":{"title":"Get policies by wallet ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getPoliciesByWallet","name":"Get policies by wallet ID","isWebhook":false,"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get policies by wallet ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get policies by wallet ID"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"walletId","in":"path","schemaId":"schema_110","description":"Wallet ID","required":true}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_173","description":"Filter by status"},{"name":"includeExpired","in":"query","schemaId":"schema_174","description":"Include expired/revoked policies"}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/wallet/{walletId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"walletId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_173"},{"name":"includeExpired","in":"query","required":false,"schemaId":"schema_174"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/wallet/{walletId}","href":"wallet-policies/walletaccesspolicycontroller_getpoliciesbywallet","openApiOperationId":"WalletAccessPolicyController_getPoliciesByWallet","summary":"Get policies by wallet ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policies retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_175"}},"schemaId":"schema_175"}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_175","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_175"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_getpoliciesbywallet"}],"panels":[]}]},"httpPath":"/wallet-policies/wallet/{walletId}"},{"label":"Get policies by employee ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpoliciesbyemployee","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpoliciesbyemployee","metadata":{"seo":{"title":"Get policies by employee ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getPoliciesByEmployee","name":"Get policies by employee ID","isWebhook":false,"pointer":"/paths/~1wallet-policies~1employee~1{employeeId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get policies by employee ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get policies by employee ID"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employeeId","in":"path","schemaId":"schema_110","description":"Employee ID","required":true}],"pointer":"/paths/~1wallet-policies~1employee~1{employeeId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_173","description":"Filter by status"},{"name":"includeExpired","in":"query","schemaId":"schema_174","description":"Include expired/revoked policies"}],"pointer":"/paths/~1wallet-policies~1employee~1{employeeId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1employee~1{employeeId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/employee/{employeeId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employeeId","in":"path","required":true,"schemaId":"schema_110"}],"query":[{"name":"status","in":"query","required":false,"schemaId":"schema_173"},{"name":"includeExpired","in":"query","required":false,"schemaId":"schema_174"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/employee/{employeeId}","href":"wallet-policies/walletaccesspolicycontroller_getpoliciesbyemployee","openApiOperationId":"WalletAccessPolicyController_getPoliciesByEmployee","summary":"Get policies by employee ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policies retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_175"}},"schemaId":"schema_175"}],"pointer":"/paths/~1wallet-policies~1employee~1{employeeId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_175","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_175"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_getpoliciesbyemployee"}],"panels":[]}]},"httpPath":"/wallet-policies/employee/{employeeId}"},{"label":"Get single policy by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpolicy","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_getpolicy","metadata":{"seo":{"title":"Get single policy by ID","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getPolicy","name":"Get single policy by ID","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get single policy by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get single policy by ID"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/{policyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}","href":"wallet-policies/walletaccesspolicycontroller_getpolicy","openApiOperationId":"WalletAccessPolicyController_getPolicy","summary":"Get single policy by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies~1{policyId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_getpolicy"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}"},{"label":"Modify policy","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_modifypolicy","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_modifypolicy","metadata":{"seo":{"title":"Modify policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_modifyPolicy","name":"Modify policy","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Modify policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Modify policy"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ModifyAccessV1Dto"}},"schemaId":"components/schemas/ModifyAccessV1Dto","pointer":"/paths/~1wallet-policies~1{policyId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/wallet-policies/{policyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ModifyAccessV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}","href":"wallet-policies/walletaccesspolicycontroller_modifypolicy","openApiOperationId":"WalletAccessPolicyController_modifyPolicy","summary":"Modify policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ModifyAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ModifyAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy modified successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies~1{policyId}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_modifypolicy"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}"},{"label":"Revoke policy","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_revokepolicy","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_revokepolicy","metadata":{"seo":{"title":"Revoke policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_revokePolicy","name":"Revoke policy","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Revoke policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Revoke policy"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RevokeAccessV1Dto"}},"schemaId":"components/schemas/RevokeAccessV1Dto","pointer":"/paths/~1wallet-policies~1{policyId}/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/wallet-policies/{policyId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RevokeAccessV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}","href":"wallet-policies/walletaccesspolicycontroller_revokepolicy","openApiOperationId":"WalletAccessPolicyController_revokePolicy","summary":"Revoke policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RevokeAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RevokeAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy revoked successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies~1{policyId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_revokepolicy"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}"},{"label":"Suspend policy","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_suspendpolicy","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_suspendpolicy","metadata":{"seo":{"title":"Suspend policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_suspendPolicy","name":"Suspend policy","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}~1suspend/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suspend policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Suspend policy"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1suspend/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1suspend/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SuspendAccessV1Dto"}},"schemaId":"components/schemas/SuspendAccessV1Dto","pointer":"/paths/~1wallet-policies~1{policyId}~1suspend/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/{policyId}/suspend","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SuspendAccessV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}/suspend","href":"wallet-policies/walletaccesspolicycontroller_suspendpolicy","openApiOperationId":"WalletAccessPolicyController_suspendPolicy","summary":"Suspend policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/SuspendAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SuspendAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy suspended successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies~1{policyId}~1suspend/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_suspendpolicy"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}/suspend"},{"label":"Reactivate policy","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_reactivatepolicy","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_reactivatepolicy","metadata":{"seo":{"title":"Reactivate policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_reactivatePolicy","name":"Reactivate policy","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}~1reactivate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reactivate policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reactivate policy"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1reactivate/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1reactivate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReactivateAccessV1Dto"}},"schemaId":"components/schemas/ReactivateAccessV1Dto","pointer":"/paths/~1wallet-policies~1{policyId}~1reactivate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/{policyId}/reactivate","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ReactivateAccessV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}/reactivate","href":"wallet-policies/walletaccesspolicycontroller_reactivatepolicy","openApiOperationId":"WalletAccessPolicyController_reactivatePolicy","summary":"Reactivate policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/ReactivateAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReactivateAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Policy reactivated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies~1{policyId}~1reactivate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_reactivatepolicy"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}/reactivate"},{"label":"Grant access (create policy)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_grantaccess","routeSlug":"/v2/openapi/wallet-policies/walletaccesspolicycontroller_grantaccess","metadata":{"seo":{"title":"Grant access (create policy)","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_grantAccess","name":"Grant access (create policy)","isWebhook":false,"pointer":"/paths/~1wallet-policies/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Grant access (create policy)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Grant access (create policy)"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GrantAccessV1Dto"}},"schemaId":"components/schemas/GrantAccessV1Dto","pointer":"/paths/~1wallet-policies/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/GrantAccessV1Dto"}},"responseCodes":["201"],"pointer":"/wallet-policies","href":"wallet-policies/walletaccesspolicycontroller_grantaccess","openApiOperationId":"WalletAccessPolicyController_grantAccess","summary":"Grant access (create policy)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/GrantAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GrantAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Access granted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}},"schemaId":"components/schemas/PolicyV1Dto"}],"pointer":"/paths/~1wallet-policies/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/PolicyV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PolicyV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies/walletaccesspolicycontroller_grantaccess"}],"panels":[]}]},"httpPath":"/wallet-policies"}],"content":{"contentType":"group","meta":{"name":"wallet-policies"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Wallet policies · Policies","showPageActions":true},{"nodeType":"markdoc","content":"Grant, read, modify, suspend, and revoke wallet policies."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/wallet-policies/wallet/{walletId}","summary":"Get policies by wallet ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_getpoliciesbywallet","deprecated":false},{"title":"/wallet-policies/employee/{employeeId}","summary":"Get policies by employee ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_getpoliciesbyemployee","deprecated":false},{"title":"/wallet-policies/{policyId}","summary":"Get single policy by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_getpolicy","deprecated":false},{"title":"/wallet-policies/{policyId}","summary":"Modify policy","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_modifypolicy","deprecated":false},{"title":"/wallet-policies/{policyId}","summary":"Revoke policy","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_revokepolicy","deprecated":false},{"title":"/wallet-policies/{policyId}/suspend","summary":"Suspend policy","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_suspendpolicy","deprecated":false},{"title":"/wallet-policies/{policyId}/reactivate","summary":"Reactivate policy","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_reactivatepolicy","deprecated":false},{"title":"/wallet-policies","summary":"Grant access (create policy)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies/walletaccesspolicycontroller_grantaccess","deprecated":false}]}]}]}]}},{"type":"group","label":"Wallet policies · Permissions","link":"/v2/openapi/wallet-policies-permissions","routeSlug":"/v2/openapi/wallet-policies-permissions","items":[{"label":"List all available permissions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_listpermissions","routeSlug":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_listpermissions","metadata":{"seo":{"title":"List all available permissions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_listPermissions","name":"List all available permissions","isWebhook":false,"pointer":"/paths/~1wallet-policies~1permissions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all available permissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all available permissions"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1permissions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/permissions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/permissions","href":"wallet-policies-permissions/walletaccesspolicycontroller_listpermissions","openApiOperationId":"WalletAccessPolicyController_listPermissions","summary":"List all available permissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Permissions retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_176"}},"schemaId":"schema_176"}],"pointer":"/paths/~1wallet-policies~1permissions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_176","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_176"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-permissions/walletaccesspolicycontroller_listpermissions"}],"panels":[]}]},"httpPath":"/wallet-policies/permissions"},{"label":"Sync permission seed data","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_syncpermissions","routeSlug":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_syncpermissions","metadata":{"seo":{"title":"Sync permission seed data","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_syncPermissions","name":"Sync permission seed data","isWebhook":false,"pointer":"/paths/~1wallet-policies~1permissions~1sync/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Sync permission seed data","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync permission seed data"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1permissions~1sync/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/permissions/sync","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"responseCodes":["200"],"pointer":"/wallet-policies/permissions/sync","href":"wallet-policies-permissions/walletaccesspolicycontroller_syncpermissions","openApiOperationId":"WalletAccessPolicyController_syncPermissions","summary":"Sync permission seed data"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Permissions synced successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PermissionSyncResultDto"}},"schemaId":"components/schemas/PermissionSyncResultDto"}],"pointer":"/paths/~1wallet-policies~1permissions~1sync/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PermissionSyncResultDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PermissionSyncResultDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-permissions/walletaccesspolicycontroller_syncpermissions"}],"panels":[]}]},"httpPath":"/wallet-policies/permissions/sync"},{"label":"Get computed permissions for employee on wallet","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_getcomputedpermissions","routeSlug":"/v2/openapi/wallet-policies-permissions/walletaccesspolicycontroller_getcomputedpermissions","metadata":{"seo":{"title":"Get computed permissions for employee on wallet","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getComputedPermissions","name":"Get computed permissions for employee on wallet","isWebhook":false,"pointer":"/paths/~1wallet-policies~1permissions~1{employeeId}~1{walletId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get computed permissions for employee on wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get computed permissions for employee on wallet"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employeeId","in":"path","schemaId":"schema_110","description":"Employee ID","required":true},{"name":"walletId","in":"path","schemaId":"schema_110","description":"Wallet ID","required":true}],"pointer":"/paths/~1wallet-policies~1permissions~1{employeeId}~1{walletId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1permissions~1{employeeId}~1{walletId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/permissions/{employeeId}/{walletId}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employeeId","in":"path","required":true,"schemaId":"schema_110"},{"name":"walletId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/permissions/{employeeId}/{walletId}","href":"wallet-policies-permissions/walletaccesspolicycontroller_getcomputedpermissions","openApiOperationId":"WalletAccessPolicyController_getComputedPermissions","summary":"Get computed permissions for employee on wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Computed permissions retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComputedPermissionsDto"}},"schemaId":"components/schemas/ComputedPermissionsDto"}],"pointer":"/paths/~1wallet-policies~1permissions~1{employeeId}~1{walletId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComputedPermissionsDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComputedPermissionsDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-permissions/walletaccesspolicycontroller_getcomputedpermissions"}],"panels":[]}]},"httpPath":"/wallet-policies/permissions/{employeeId}/{walletId}"}],"content":{"contentType":"group","meta":{"name":"wallet-policies-permissions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Wallet policies · Permissions","showPageActions":true},{"nodeType":"markdoc","content":"Available permissions and computed permissions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/wallet-policies/permissions","summary":"List all available permissions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies-permissions/walletaccesspolicycontroller_listpermissions","deprecated":false},{"title":"/wallet-policies/permissions/sync","summary":"Sync permission seed data","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies-permissions/walletaccesspolicycontroller_syncpermissions","deprecated":false},{"title":"/wallet-policies/permissions/{employeeId}/{walletId}","summary":"Get computed permissions for employee on wallet","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies-permissions/walletaccesspolicycontroller_getcomputedpermissions","deprecated":false}]}]}]}]}},{"type":"group","label":"Wallet policies · Access checks","link":"/v2/openapi/wallet-policies-checks","routeSlug":"/v2/openapi/wallet-policies-checks","items":[{"label":"Check if employee has permission on wallet","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-checks/walletaccesspolicycontroller_checkaccess","routeSlug":"/v2/openapi/wallet-policies-checks/walletaccesspolicycontroller_checkaccess","metadata":{"seo":{"title":"Check if employee has permission on wallet","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_checkAccess","name":"Check if employee has permission on wallet","isWebhook":false,"pointer":"/paths/~1wallet-policies~1check-access/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Check if employee has permission on wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check if employee has permission on wallet"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1check-access/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CheckAccessV1Dto"}},"schemaId":"components/schemas/CheckAccessV1Dto","pointer":"/paths/~1wallet-policies~1check-access/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/check-access","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CheckAccessV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/check-access","href":"wallet-policies-checks/walletaccesspolicycontroller_checkaccess","openApiOperationId":"WalletAccessPolicyController_checkAccess","summary":"Check if employee has permission on wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CheckAccessV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CheckAccessV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Access check completed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccessCheckResultDto"}},"schemaId":"components/schemas/AccessCheckResultDto"}],"pointer":"/paths/~1wallet-policies~1check-access/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AccessCheckResultDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AccessCheckResultDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-checks/walletaccesspolicycontroller_checkaccess"}],"panels":[]}]},"httpPath":"/wallet-policies/check-access"},{"label":"Check transaction limits","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-checks/walletaccesspolicycontroller_checklimits","routeSlug":"/v2/openapi/wallet-policies-checks/walletaccesspolicycontroller_checklimits","metadata":{"seo":{"title":"Check transaction limits","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_checkLimits","name":"Check transaction limits","isWebhook":false,"pointer":"/paths/~1wallet-policies~1check-limits/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Check transaction limits","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check transaction limits"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1check-limits/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CheckLimitsV1Dto"}},"schemaId":"components/schemas/CheckLimitsV1Dto","pointer":"/paths/~1wallet-policies~1check-limits/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/check-limits","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CheckLimitsV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/check-limits","href":"wallet-policies-checks/walletaccesspolicycontroller_checklimits","openApiOperationId":"WalletAccessPolicyController_checkLimits","summary":"Check transaction limits"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/CheckLimitsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CheckLimitsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Limits check completed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LimitsCheckResultDto"}},"schemaId":"components/schemas/LimitsCheckResultDto"}],"pointer":"/paths/~1wallet-policies~1check-limits/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LimitsCheckResultDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LimitsCheckResultDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-checks/walletaccesspolicycontroller_checklimits"}],"panels":[]}]},"httpPath":"/wallet-policies/check-limits"}],"content":{"contentType":"group","meta":{"name":"wallet-policies-checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Wallet policies · Access checks","showPageActions":true},{"nodeType":"markdoc","content":"Check access and transaction limits."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/wallet-policies/check-access","summary":"Check if employee has permission on wallet","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies-checks/walletaccesspolicycontroller_checkaccess","deprecated":false},{"title":"/wallet-policies/check-limits","summary":"Check transaction limits","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies-checks/walletaccesspolicycontroller_checklimits","deprecated":false}]}]}]}]}},{"type":"group","label":"Wallet policies · Audit","link":"/v2/openapi/wallet-policies-audit","routeSlug":"/v2/openapi/wallet-policies-audit","items":[{"label":"Query audit logs with filters","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_queryauditlogs","routeSlug":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_queryauditlogs","metadata":{"seo":{"title":"Query audit logs with filters","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_queryAuditLogs","name":"Query audit logs with filters","isWebhook":false,"pointer":"/paths/~1wallet-policies~1audit~1query/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Query audit logs with filters","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query audit logs with filters"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1audit~1query/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QueryAuditLogsV1Dto"}},"schemaId":"components/schemas/QueryAuditLogsV1Dto","pointer":"/paths/~1wallet-policies~1audit~1query/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/wallet-policies/audit/query","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/QueryAuditLogsV1Dto"}},"responseCodes":["200"],"pointer":"/wallet-policies/audit/query","href":"wallet-policies-audit/walletaccesspolicycontroller_queryauditlogs","openApiOperationId":"WalletAccessPolicyController_queryAuditLogs","summary":"Query audit logs with filters"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/QueryAuditLogsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QueryAuditLogsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Audit logs retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}},"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}],"pointer":"/paths/~1wallet-policies~1audit~1query/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedAuditLogsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-audit/walletaccesspolicycontroller_queryauditlogs"}],"panels":[]}]},"httpPath":"/wallet-policies/audit/query"},{"label":"Get audit log for wallet","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_getwalletauditlog","routeSlug":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_getwalletauditlog","metadata":{"seo":{"title":"Get audit log for wallet","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getWalletAuditLog","name":"Get audit log for wallet","isWebhook":false,"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}~1audit/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get audit log for wallet","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get audit log for wallet"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"walletId","in":"path","schemaId":"schema_110","description":"Wallet ID","required":true}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}~1audit/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}~1audit/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/wallet/{walletId}/audit","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"walletId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/wallet/{walletId}/audit","href":"wallet-policies-audit/walletaccesspolicycontroller_getwalletauditlog","openApiOperationId":"WalletAccessPolicyController_getWalletAuditLog","summary":"Get audit log for wallet"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Audit logs retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}},"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}],"pointer":"/paths/~1wallet-policies~1wallet~1{walletId}~1audit/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedAuditLogsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-audit/walletaccesspolicycontroller_getwalletauditlog"}],"panels":[]}]},"httpPath":"/wallet-policies/wallet/{walletId}/audit"},{"label":"Get audit log for specific policy","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_getpolicyauditlog","routeSlug":"/v2/openapi/wallet-policies-audit/walletaccesspolicycontroller_getpolicyauditlog","metadata":{"seo":{"title":"Get audit log for specific policy","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"WalletAccessPolicyController_getPolicyAuditLog","name":"Get audit log for specific policy","isWebhook":false,"pointer":"/paths/~1wallet-policies~1{policyId}~1audit/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get audit log for specific policy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get audit log for specific policy"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["wallet-policies:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"policyId","in":"path","schemaId":"schema_110","description":"Policy ID","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1audit/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1wallet-policies~1{policyId}~1audit/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/wallet-policies/{policyId}/audit","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"policyId","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["wallet-policies:read"]}],"responseCodes":["200"],"pointer":"/wallet-policies/{policyId}/audit","href":"wallet-policies-audit/walletaccesspolicycontroller_getpolicyauditlog","openApiOperationId":"WalletAccessPolicyController_getPolicyAuditLog","summary":"Get audit log for specific policy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Audit logs retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}},"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}],"pointer":"/paths/~1wallet-policies~1{policyId}~1audit/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedAuditLogsResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditLogsResponseDto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/wallet-policies-audit/walletaccesspolicycontroller_getpolicyauditlog"}],"panels":[]}]},"httpPath":"/wallet-policies/{policyId}/audit"}],"content":{"contentType":"group","meta":{"name":"wallet-policies-audit"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Wallet policies · Audit","showPageActions":true},{"nodeType":"markdoc","content":"Query and read wallet-policy audit logs. Back-office / secondary."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/wallet-policies/audit/query","summary":"Query audit logs with filters","prefix":{"name":"post","color":"post"},"badges":[],"link":"/wallet-policies-audit/walletaccesspolicycontroller_queryauditlogs","deprecated":false},{"title":"/wallet-policies/wallet/{walletId}/audit","summary":"Get audit log for wallet","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies-audit/walletaccesspolicycontroller_getwalletauditlog","deprecated":false},{"title":"/wallet-policies/{policyId}/audit","summary":"Get audit log for specific policy","prefix":{"name":"get","color":"get"},"badges":[],"link":"/wallet-policies-audit/walletaccesspolicycontroller_getpolicyauditlog","deprecated":false}]}]}]}]}},{"type":"group","label":"roles","link":"/v2/openapi/roles","routeSlug":"/v2/openapi/roles","items":[{"label":"list all permissions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_listallpermissions","routeSlug":"/v2/openapi/roles/permissionscontroller_listallpermissions","metadata":{"seo":{"title":"list all permissions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_listAllPermissions","name":"list all permissions","isWebhook":false,"pointer":"/paths/~1permissions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"list all permissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list all permissions"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/permissions","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:read"]}],"responseCodes":["200"],"pointer":"/permissions","href":"roles/permissionscontroller_listallpermissions","openApiOperationId":"PermissionsController_listAllPermissions","summary":"list all permissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"permissions fetched successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PermissionResponseV1Dto"}},"schemaId":"components/schemas/PermissionResponseV1Dto"}],"pointer":"/paths/~1permissions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PermissionResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PermissionResponseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_listallpermissions"}],"panels":[]}]},"httpPath":"/permissions"},{"label":"Update users role","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_updateusersrole","routeSlug":"/v2/openapi/roles/permissionscontroller_updateusersrole","metadata":{"seo":{"title":"Update users role","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_updateUsersRole","name":"Update users role","isWebhook":false,"pointer":"/paths/~1permissions~1employees~1{employee_id}~1role/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update users role","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update users role"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employee_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}~1role/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}~1role/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateUserRoleV1Dto"}},"schemaId":"components/schemas/UpdateUserRoleV1Dto","pointer":"/paths/~1permissions~1employees~1{employee_id}~1role/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/permissions/employees/{employee_id}/role","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employee_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateUserRoleV1Dto"}},"responseCodes":["200"],"pointer":"/permissions/employees/{employee_id}/role","href":"roles/permissionscontroller_updateusersrole","openApiOperationId":"PermissionsController_updateUsersRole","summary":"Update users role"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateUserRoleV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateUserRoleV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"User role updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateUsersRoleResponseV1Dto"}},"schemaId":"components/schemas/UpdateUsersRoleResponseV1Dto"}],"pointer":"/paths/~1permissions~1employees~1{employee_id}~1role/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateUsersRoleResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateUsersRoleResponseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_updateusersrole"}],"panels":[]}]},"httpPath":"/permissions/employees/{employee_id}/role"},{"label":"Update employee permissions","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_updateemployeepermissions","routeSlug":"/v2/openapi/roles/permissionscontroller_updateemployeepermissions","metadata":{"seo":{"title":"Update employee permissions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_updateEmployeePermissions","name":"Update employee permissions","isWebhook":false,"pointer":"/paths/~1permissions~1employees~1{employee_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update employee permissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update employee permissions"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employee_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateEmployeePermissionsV1Dto"}},"schemaId":"components/schemas/UpdateEmployeePermissionsV1Dto","pointer":"/paths/~1permissions~1employees~1{employee_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/permissions/employees/{employee_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employee_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateEmployeePermissionsV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/permissions/employees/{employee_id}","href":"roles/permissionscontroller_updateemployeepermissions","openApiOperationId":"PermissionsController_updateEmployeePermissions","summary":"Update employee permissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateEmployeePermissionsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateEmployeePermissionsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee permissions updated successfully"},{"code":"400","description":"Bad Request - Invalid permission values or structure"},{"code":"404","description":"Employee not found"}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/patch/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_updateemployeepermissions"}],"panels":[]}]},"httpPath":"/permissions/employees/{employee_id}"},{"label":"Fetch employee permissions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_getemployeepermissions","routeSlug":"/v2/openapi/roles/permissionscontroller_getemployeepermissions","metadata":{"seo":{"title":"Fetch employee permissions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_getEmployeePermissions","name":"Fetch employee permissions","isWebhook":false,"pointer":"/paths/~1permissions~1employees~1{employee_id}/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch employee permissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fetch grouped permissions for a specific employee"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"employee_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/permissions/employees/{employee_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"employee_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"responseCodes":["200"],"pointer":"/permissions/employees/{employee_id}","href":"roles/permissionscontroller_getemployeepermissions","openApiOperationId":"PermissionsController_getEmployeePermissions","summary":"Fetch employee permissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Employee permissions fetched successfully"}],"pointer":"/paths/~1permissions~1employees~1{employee_id}/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_getemployeepermissions"}],"panels":[]}]},"httpPath":"/permissions/employees/{employee_id}"},{"label":"Update role permissions","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_updaterolepermissions","routeSlug":"/v2/openapi/roles/permissionscontroller_updaterolepermissions","metadata":{"seo":{"title":"Update role permissions","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_updateRolePermissions","name":"Update role permissions","isWebhook":false,"pointer":"/paths/~1permissions~1update~1{role_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update role permissions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update permissions for a specific role"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"role_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1update~1{role_id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1update~1{role_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateRolePermissionsV1Dto"}},"schemaId":"components/schemas/UpdateRolePermissionsV1Dto","pointer":"/paths/~1permissions~1update~1{role_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/permissions/update/{role_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"role_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateRolePermissionsV1Dto"}},"responseCodes":["200","400","401","404"],"pointer":"/permissions/update/{role_id}","href":"roles/permissionscontroller_updaterolepermissions","openApiOperationId":"PermissionsController_updateRolePermissions","summary":"Update role permissions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateRolePermissionsV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateRolePermissionsV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Role permissions updated successfully"},{"code":"400","description":"Bad Request - Invalid permission structure"},{"code":"401","description":"Unauthorized"},{"code":"404","description":"Role not found"}],"pointer":"/paths/~1permissions~1update~1{role_id}/put/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_updaterolepermissions"}],"panels":[]}]},"httpPath":"/permissions/update/{role_id}"},{"label":"get set mandates","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_listmandates","routeSlug":"/v2/openapi/roles/permissionscontroller_listmandates","metadata":{"seo":{"title":"get set mandates","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_listMandates","name":"get set mandates","isWebhook":false,"pointer":"/paths/~1permissions~1mandates/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"get set mandates","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"get set mandates"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1mandates/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/permissions/mandates","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"responseCodes":["200"],"pointer":"/permissions/mandates","href":"roles/permissionscontroller_listmandates","openApiOperationId":"PermissionsController_listMandates","summary":"get set mandates"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"mandates fetched successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}},"schemaId":"components/schemas/MandateResponseV1Dto"}],"pointer":"/paths/~1permissions~1mandates/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MandateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_listmandates"}],"panels":[]}]},"httpPath":"/permissions/mandates"},{"label":"Update mandate minimum approvers","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_updatemandate","routeSlug":"/v2/openapi/roles/permissionscontroller_updatemandate","metadata":{"seo":{"title":"Update mandate minimum approvers","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_updateMandate","name":"Update mandate minimum approvers","isWebhook":false,"pointer":"/paths/~1permissions~1mandates~1{mandate_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update mandate minimum approvers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update mandate minimum approvers"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mandate_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateMandateV1Dto"}},"schemaId":"components/schemas/UpdateMandateV1Dto","pointer":"/paths/~1permissions~1mandates~1{mandate_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/permissions/mandates/{mandate_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"mandate_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateMandateV1Dto"}},"responseCodes":["200"],"pointer":"/permissions/mandates/{mandate_id}","href":"roles/permissionscontroller_updatemandate","openApiOperationId":"PermissionsController_updateMandate","summary":"Update mandate minimum approvers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateMandateV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateMandateV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Mandate updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}},"schemaId":"components/schemas/MandateResponseV1Dto"}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MandateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_updatemandate"}],"panels":[]}]},"httpPath":"/permissions/mandates/{mandate_id}"},{"label":"update user mandate","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_updatesingleapprover","routeSlug":"/v2/openapi/roles/permissionscontroller_updatesingleapprover","metadata":{"seo":{"title":"update user mandate","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_updateSingleApprover","name":"update user mandate","isWebhook":false,"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers~1{approver_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"update user mandate","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update user mandate"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mandate_id","in":"path","schemaId":"schema_110","required":true},{"name":"approver_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers~1{approver_id}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers~1{approver_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSingleApproverV1Dto"}},"schemaId":"components/schemas/UpdateSingleApproverV1Dto","pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers~1{approver_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/permissions/mandates/{mandate_id}/approvers/{approver_id}","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"mandate_id","in":"path","required":true,"schemaId":"schema_110"},{"name":"approver_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateSingleApproverV1Dto"}},"responseCodes":["200"],"pointer":"/permissions/mandates/{mandate_id}/approvers/{approver_id}","href":"roles/permissionscontroller_updatesingleapprover","openApiOperationId":"PermissionsController_updateSingleApprover","summary":"update user mandate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/UpdateSingleApproverV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSingleApproverV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Mandate updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}},"schemaId":"components/schemas/MandateResponseV1Dto"}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers~1{approver_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MandateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_updatesingleapprover"}],"panels":[]}]},"httpPath":"/permissions/mandates/{mandate_id}/approvers/{approver_id}"},{"label":"Remove approvers from mandate","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_removeapproverfrommandate","routeSlug":"/v2/openapi/roles/permissionscontroller_removeapproverfrommandate","metadata":{"seo":{"title":"Remove approvers from mandate","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_removeApproverFromMandate","name":"Remove approvers from mandate","isWebhook":false,"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove approvers from mandate","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Remove one or more approvers from a mandate by providing their IDs"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mandate_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RemoveApproverFromMandateV1Dto"}},"schemaId":"components/schemas/RemoveApproverFromMandateV1Dto","pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/permissions/mandates/{mandate_id}/approvers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"mandate_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/RemoveApproverFromMandateV1Dto"}},"responseCodes":["200"],"pointer":"/permissions/mandates/{mandate_id}/approvers","href":"roles/permissionscontroller_removeapproverfrommandate","openApiOperationId":"PermissionsController_removeApproverFromMandate","summary":"Remove approvers from mandate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/RemoveApproverFromMandateV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/RemoveApproverFromMandateV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Approvers removed from mandate successfully"}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_removeapproverfrommandate"}],"panels":[]}]},"httpPath":"/permissions/mandates/{mandate_id}/approvers"},{"label":"Add approvers to mandate","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/roles/permissionscontroller_addapproverstomandate","routeSlug":"/v2/openapi/roles/permissionscontroller_addapproverstomandate","metadata":{"seo":{"title":"Add approvers to mandate","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PermissionsController_addApproversToMandate","name":"Add approvers to mandate","isWebhook":false,"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add approvers to mandate","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add one or more approvers to a mandate by providing their IDs and configuration"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["roles:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mandate_id","in":"path","schemaId":"schema_110","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddApproversToMandateV1Dto"}},"schemaId":"components/schemas/AddApproversToMandateV1Dto","pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/permissions/mandates/{mandate_id}/approvers","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[{"name":"mandate_id","in":"path","required":true,"schemaId":"schema_110"}],"query":[],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["roles:write"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddApproversToMandateV1Dto"}},"responseCodes":["200","400","404"],"pointer":"/permissions/mandates/{mandate_id}/approvers","href":"roles/permissionscontroller_addapproverstomandate","openApiOperationId":"PermissionsController_addApproversToMandate","summary":"Add approvers to mandate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"schemaId":"components/schemas/AddApproversToMandateV1Dto","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddApproversToMandateV1Dto"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Approvers added to mandate successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}},"schemaId":"components/schemas/MandateResponseV1Dto"},{"code":"400","description":"Bad Request - Invalid input data"},{"code":"404","description":"Mandate not found"}],"pointer":"/paths/~1permissions~1mandates~1{mandate_id}~1approvers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MandateResponseV1Dto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MandateResponseV1Dto"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/roles/permissionscontroller_addapproverstomandate"}],"panels":[]}]},"httpPath":"/permissions/mandates/{mandate_id}/approvers"}],"content":{"contentType":"group","meta":{"name":"roles"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"roles","showPageActions":true},{"nodeType":"markdoc","content":"Roles, permissions and approval mandates. Private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/permissions","summary":"list all permissions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/roles/permissionscontroller_listallpermissions","deprecated":false},{"title":"/permissions/employees/{employee_id}/role","summary":"Update users role","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/roles/permissionscontroller_updateusersrole","deprecated":false},{"title":"/permissions/employees/{employee_id}","summary":"Update employee permissions","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/roles/permissionscontroller_updateemployeepermissions","deprecated":false},{"title":"/permissions/employees/{employee_id}","summary":"Fetch employee permissions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/roles/permissionscontroller_getemployeepermissions","deprecated":false},{"title":"/permissions/update/{role_id}","summary":"Update role permissions","prefix":{"name":"put","color":"put"},"badges":[],"link":"/roles/permissionscontroller_updaterolepermissions","deprecated":false},{"title":"/permissions/mandates","summary":"get set mandates","prefix":{"name":"put","color":"put"},"badges":[],"link":"/roles/permissionscontroller_listmandates","deprecated":false},{"title":"/permissions/mandates/{mandate_id}","summary":"Update mandate minimum approvers","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/roles/permissionscontroller_updatemandate","deprecated":false},{"title":"/permissions/mandates/{mandate_id}/approvers/{approver_id}","summary":"update user mandate","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/roles/permissionscontroller_updatesingleapprover","deprecated":false},{"title":"/permissions/mandates/{mandate_id}/approvers","summary":"Remove approvers from mandate","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/roles/permissionscontroller_removeapproverfrommandate","deprecated":false},{"title":"/permissions/mandates/{mandate_id}/approvers","summary":"Add approvers to mandate","prefix":{"name":"post","color":"post"},"badges":[],"link":"/roles/permissionscontroller_addapproverstomandate","deprecated":false}]}]}]}]}},{"type":"group","label":"audit-trail","link":"/v2/openapi/audit-trail","routeSlug":"/v2/openapi/audit-trail","items":[{"label":"List audit trail events","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/audit-trail/audittrailcontroller_listauditevents","routeSlug":"/v2/openapi/audit-trail/audittrailcontroller_listauditevents","metadata":{"seo":{"title":"List audit trail events","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AuditTrailController_listAuditEvents","name":"List audit trail events","isWebhook":false,"pointer":"/paths/~1audit-trail/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List audit trail events","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List audit trail events"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["audit-trail:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number"},{"name":"limit","in":"query","schemaId":"schema_177","description":"Items per page (max 1000)"}],"pointer":"/paths/~1audit-trail/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1audit-trail/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/audit-trail","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":15,"schemaId":"schema_177"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["audit-trail:read"]}],"responseCodes":["200","401"],"pointer":"/audit-trail","href":"audit-trail/audittrailcontroller_listauditevents","openApiOperationId":"AuditTrailController_listAuditEvents","summary":"List audit trail events"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of audit trail events","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditEventResponseDto"}},"schemaId":"components/schemas/PaginatedAuditEventResponseDto"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1audit-trail/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaginatedAuditEventResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaginatedAuditEventResponseDto"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/audit-trail/audittrailcontroller_listauditevents"}],"panels":[]}]},"httpPath":"/audit-trail"},{"label":"Get intelligent audit trail digest with grouped insights","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v2/openapi/audit-trail/audittrailcontroller_getauditdigest","routeSlug":"/v2/openapi/audit-trail/audittrailcontroller_getauditdigest","metadata":{"seo":{"title":"Get intelligent audit trail digest with grouped insights","description":"🔒 Private label — contact sales. Requires a private-label entitlement on your API client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AuditTrailController_getAuditDigest","name":"Get intelligent audit trail digest with grouped insights","isWebhook":false,"pointer":"/paths/~1audit-trail~1digest/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get intelligent audit trail digest with grouped insights","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔒 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Private label — "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"mailto:sales@boyahq.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact sales"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requires a private-label entitlement on your API client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get intelligent audit trail digest with grouped insights"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2ClientCredentials","scopes":["audit-trail:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_108","description":"Page number for underlying events"},{"name":"limit","in":"query","schemaId":"schema_178","description":"Number of events to analyze (max 1000)"}],"pointer":"/paths/~1audit-trail~1digest/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"business_id","in":"header","schemaId":"schema_110","description":"Business identifier for the request","required":true}],"pointer":"/paths/~1audit-trail~1digest/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/audit-trail/digest","servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_108"},{"name":"limit","in":"query","required":false,"example":100,"schemaId":"schema_178"}],"querystring":[],"header":[{"name":"business_id","in":"header","required":true,"schemaId":"schema_110"}],"cookie":[]},"security":[{"schemes":[{"id":"oauth2ClientCredentials","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}],"scopes":["audit-trail:read"]}],"responseCodes":["200","401"],"pointer":"/audit-trail/digest","href":"audit-trail/audittrailcontroller_getauditdigest","openApiOperationId":"AuditTrailController_getAuditDigest","summary":"Get intelligent audit trail digest with grouped insights"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/v2/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Audit trail digest with grouped insights and statistics","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AuditDigestResponseDto"}},"schemaId":"components/schemas/AuditDigestResponseDto"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1audit-trail~1digest/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AuditDigestResponseDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AuditDigestResponseDto"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/audit-trail/audittrailcontroller_getauditdigest"}],"panels":[]}]},"httpPath":"/audit-trail/digest"}],"content":{"contentType":"group","meta":{"name":"audit-trail"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"audit-trail","showPageActions":true},{"nodeType":"markdoc","content":"Immutable audit-trail events. Private label."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/audit-trail","summary":"List audit trail events","prefix":{"name":"get","color":"get"},"badges":[],"link":"/audit-trail/audittrailcontroller_listauditevents","deprecated":false},{"title":"/audit-trail/digest","summary":"Get intelligent audit trail digest with grouped insights","prefix":{"name":"get","color":"get"},"badges":[],"link":"/audit-trail/audittrailcontroller_getauditdigest","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/PaginatedExpenseResponseDto":{"id":"components/schemas/PaginatedExpenseResponseDto","kind":"json-schema","title":"PaginatedExpenseResponseDto","data":{"type":"object","properties":{"docs":{"description":"Expense documents","type":"array","items":{"$ref":"#/components/schemas/ExpenseV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/ExportReceiptsDto":{"id":"components/schemas/ExportReceiptsDto","kind":"json-schema","title":"ExportReceiptsDto","data":{"type":"object","properties":{"fromdate":{"type":"string","description":"Export start date in ISO format","example":"2026-01-01"},"todate":{"type":"string","description":"Export end date in ISO format","example":"2026-12-31"},"accountref":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional compatibility field from the dashboard payload. The middleware overrides this with the trusted org_wallet_ref header."},"children":[]}]}]}],"example":"1"},"page":{"type":"number","description":"Page number from the dashboard request payload","example":1},"limit":{"type":"number","description":"Requested export limit","example":5000},"order":{"type":"string","description":"Sort direction passed by the dashboard","example":"desc"},"isExport":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional compatibility field from the dashboard payload. The middleware always forwards isExport=true for this endpoint."},"children":[]}]}]}],"example":true},"employee":{"type":"string","description":"Optional employee filter","example":"employee-123"},"team":{"type":"string","description":"Optional reviewer/team filter","example":"team-123"},"status":{"type":"string","description":"Optional expense status filter","example":"pending"},"subcategory":{"type":"string","description":"Optional subcategory filter","example":"sub-123"},"categorySubcategories":{"description":"Optional category filter payload","allOf":[{"$ref":"#/components/schemas/StringArrayFilterDto"}]},"payment_status":{"type":"string","description":"Optional payment status filter","example":"paid"},"tags":{"description":"Optional tags filter payload","allOf":[{"$ref":"#/components/schemas/StringArrayFilterDto"}]},"level":{"type":"number","description":"Optional expense level filter","example":2},"amount_filter_type":{"type":"string","description":"Optional amount filter type","example":"greater_than"},"amount_value":{"type":"number","description":"Optional amount filter exact value","example":1000},"amount_min":{"type":"number","description":"Optional minimum amount filter","example":100},"amount_max":{"type":"number","description":"Optional maximum amount filter","example":5000},"customer":{"type":"string","description":"Optional customer filter","example":"customer-123"},"search":{"type":"string","description":"Optional dashboard search query","example":"hotel"}}}},"components/schemas/ExpenseV1Dto":{"id":"components/schemas/ExpenseV1Dto","kind":"json-schema","title":"ExpenseV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"MongoDB ID"},"amount":{"type":"number","description":"Expense amount"},"fees":{"type":"number","description":"Transaction fees"},"charge":{"type":"number","description":"Total charge amount"},"original_currency":{"type":"string","description":"Original currency"},"currency":{"type":"string","description":"Current currency"},"original_amount":{"type":"number","description":"Original amount"},"transaction_ref":{"type":"string","description":"Transaction reference"},"provider_ref":{"type":"string","description":"Provider reference"},"employee_id":{"type":"string","description":"Employee ID"},"person":{"type":"string","description":"Person name"},"vendor_ref":{"type":"object","description":"Vendor reference"},"transaction_date":{"type":"string","description":"Transaction date"},"MerchantCategoryCode":{"type":"string","description":"Merchant category code"},"MerchantIdentifier":{"type":"string","description":"Merchant identifier"},"fx_rate":{"type":"number","description":"Foreign exchange rate"},"card_vcn":{"type":"string","description":"Card VCN"},"receiver":{"type":"string","description":"Transaction receiver"},"accno":{"type":"string","description":"Account number"},"payment_type":{"type":"string","description":"Payment type"},"channel":{"type":"string","description":"Payment channel"},"subcategory":{"description":"Subcategory details","allOf":[{"$ref":"#/components/schemas/SubcategoryDto"}]},"team":{"description":"Team details","allOf":[{"$ref":"#/components/schemas/TeamDto"}]},"tag":{"description":"Tags array","type":"array","items":{"$ref":"#/components/schemas/TagDto"}},"notes":{"type":"string","description":"Transaction notes"},"risk":{"type":"string","description":"Risk level"},"risk_notes":{"type":"string","description":"Risk notes"},"ip":{"type":"string","description":"IP address"},"attachments":{"description":"Attachment URLs","type":"array","items":{"type":"string"}},"invoice_attachments":{"description":"Invoice attachment URLs","type":"array","items":{"type":"string"}},"payment_status":{"type":"string","description":"Payment status"},"status":{"type":"string","description":"Expense status"},"review_participants":{"description":"Review participants","type":"array","items":{"type":"string"}},"review_mandate":{"type":"number","description":"Review mandate"},"review_level":{"type":"number","description":"Review level"},"priority":{"type":"number","description":"Priority level"},"events":{"description":"Events array","type":"array","items":{"type":"string"}},"exported":{"type":"boolean","description":"Exported flag"},"tax_compliant":{"type":"boolean","description":"Tax compliant flag"},"sync_successful":{"type":"boolean","description":"Sync successful flag"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"vendor":{"type":"string","description":"Vendor name"},"customer":{"type":"object","description":"Customer info"},"subscription_id":{"type":"string","description":"Subscription ID"},"account_number":{"type":"string","description":"Account number"},"scan":{"description":"Scan results","type":"array","items":{"$ref":"#/components/schemas/ScanDto"}},"batched":{"type":"boolean","description":"Batched flag"},"line_items":{"description":"Line items","type":"array","items":{"$ref":"#/components/schemas/LineItemDto"}},"employee_external_id":{"type":"object","description":"Employee external ID"},"employee":{"description":"Employee details","allOf":[{"$ref":"#/components/schemas/EmployeeInfoDto"}]},"reviews":{"description":"Reviews array","type":"array","items":{"$ref":"#/components/schemas/ReviewDto"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"requisition_reference":{"type":"string","description":"Requisition reference"},"acknowledged_by_ai":{"type":"boolean","description":"AI acknowledged flag"},"analysed_by_ai":{"type":"boolean","description":"AI analysed flag"},"attachments_data":{"description":"Attachments data array","type":"array","items":{"type":"string"}},"deleted_attachments":{"description":"Deleted attachments array","type":"array","items":{"type":"string"}},"ready_for_ai":{"type":"boolean","description":"Ready for AI processing flag"},"send_to_ai_attempts":{"type":"number","description":"Send to AI attempts count"},"sent_to_ai":{"type":"boolean","description":"Sent to AI flag"},"id":{"type":"string","description":"Auto-generated ID field"}}}},"components/schemas/UpdateExpenseNoteDto":{"id":"components/schemas/UpdateExpenseNoteDto","kind":"json-schema","title":"UpdateExpenseNoteDto","data":{"type":"object","properties":{"notes":{"type":"string","description":"Notes or description for the expense","example":"Updated expense notes"}},"required":["notes"]}},"components/schemas/UpdateExpenseSubcategoryDto":{"id":"components/schemas/UpdateExpenseSubcategoryDto","kind":"json-schema","title":"UpdateExpenseSubcategoryDto","data":{"type":"object","properties":{"subcategoryId":{"type":"string","description":"Subcategory ID to assign to the expense","example":"64ec5b4bffaef6ff2a28455d"}},"required":["subcategoryId"]}},"components/schemas/ApproveMultipleExpensesDto":{"id":"components/schemas/ApproveMultipleExpensesDto","kind":"json-schema","title":"ApproveMultipleExpensesDto","data":{"type":"object","properties":{"expense_ids":{"description":"Array of expense IDs to approve","example":["expense1","expense2","expense3"],"type":"array","items":{"type":"string"}},"notes":{"type":"string","description":"Optional approval notes","example":"Approved for processing"}},"required":["expense_ids"]}},"components/schemas/ApproveRejectNotesDto":{"id":"components/schemas/ApproveRejectNotesDto","kind":"json-schema","title":"ApproveRejectNotesDto","data":{"type":"object","properties":{"notes":{"type":"string","description":"Optional approval/rejection notes","example":"Reviewed and approved"}}}},"components/schemas/RejectMultipleExpensesDto":{"id":"components/schemas/RejectMultipleExpensesDto","kind":"json-schema","title":"RejectMultipleExpensesDto","data":{"type":"object","properties":{"expense_ids":{"description":"Array of expense IDs to reject","example":["expense1","expense2","expense3"],"type":"array","items":{"type":"string"}},"notes":{"type":"string","description":"Required rejection notes explaining the reason for rejection","example":"Rejected due to insufficient documentation"}},"required":["expense_ids","notes"]}},"components/schemas/RequestNotesDTO":{"id":"components/schemas/RequestNotesDTO","kind":"json-schema","title":"RequestNotesDTO","data":{"type":"object","properties":{"notes":{"type":"string","description":"Required notes explaining","example":"Rejected due to insufficient documentation"}},"required":["notes"]}},"components/schemas/CategoryReportQueryV1Dto":{"id":"components/schemas/CategoryReportQueryV1Dto","kind":"json-schema","title":"CategoryReportQueryV1Dto","data":{"type":"object","properties":{"period":{"type":"number","description":"Period for the report","example":5},"accountref":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account reference (org_wallet_ref)"},"children":[]}]}]}],"example":1},"teamcode":{"type":"string","description":"Team code for filtering expenses","example":"T0012T"}},"required":["period"]}},"components/schemas/CategoryReportResponseV1Dto":{"id":"components/schemas/CategoryReportResponseV1Dto","kind":"json-schema","title":"CategoryReportResponseV1Dto","data":{"type":"object","properties":{"data":{"description":"Report data","allOf":[{"$ref":"#/components/schemas/CategoryReportDataDto"}]},"status":{"type":"number","description":"Status code","example":0},"message":{"type":"string","description":"Response message","example":"success"}},"required":["data","status","message"]}},"components/schemas/TeamCategoryReportQueryV1Dto":{"id":"components/schemas/TeamCategoryReportQueryV1Dto","kind":"json-schema","title":"TeamCategoryReportQueryV1Dto","data":{"type":"object","properties":{"period":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Period for the report. Can be a number (1-8) or string name. 1=TODAY, 2=YESTERDAY, 3=THISWEEK, 4=LASTWEEK, 5=THISMONTH, 6=LASTMONTH, 7=THISYEAR, 8=LASTYEAR"},"children":[]}]}]}],"example":5,"oneOf":[{"type":"number","minimum":1,"maximum":8},{"type":"string","enum":["1","2","3","4","5","6","7","8","TODAY","YESTERDAY","THISWEEK","LASTWEEK","THISMONTH","LASTMONTH","THISYEAR","LASTYEAR"]}]},"accountref":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account reference (org_wallet_ref). Defaults to \"1\" if not provided."},"children":[]}]}]}],"example":"1"},"teamcode":{"type":"string","description":"Team code for filtering to a specific team. Use \"all\" or omit to get all teams.","example":"T0012T"},"category":{"type":"string","description":"Category name for filtering to a specific category. If not provided, returns all categories. Note: Invalid category names are ignored and all categories are returned.","example":"Transport"}},"required":["period"]}},"components/schemas/TeamCategoryReportResponseV1Dto":{"id":"components/schemas/TeamCategoryReportResponseV1Dto","kind":"json-schema","title":"TeamCategoryReportResponseV1Dto","data":{"type":"object","properties":{"data":{"description":"Report data - structure varies based on parameters","oneOf":[{"$ref":"#/components/schemas/TeamModeDataDto"},{"$ref":"#/components/schemas/CategoryModeDataDto"},{"$ref":"#/components/schemas/SubcategoryModeDataDto"}]},"status":{"type":"number","description":"Status code","example":0},"message":{"type":"string","description":"Response message","example":"success"}},"required":["data","status","message"]}},"components/schemas/PaginatedCardResponseDto":{"id":"components/schemas/PaginatedCardResponseDto","kind":"json-schema","title":"PaginatedCardResponseDto","data":{"type":"object","properties":{"docs":{"description":"Card documents","type":"array","items":{"$ref":"#/components/schemas/CardV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateCardV1Dto":{"id":"components/schemas/CreateCardV1Dto","kind":"json-schema","title":"CreateCardV1Dto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"non mongo Employee id"},"currency":{"type":"string","description":"Card Currency","enum":["KES","USD"],"example":"KES"},"name":{"type":"string","description":"Card name"},"cardHolder":{"type":"string","description":"Cardholder name"},"isVirtualCard":{"type":"boolean","description":"Is virtual card"},"address":{"type":"string","description":"Shipping address for physical card (required when isVirtualCard is false or not provided)","example":"123 Main Street, Nairobi, Kenya"},"org_wallet_ref":{"type":"number","description":"Business wallet ref"}},"required":["employee_id","currency","name","cardHolder","org_wallet_ref"]}},"components/schemas/CardV1Dto":{"id":"components/schemas/CardV1Dto","kind":"json-schema","title":"CardV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Card MongoDB ID"},"vcn":{"type":"string","description":"Virtual card number (raw)"},"ref":{"type":"string","description":"Card reference"},"last4":{"type":"string","description":"Last 4 digits of card"},"bin":{"type":"string","description":"BIN number"},"name":{"type":"string","description":"Card name/label"},"brand":{"type":"string","description":"Card brand (VISA, Mastercard, etc.)"},"provider":{"type":"string","description":"Card provider/issuer"},"employee":{"description":"Employee details","allOf":[{"$ref":"#/components/schemas/EmployeeDto"}]},"business":{"type":"string","description":"Business ID"},"account":{"type":"string","description":"Account ID"},"user":{"type":"string","description":"User ID"},"exp_month":{"type":"string","description":"Expiration month (MM)"},"exp_year":{"type":"string","description":"Expiration year (YY or YYYY)"},"basis_fingerprint":{"type":"string","description":"Basis fingerprint for security"},"blocked":{"type":"boolean","description":"Is card blocked"},"retired":{"type":"boolean","description":"Is card retired"},"dormant":{"type":"boolean","description":"Is card dormant"},"purged":{"type":"boolean","description":"Is card purged"},"verified":{"type":"boolean","description":"Is card verified"},"is_virtual":{"type":"boolean","description":"Is virtual card"},"is_offline":{"type":"boolean","description":"Is offline card"},"physical_pin_set":{"type":"boolean","description":"Physical PIN is set"},"subscription_card":{"type":"boolean","description":"Is subscription card"},"balance":{"type":"number","description":"Current card balance"},"currency":{"type":"string","description":"Card currency"},"tracking_number":{"type":"string","description":"Card delivery tracking number"},"issued_on":{"type":"string","description":"Card issued on timestamp"},"issued_by":{"type":"string","description":"Card issued by user"},"updated_by":{"type":"string","description":"Card updated by user"},"blocked_by":{"type":"string","description":"Blocked by user ID"},"frisk":{"type":"number","description":"Risk/frisk level"},"wallet_type":{"type":"string","description":"Wallet type"},"works_only_at":{"description":"Places where card works only","type":"array","items":{"type":"string"}},"works_only_at_mid":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MID restrictions for works_only_at"},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"works_everywhere_except":{"description":"Places where card is blocked","type":"array","items":{"type":"string"}},"category_spend_limits":{"description":"Category spending limits","type":"array","items":{"type":"object"}},"events":{"description":"Card events history","type":"array","items":{"type":"object"}},"org_wallet_ref":{"type":"number","description":"Organization wallet reference"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"statusDisplay":{"type":"string","description":"Card status display name"},"typeDisplay":{"type":"string","description":"Card type display name"},"isActive":{"type":"boolean","description":"Is card active"},"isExpired":{"type":"boolean","description":"Is card expired"},"expiryFormatted":{"type":"string","description":"Formatted expiry date"},"employeeName":{"type":"string","description":"Employee name from employee object"},"employeeId":{"type":"string","description":"Employee ID from employee object"},"approval_request":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approval request object — present only for SINGLE USE PREPAID cards"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ApprovalRequestDto"}]}}}},"components/schemas/RequestSingleUseCardDto":{"id":"components/schemas/RequestSingleUseCardDto","kind":"json-schema","title":"RequestSingleUseCardDto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID of the requesting employee","example":"EMP001"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference","example":"1"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requested amount. Can be 0 for just_in_time funded cards (amount resolved when card is run)."},"children":[]}]}]}],"example":5000},"currency":{"type":"string","description":"Currency code (defaults to \"KES\")","example":"KES"},"notes":{"type":"string","description":"Notes / purpose of the card request","example":"Purchase office supplies from vendor"},"vendor_id":{"type":"string","description":"Vendor / merchant ID","example":"VND_001"},"vendor_name":{"type":"string","description":"Vendor / merchant display name","example":"Office Supplies Co."},"customer_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer ID (legacy — prefer sending the full "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object)"},"children":[]}]}]}],"example":"69dd1e56d2756bba9fa9983b"},"customer_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer display name (legacy — prefer sending the full "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object)"},"children":[]}]}]}],"example":"Giraffe Center"},"customer":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full customer object from the tenant DB. When provided, the downstream service uses this directly instead of fetching by customer_id."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/CustomerObjectDto"}]},"subcategory_id":{"type":"string","description":"Expense sub-category ID","example":"CAT_OFFICE"},"tags":{"description":"Array of expense tag objects selected by the user","example":[{"_id":"68a2de3b73b7e53060aca3df","tag_group":"68a2de0194af89ac7c37aaa9","name":"Safaricom","employee":{"customer_id":"EAA8F4AF3B1DF2EA8D45","customer_name":"Ivy Ngele ; 00111"}}],"type":"array","items":{"$ref":"#/components/schemas/TagObjectDto"}},"attachments":{"description":"Array of attachment URLs or file references","example":["https://storage.example.com/receipt.pdf"],"type":"array","items":{"type":"string"}},"requisition_reference":{"type":"string","description":"Internal requisition reference number","example":"REQ-2024-001"}},"required":["employee_id"]}},"components/schemas/CreateSingleUseCardResponseDto":{"id":"components/schemas/CreateSingleUseCardResponseDto","kind":"json-schema","title":"CreateSingleUseCardResponseDto","data":{"type":"object","properties":{"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outcome of the SUC request. AUTO_APPROVED means the card is issued immediately; PENDING_APPROVAL means it is queued for an approver."},"children":[]}]}]}],"enum":["AUTO_APPROVED","PENDING_APPROVAL"],"example":"PENDING_APPROVAL"},"ref":{"type":"string","description":"Approval / card reference","example":"O-A1B2C3D4"},"message":{"type":"string","description":"Human-readable result message","example":"Single use card request submitted successfully."}},"required":["status","ref","message"]}},"components/schemas/CardBalanceDto":{"id":"components/schemas/CardBalanceDto","kind":"json-schema","title":"CardBalanceDto","data":{"type":"object","properties":{"cardId":{"type":"string","description":"Card ID"},"availableBalance":{"type":"number","description":"Available balance"},"currentBalance":{"type":"number","description":"Current balance"},"pendingAmount":{"type":"number","description":"Pending transactions amount"},"currency":{"type":"string","description":"Currency code"},"lastUpdated":{"type":"string","description":"Last balance update timestamp"}}}},"components/schemas/PaginatedPhysicalCardOrderResponseDto":{"id":"components/schemas/PaginatedPhysicalCardOrderResponseDto","kind":"json-schema","title":"PaginatedPhysicalCardOrderResponseDto","data":{"type":"object","properties":{"docs":{"type":"array","items":{"$ref":"#/components/schemas/PhysicalCardOrderV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/ApprovePhysicalCardOrdersDto":{"id":"components/schemas/ApprovePhysicalCardOrdersDto","kind":"json-schema","title":"ApprovePhysicalCardOrdersDto","data":{"type":"object","properties":{"order_ids":{"description":"Array of physical card order IDs to approve","example":["6737397bcd9b059fff307ada","6734a7a4f52ba5a69f8e722e"],"type":"array","items":{"type":"string"}},"notes":{"type":"string","description":"Optional approval notes","example":"Approved for production and shipping"}},"required":["order_ids"]}},"components/schemas/RejectPhysicalCardOrdersDto":{"id":"components/schemas/RejectPhysicalCardOrdersDto","kind":"json-schema","title":"RejectPhysicalCardOrdersDto","data":{"type":"object","properties":{"order_ids":{"description":"Array of physical card order IDs to reject","example":["6737397bcd9b059fff307ada"],"type":"array","items":{"type":"string"}},"notes":{"type":"string","description":"Required rejection notes explaining the reason","example":"Rejected due to incomplete employee information"}},"required":["order_ids","notes"]}},"components/schemas/AuthorizeBTSessionDto":{"id":"components/schemas/AuthorizeBTSessionDto","kind":"json-schema","title":"AuthorizeBTSessionDto","data":{"type":"object","properties":{"nonce":{"type":"string","description":"Nonce value for BT session authorization","example":"abc123def456"},"vcn":{"type":"string","description":"Virtual Card Number (VCN) for authorization","example":"4532123456789012"}},"required":["nonce","vcn"]}},"components/schemas/CardFingerprintDto":{"id":"components/schemas/CardFingerprintDto","kind":"json-schema","title":"CardFingerprintDto","data":{"type":"object","properties":{}}},"components/schemas/PaginatedApprovalsResponseDto":{"id":"components/schemas/PaginatedApprovalsResponseDto","kind":"json-schema","title":"PaginatedApprovalsResponseDto","data":{"type":"object","properties":{"docs":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalDto"}},"page":{"type":"number","example":1},"limit":{"type":"number","example":10}},"required":["docs","page","limit"]}},"components/schemas/PaginatedApprovalsDigestResponseDto":{"id":"components/schemas/PaginatedApprovalsDigestResponseDto","kind":"json-schema","title":"PaginatedApprovalsDigestResponseDto","data":{"type":"object","properties":{"docs":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalContextDto"}},"page":{"type":"number","example":1},"limit":{"type":"number","example":100}},"required":["docs","page","limit"]}},"components/schemas/ApprovePaymentRequestDto":{"id":"components/schemas/ApprovePaymentRequestDto","kind":"json-schema","title":"ApprovePaymentRequestDto","data":{"type":"object","properties":{"ref":{"type":"string","description":"Payment request reference identifier","example":"Yl280oi1p0g0"}},"required":["ref"]}},"components/schemas/RejectPaymentRequestDto":{"id":"components/schemas/RejectPaymentRequestDto","kind":"json-schema","title":"RejectPaymentRequestDto","data":{"type":"object","properties":{"ref":{"type":"string","description":"Payment request reference identifier","example":"bmZbgYGlg116"},"reason":{"type":"string","description":"Required reason for rejecting the payment request","example":"Insufficient documentation provided"}},"required":["ref","reason"]}},"components/schemas/RejectBillPaymentDto":{"id":"components/schemas/RejectBillPaymentDto","kind":"json-schema","title":"RejectBillPaymentDto","data":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for rejecting the bill payment","example":"test"}},"required":["reason"]}},"components/schemas/PaginatedResponseDto":{"id":"components/schemas/PaginatedResponseDto","kind":"json-schema","title":"PaginatedResponseDto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"description":"Response data","allOf":[{"$ref":"#/components/schemas/PaginatedDataDto"}]},"message":{"type":"string","description":"Optional response message","example":"Operation completed successfully"},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2024-01-01T00:00:00.000Z"},"path":{"type":"string","description":"Request path (mainly for error responses)","example":"/api/v1/accounts"}},"required":["status","data","timestamp"]}},"components/schemas/ErrorResponseDto":{"id":"components/schemas/ErrorResponseDto","kind":"json-schema","title":"ErrorResponseDto","data":{"type":"object","properties":{"status":{"type":"number","description":"Error status code","example":200},"data":{"type":"object","description":"Additional error data","example":null},"message":{"type":"string","description":"Error message","example":"Resource not found"},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2024-01-01T00:00:00.000Z"},"path":{"type":"string","description":"Request path where error occurred","example":"/api/v1/accounts/123"}},"required":["status","data","timestamp"]}},"components/schemas/CreateAccountV1Dto":{"id":"components/schemas/CreateAccountV1Dto","kind":"json-schema","title":"CreateAccountV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Account name"},"employeeId":{"type":"string","description":"Employee ID"},"currency":{"type":"string","description":"Currency code"},"isPersonal":{"type":"boolean","description":"Is personal account"},"isDefault":{"type":"boolean","description":"Is default account"},"businessId":{"type":"string","description":"Business ID"},"featureFlags":{"description":"Feature flags","type":"array","items":{"type":"string"}},"employeeTopupAllowed":{"type":"boolean","description":"Employee topup allowed"}},"required":["name","employeeId"]}},"components/schemas/BaseResponseDto":{"id":"components/schemas/BaseResponseDto","kind":"json-schema","title":"BaseResponseDto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"type":"object","description":"Response data"},"message":{"type":"string","description":"Optional response message","example":"Operation completed successfully"},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2024-01-01T00:00:00.000Z"},"path":{"type":"string","description":"Request path (mainly for error responses)","example":"/api/v1/accounts"}},"required":["status","data","timestamp"]}},"components/schemas/BusinessCurrencyV1Dto":{"id":"components/schemas/BusinessCurrencyV1Dto","kind":"json-schema","title":"BusinessCurrencyV1Dto","data":{"type":"object","properties":{"id":{"type":"number","description":"Unique identifier for the wallet reference","example":1},"currency":{"type":"string","description":"Currency code (ISO 4217)","example":"KES"},"created_on":{"type":"string","description":"ISO 8601 timestamp when the record was created","example":"2021-07-02T14:15:16.000Z"},"updated_on":{"type":"string","description":"ISO 8601 timestamp when the record was last updated","example":"2021-07-02T14:15:49.000Z"},"created_by":{"type":"string","description":"ID of the user who created this record","example":"kwvnakwoppmeuzmitjkkaqcuvqoajv"}},"required":["id","currency","created_on","updated_on"]}},"components/schemas/CreateCurrencyV1Dto":{"id":"components/schemas/CreateCurrencyV1Dto","kind":"json-schema","title":"CreateCurrencyV1Dto","data":{"type":"object","properties":{"currency":{"type":"string","description":"ISO 4217 currency code (uppercase, 3 letters)","example":"USD"}},"required":["currency"]}},"components/schemas/AddAccountV1Dto":{"id":"components/schemas/AddAccountV1Dto","kind":"json-schema","title":"AddAccountV1Dto","data":{"type":"object","properties":{"currency":{"type":"string","description":"ISO 4217 currency code (uppercase, 3 letters)","example":"USD"},"walletType":{"type":"string","description":"Wallet type to create","enum":["PETTYCASH","MAIN","SUBSCRIPTION-WALLET"],"example":"PETTYCASH"},"name":{"type":"string","description":"Human-readable account name shown to the user","example":"KES Petty Cash"},"description":{"type":"string","description":"Optional account description (max 200 characters). Falls back to walletType when omitted.","example":"Daily operating expenses"},"owners":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Owners list (employee ids) — optional, defaults to empty list"},"children":[]}]}]}],"type":"array","items":{"type":"string"}}},"required":["currency","walletType","name"]}},"components/schemas/AddAccountResponseV1Dto":{"id":"components/schemas/AddAccountResponseV1Dto","kind":"json-schema","title":"AddAccountResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Whether the operation succeeded","example":true},"message":{"type":"string","description":"Human-readable status message","example":"Account created successfully"},"currencyCreated":{"type":"boolean","description":"Whether a new currency record was provisioned as part of this request","example":false},"wallet":{"type":"object","description":"Created wallet payload returned by the upstream wallets service","example":{"_id":"64f1c2a5e2e2a9001f3b8e7c","walletId":"123456","wallet_type":"PETTYCASH","currency":"USD","org_wallet_ref":"2","description":"Daily operating expenses"}}},"required":["status","message","currencyCreated","wallet"]}},"components/schemas/CashflowReportResponseV1Dto":{"id":"components/schemas/CashflowReportResponseV1Dto","kind":"json-schema","title":"CashflowReportResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"description":"Cashflow report data","allOf":[{"$ref":"#/components/schemas/CashflowReportDataDto"}]},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2026-05-15T10:00:00Z"}},"required":["status","data","timestamp"]}},"components/schemas/AccountV1Dto":{"id":"components/schemas/AccountV1Dto","kind":"json-schema","title":"AccountV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Account MongoDB ID"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"description":{"type":"string","description":"Account description"},"name":{"type":"string","description":"Account name"},"walletId":{"type":"string","description":"Wallet ID"},"boya_accno":{"type":"string","description":"Boya account number"},"availableBalance":{"type":"number","description":"Available balance for spending"},"currentBalance":{"type":"number","description":"Current account balance"},"reservations":{"description":"Reserved amounts","type":"array","items":{"$ref":"#/components/schemas/ReservationDto"}},"owners":{"description":"Account owners with roles","type":"array","items":{"$ref":"#/components/schemas/OwnerDto"}},"employees_allowed_to_make_payments":{"description":"Employees allowed to make payments","type":"array","items":{"type":"string"}},"alert_contacts":{"description":"Alert contacts for account notifications","type":"array","items":{"$ref":"#/components/schemas/AlertContactDto"}},"status":{"type":"string","description":"Account status","enum":["ACTIVE","INACTIVE","SUSPENDED","CLOSED","BARRED"]},"wallet_type":{"type":"string","description":"Wallet type","enum":["POOLFLOAT","REVENUE","MAIN","SINGLE-WALLET","PAYABLES","RECEIVABLES","PETTYCASH","EMPLOYEE-WALLET","SUBSCRIPTION-WALLET","BUDGET-WALLET","TEAM-WALLET","OVERDRAFT","INVESTMENT-WALLET","FIXED-DEPOSIT","CREDITLINE"]},"business_id":{"type":"string","description":"Business ID"},"employee_id":{"type":"string","description":"Employee ID (for employee wallets)"},"team":{"type":"string","description":"Team ID (for team wallets)"},"currency":{"type":"string","description":"Account currency (USD/KES)"},"is_child":{"type":"boolean","description":"Is child account flag"},"configuration":{"description":"Account configuration settings","type":"array","items":{"$ref":"#/components/schemas/ConfigurationDto"}},"rules":{"description":"Business rules applied to account","type":"array","items":{"$ref":"#/components/schemas/RuleDto"}},"outbound_channels":{"description":"Available outbound payment channels","type":"array","items":{"type":"string"}},"isBankAccount":{"type":"boolean","description":"Is linked to bank account"},"bank":{"description":"Bank account details","allOf":[{"$ref":"#/components/schemas/BankInfoDto"}]},"depositInstructions":{"description":"Deposit instructions for funding this account","allOf":[{"$ref":"#/components/schemas/DepositInstructionsDto"}]},"overdraftLimit":{"type":"number","description":"Overdraft limit amount"},"overdraftWallet":{"type":"object","description":"Overdraft wallet reference"},"usedOverdraft":{"type":"number","description":"Currently used overdraft amount"},"overdraftAccessChannel":{"type":"string","description":"Overdraft access channel","enum":["BOYA","TABB","BANK"]},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"accountNumber":{"type":"string","description":"Account number field (legacy)"},"computedPermissions":{"description":"Policy-computed permission flags for this wallet","allOf":[{"$ref":"#/components/schemas/ComputedPermissionsDto"}]}}}},"components/schemas/CreateTransactionV1Dto":{"id":"components/schemas/CreateTransactionV1Dto","kind":"json-schema","title":"CreateTransactionV1Dto","data":{"type":"object","properties":{"amount":{"type":"number","description":"Transaction amount"},"currency":{"type":"string","description":"Currency code (e.g., USD, EUR)"},"paymentType":{"type":"string","description":"Payment type"},"receiverName":{"type":"string","description":"Receiver name"},"receiver":{"type":"string","description":"Receiver"},"category":{"type":"string","description":"Category"},"description":{"type":"string","description":"Description"},"accountNumber":{"type":"string","description":"Account number"},"bankCode":{"type":"string","description":"Bank code"},"note":{"type":"string","description":"Notes"},"budgetId":{"type":"string","description":"Budget ID"},"budgetCategoryIds":{"description":"Budget category IDs","type":"array","items":{"type":"string"}}},"required":["amount","currency","receiverName"]}},"components/schemas/TransactionDto":{"id":"components/schemas/TransactionDto","kind":"json-schema","title":"TransactionDto","data":{"type":"object","properties":{"id":{"type":"number","description":"Local ID"},"remoteId":{"type":"number","description":"Remote ID"},"source":{"type":"string","description":"Transaction source"},"paymentType":{"type":"string","description":"Payment type"},"group":{"type":"string","description":"Group"},"amount":{"type":"number","description":"Transaction amount"},"fee":{"type":"number","description":"Transaction fee"},"fees":{"type":"number","description":"Transaction fees"},"currency":{"type":"string","description":"Currency code"},"accountNumber":{"type":"string","description":"Account number"},"note":{"type":"string","description":"Notes"},"tag":{"type":"string","description":"Tag"},"tagId":{"type":"string","description":"Tag ID"},"category":{"type":"string","description":"Category"},"categoryId":{"type":"string","description":"Category ID"},"beneficiary":{"type":"string","description":"Beneficiary"},"team":{"type":"string","description":"Team"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"uid":{"type":"string","description":"UID"},"customerId":{"type":"string","description":"Customer ID"},"stripeCustomerId":{"type":"string","description":"Stripe customer ID"},"ticket":{"type":"string","description":"Ticket"},"description":{"type":"string","description":"Description"},"receiverName":{"type":"string","description":"Receiver name"},"receiver":{"type":"string","description":"Receiver"},"ref":{"type":"string","description":"Reference"},"reference":{"type":"string","description":"Reference"},"txRef":{"type":"string","description":"Transaction reference"},"bankCode":{"type":"string","description":"Bank code"},"sms":{"type":"string","description":"SMS"},"providerRef":{"type":"string","description":"Provider reference"},"receipt":{"type":"string","description":"Physical receipt URL"},"otherReceipts":{"type":"string","description":"Other receipts URLs"},"isPaymentRequest":{"type":"boolean","description":"Is payment request"},"isInitial":{"type":"boolean","description":"Is initial transaction"},"timestamp":{"type":"string","description":"Timestamp"},"createdAt":{"type":"string","description":"Created timestamp"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status (0=pending, 1=success, 2=failed, 3=cancelled)"},"children":[]}]}]}]},"reviewStatus":{"type":"string","description":"Review status"},"reviewLevel":{"type":"number","description":"Review level"},"expenseTags":{"description":"Expense tags","type":"array","items":{"$ref":"#/components/schemas/ExpenseTagDto"}},"expenseId":{"type":"string","description":"Expense ID"},"client":{"type":"string","description":"Client"},"clientId":{"type":"string","description":"Client ID"},"vendor":{"type":"string","description":"Vendor"},"vendorId":{"type":"string","description":"Vendor ID"},"requisitionReference":{"type":"string","description":"Requisition reference"},"expiryDate":{"type":"string","description":"Expiry date"},"walletId":{"type":"string","description":"Wallet ID"},"budgetId":{"type":"string","description":"Budget ID"},"budgetName":{"type":"string","description":"Budget name"},"budgetLineItems":{"description":"Budget line items","type":"array","items":{"type":"string"}},"budgetCategoryIds":{"description":"Budget category IDs","type":"array","items":{"type":"string"}}}}},"components/schemas/MoneyMovementResponseV1Dto":{"id":"components/schemas/MoneyMovementResponseV1Dto","kind":"json-schema","title":"MoneyMovementResponseV1Dto","data":{"type":"object","properties":{"data":{"description":"Money movement analytics data","allOf":[{"$ref":"#/components/schemas/MoneyMovementDataDto"}]}},"required":["data"]}},"components/schemas/PaginatedTransactionResponseDto":{"id":"components/schemas/PaginatedTransactionResponseDto","kind":"json-schema","title":"PaginatedTransactionResponseDto","data":{"type":"object","properties":{"docs":{"description":"Transaction documents","type":"array","items":{"$ref":"#/components/schemas/TransactionV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/TagTransactionDto":{"id":"components/schemas/TagTransactionDto","kind":"json-schema","title":"TagTransactionDto","data":{"type":"object","properties":{"subcategoryId":{"type":"string","description":"Subcategory ID to assign (MongoDB ObjectId)","example":"64ec5b4bffaef6ff2a28455d"}},"required":["subcategoryId"]}},"components/schemas/TransactionV1Dto":{"id":"components/schemas/TransactionV1Dto","kind":"json-schema","title":"TransactionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Transaction MongoDB ID"},"currency":{"type":"string","description":"Transaction currency (USD/KES)"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"account":{"type":"string","description":"Account number"},"credit":{"type":"number","description":"Credit amount"},"counter":{"type":"number","description":"Transaction counter"},"debit":{"type":"number","description":"Debit amount"},"description":{"type":"string","description":"Transaction description"},"ref":{"type":"string","description":"Transaction reference"},"created_by":{"type":"string","description":"Created by user ID"},"transaction_type":{"type":"string","description":"Transaction type","enum":["IFT","EXPENSE","TOPUP","REFUND","INTERNAL TRANSFER","OVERDRAFT","REPAYMENT","BRANCH TRANSFER"]},"ift":{"description":"IFT transaction details","allOf":[{"$ref":"#/components/schemas/IftDto"}]},"expense":{"description":"Expense transaction details","allOf":[{"$ref":"#/components/schemas/ExpenseV1Dto"}]},"topup":{"description":"Topup transaction details","allOf":[{"$ref":"#/components/schemas/TopupDto"}]},"refund":{"description":"Refund transaction details","allOf":[{"$ref":"#/components/schemas/RefundDto"}]},"running_balance":{"type":"number","description":"Running account balance"},"business_running_balance":{"type":"number","description":"Business running balance"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"id":{"type":"string","description":"Auto-generated ID field"}}}},"components/schemas/UploadSupportingDocumentDto":{"id":"components/schemas/UploadSupportingDocumentDto","kind":"json-schema","title":"UploadSupportingDocumentDto","data":{"type":"object","properties":{"transactionRef":{"type":"string","description":"Transaction reference (used in S3 key generation)","example":"M-G2026001234"},"transactionId":{"type":"string","description":"Transaction ID (MongoDB ObjectId)","example":"64ec5b4bffaef6ff2a28455d"},"contentType":{"type":"string","description":"MIME content type of the document","enum":["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","application/pdf","application/vnd.openxmlformats-officedocument.wordprocessingml.document","text/csv","image/png","image/jpeg"],"example":"application/pdf"},"fileContent":{"type":"string","description":"Base64-encoded file content (with or without data URI prefix)","example":"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC..."}},"required":["contentType","fileContent"]}},"components/schemas/UploadSupportingDocumentResponseDto":{"id":"components/schemas/UploadSupportingDocumentResponseDto","kind":"json-schema","title":"UploadSupportingDocumentResponseDto","data":{"type":"object","properties":{"url":{"type":"string","description":"The S3 URL of the uploaded document","example":"https://supporting-docs-bucket.s3.eu-west-1.amazonaws.com/transactions/64ec5b4bffaef6ff2a28455d/TXN-2026-001234-1705766400000.pdf"},"transactionId":{"type":"string","description":"The transaction ID the document was uploaded for","example":"64ec5b4bffaef6ff2a28455d"},"transactionRef":{"type":"string","description":"The transaction reference","example":"TXN-2026-001234"},"contentType":{"type":"string","description":"The content type of the uploaded document","example":"application/pdf"}},"required":["url","transactionId","contentType"]}},"components/schemas/RemoveDocumentDto":{"id":"components/schemas/RemoveDocumentDto","kind":"json-schema","title":"RemoveDocumentDto","data":{"type":"object","properties":{"transactionId":{"type":"string","description":"Transaction ID"},"attachment":{"type":"string","description":"Attachment URL to remove"}},"required":["attachment"]}},"components/schemas/PaginatedCategoryResponseDto":{"id":"components/schemas/PaginatedCategoryResponseDto","kind":"json-schema","title":"PaginatedCategoryResponseDto","data":{"type":"object","properties":{"docs":{"description":"Category documents","type":"array","items":{"$ref":"#/components/schemas/CategoryV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateCategoryV1Dto":{"id":"components/schemas/CreateCategoryV1Dto","kind":"json-schema","title":"CreateCategoryV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Category name","example":"Office Expenses"},"description":{"type":"string","description":"Category description","example":"Office Expenses"}},"required":["name","description"]}},"components/schemas/CategoryV1Dto":{"id":"components/schemas/CategoryV1Dto","kind":"json-schema","title":"CategoryV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Category MongoDB ID"},"groupid":{"type":"string","description":"Group ID"},"name":{"type":"string","description":"Category name"},"description":{"type":"string","description":"Category description"},"subcategories":{"description":"Subcategories array","type":"array","items":{"$ref":"#/components/schemas/SubcategoryV1Dto"}},"status":{"type":"string","description":"Category status","enum":["ACTIVE","ARCHIVED"]},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/UpdateCategoryV1Dto":{"id":"components/schemas/UpdateCategoryV1Dto","kind":"json-schema","title":"UpdateCategoryV1Dto","data":{"type":"object","properties":{"groupid":{"type":"string","description":"Group ID","example":"5"},"name":{"type":"string","description":"Category name","example":"Office Expenses"},"description":{"type":"string","description":"Category description","example":"Office Expenses"}}}},"components/schemas/BulkCreateCategoryV1Dto":{"id":"components/schemas/BulkCreateCategoryV1Dto","kind":"json-schema","title":"BulkCreateCategoryV1Dto","data":{"type":"object","properties":{"items":{"description":"Array of category/subcategory items to create","example":[{"category":"Office Expenses","subcategory":"Water Bill","code":"405034","description":"Water bill"},{"category":"Office Expenses","subcategory":"Rent","code":"405035","description":"HQ RENT"}],"type":"array","items":{"$ref":"#/components/schemas/BulkCreateCategoryItemV1Dto"}}},"required":["items"]}},"components/schemas/BulkCreateCategoryResponseV1Dto":{"id":"components/schemas/BulkCreateCategoryResponseV1Dto","kind":"json-schema","title":"BulkCreateCategoryResponseV1Dto","data":{"type":"object","properties":{"categories":{"description":"Array of created categories with their subcategories","type":"array","items":{"$ref":"#/components/schemas/CategoryV1Dto"}},"totalCategories":{"type":"number","description":"Total number of categories created","example":2},"totalSubcategories":{"type":"number","description":"Total number of subcategories created","example":5},"message":{"type":"string","description":"Response message","example":"Successfully created 2 categories and 5 subcategories"}}}},"components/schemas/PaginatedSubcategoryResponseDto":{"id":"components/schemas/PaginatedSubcategoryResponseDto","kind":"json-schema","title":"PaginatedSubcategoryResponseDto","data":{"type":"object","properties":{"docs":{"description":"Subcategory documents","type":"array","items":{"$ref":"#/components/schemas/SubcategoryV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateSubcategoryV1Dto":{"id":"components/schemas/CreateSubcategoryV1Dto","kind":"json-schema","title":"CreateSubcategoryV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Subcategory name","example":"Water Bill"},"description":{"type":"string","description":"Subcategory description","example":"Water bill expenses"},"code":{"type":"string","description":"Subcategory code","example":"405034"},"teams":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Restricted to teams[_ids]"},"children":[]}]}]}],"example":"[team_oid]","type":"array","items":{"type":"string"}}},"required":["name","description"]}},"components/schemas/SubcategoryV1Dto":{"id":"components/schemas/SubcategoryV1Dto","kind":"json-schema","title":"SubcategoryV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Subcategory MongoDB ID"},"group_id":{"type":"string","description":"Group ID"},"category":{"type":"string","description":"Parent category ID"},"code":{"type":"string","description":"Subcategory code"},"name":{"type":"string","description":"Subcategory name"},"description":{"type":"string","description":"Subcategory description"},"status":{"type":"string","description":"Subcategory status","enum":["ACTIVE","ARCHIVED"]},"teams":{"description":"Team IDs array","type":"array","items":{"type":"array"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"mapping_id":{"type":"string","description":"Mapping ID"},"icon":{"type":"string","description":"Icon"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/UpdateSubcategoryV1Dto":{"id":"components/schemas/UpdateSubcategoryV1Dto","kind":"json-schema","title":"UpdateSubcategoryV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Subcategory name","example":"Water Bill"},"description":{"type":"string","description":"Subcategory description","example":"Water bill expenses"},"code":{"type":"string","description":"Subcategory code","example":"405034"},"status":{"type":"string","description":"Subcategory status","enum":["ACTIVE","ARCHIVED"],"example":"ACTIVE"}}}},"components/schemas/PaginatedTeamResponseDto":{"id":"components/schemas/PaginatedTeamResponseDto","kind":"json-schema","title":"PaginatedTeamResponseDto","data":{"type":"object","properties":{"docs":{"description":"Team documents","type":"array","items":{"type":"array"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateTeamV1Dto":{"id":"components/schemas/CreateTeamV1Dto","kind":"json-schema","title":"CreateTeamV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Team name"},"email":{"type":"string","description":"Team email"},"phone":{"type":"string","description":"Team phone"},"code":{"type":"string","description":"Team code"}},"required":["name"]}},"components/schemas/TeamV1Dto":{"id":"components/schemas/TeamV1Dto","kind":"json-schema","title":"TeamV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Team MongoDB ID"},"name":{"type":"string","description":"Team name"},"status":{"type":"string","description":"Team status (ACTIVE/INACTIVE)"},"email":{"type":"string","description":"Team email"},"phone":{"type":"string","description":"Team phone"},"reviewers":{"description":"Team reviewers","type":"array","items":{"$ref":"#/components/schemas/TeamReviewerDto"}},"code":{"type":"string","description":"Team code"},"createdAt":{"type":"string","description":"Created timestamp"},"__v":{"type":"number","description":"Version key"},"updatedAt":{"type":"string","description":"Updated timestamp"},"updated_by":{"type":"string","description":"Updated by user ID"},"alerts":{"description":"Alert configurations","type":"array","items":{"$ref":"#/components/schemas/TeamAlertDto"}},"budget":{"description":"Budget allocations","type":"array","items":{"$ref":"#/components/schemas/TeamBudgetDto"}},"limit":{"description":"Spending limits","type":"array","items":{"$ref":"#/components/schemas/TeamLimitDto"}},"batching_enabled":{"type":"boolean","description":"Batching enabled flag"},"employee_count":{"type":"number","description":"Number of employees in team"},"total_balances":{"description":"Total balances by currency","type":"array","items":{"$ref":"#/components/schemas/TeamBalanceDto"}},"team_wallets":{"description":"Associated team wallets","type":"array","items":{"$ref":"#/components/schemas/TeamWalletDto"}},"employees":{"description":"Employees in team","type":"array","items":{"$ref":"#/components/schemas/EmployeeV1Dto"}},"id":{"type":"string","description":"Auto-generated ID"}}}},"components/schemas/UpdateTeamV1Dto":{"id":"components/schemas/UpdateTeamV1Dto","kind":"json-schema","title":"UpdateTeamV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Team name"},"email":{"type":"string","description":"Team email"},"phone":{"type":"string","description":"Team phone"},"code":{"type":"string","description":"Team code"},"limit":{"description":"Spending limits","type":"array","items":{"type":"string"}}},"required":["name"]}},"components/schemas/PaginatedEmployeeResponseDto":{"id":"components/schemas/PaginatedEmployeeResponseDto","kind":"json-schema","title":"PaginatedEmployeeResponseDto","data":{"type":"object","properties":{"docs":{"description":"Employee documents","type":"array","items":{"type":"array"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateEmployeeV1Dto":{"id":"components/schemas/CreateEmployeeV1Dto","kind":"json-schema","title":"CreateEmployeeV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Employee name"},"organization_email":{"type":"string","description":"Organization email"},"personal_email":{"type":"string","description":"Personal email"},"phone":{"type":"string","description":"Phone number"},"status":{"type":"object","description":"Employee status"},"role":{"type":"object","description":"Employee role"},"is_director":{"type":"boolean","description":"Is director"},"team_code":{"type":"string","description":"Team Code"},"supervisor":{"type":"string","description":"Supervisor ID"},"external_id":{"type":"string","description":"External ID"},"tags":{"description":"Employee tags","type":"array","items":{"type":"string"}},"invited_on":{"type":"string","description":"Invited on date"},"access_expiry_date":{"type":"object","description":"Employee access expiry date"}},"required":["name","organization_email"]}},"components/schemas/EmployeeV1Dto":{"id":"components/schemas/EmployeeV1Dto","kind":"json-schema","title":"EmployeeV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Employee MongoDB ID"},"name":{"type":"string","description":"Employee name"},"employee_id":{"type":"string","description":"Employee ID"},"user":{"type":"string","description":"User ID"},"wallets":{"description":"Employee wallets","type":"array","items":{"$ref":"#/components/schemas/EmployeeWalletDto"}},"business":{"type":"string","description":"Business ID"},"invited_on":{"type":"string","description":"Invited on date"},"organization_email":{"type":"string","description":"Organization email"},"phone":{"type":"string","description":"Phone number"},"email_verified":{"type":"boolean","description":"Email verified flag"},"status":{"type":"string","description":"Employee status (ACTIVE/INACTIVE)"},"role":{"type":"string","description":"Employee role"},"is_director":{"type":"boolean","description":"Is director flag"},"consent_pending":{"type":"boolean","description":"Consent pending flag"},"cards":{"description":"Associated cards","type":"array","items":{"type":"string"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"permissions":{"description":"Employee permissions","allOf":[{"$ref":"#/components/schemas/EmployeePermissionsDto"}]},"last_login_at":{"type":"string","description":"Last login timestamp"},"team":{"description":"Employee team","allOf":[{"$ref":"#/components/schemas/EmployeeTeamDto"}]},"notification_preferences":{"description":"Notification preferences","type":"array","items":{"type":"string"}},"tags":{"description":"Employee tags","type":"array","items":{"type":"string"}},"supervisor":{"type":"string","description":"Supervisor ID"},"external_id":{"type":"string","description":"External ID"},"id":{"type":"string","description":"Auto-generated ID"}}}},"components/schemas/EmployeeBalanceDto":{"id":"components/schemas/EmployeeBalanceDto","kind":"json-schema","title":"EmployeeBalanceDto","data":{"type":"object","properties":{"walletId":{"type":"string","description":"Wallet ID"},"accno":{"type":"string","description":"Account number"},"currency":{"type":"string","description":"Currency code"},"availableBalance":{"type":"number","description":"Available balance"},"walletType":{"type":"string","description":"Wallet type"}}}},"components/schemas/PaginatedStatementResponseDto":{"id":"components/schemas/PaginatedStatementResponseDto","kind":"json-schema","title":"PaginatedStatementResponseDto","data":{"type":"object","properties":{"docs":{"description":"Statement transaction documents","type":"array","items":{"$ref":"#/components/schemas/StatementItemDto"}},"total":{"type":"number","description":"Total count"},"page":{"type":"number","description":"Current page"},"limit":{"type":"number","description":"Limit per page"},"pages":{"type":"number","description":"Total pages"}},"required":["docs","total","page","limit","pages"]}},"components/schemas/ReviewerManagementV1Dto":{"id":"components/schemas/ReviewerManagementV1Dto","kind":"json-schema","title":"ReviewerManagementV1Dto","data":{"type":"object","properties":{"teamId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Team ID (MongoDB _id)"},"children":[]}]}]}],"example":"64ec5b57ffaef6ff2a2845b3"},"employee_id":{"type":"string","description":"Employee ID","example":"240640D10936B6FECC75A2CC"}},"required":["teamId","employee_id"]}},"components/schemas/MoveEmployeeToTeamV1Dto":{"id":"components/schemas/MoveEmployeeToTeamV1Dto","kind":"json-schema","title":"MoveEmployeeToTeamV1Dto","data":{"type":"object","properties":{"team_code":{"type":"string","description":"Team code to move the employee to","example":"0003"},"employee_id":{"type":"string","description":"Employee ID to be moved","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"max_spend_per_period":{"type":"string","description":"Maximum spend per period (optional)","example":"5000"}},"required":["team_code","employee_id"]}},"components/schemas/UpdateProfileV1Dto":{"id":"components/schemas/UpdateProfileV1Dto","kind":"json-schema","title":"UpdateProfileV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Employee name","example":"Rob"},"employee_id":{"type":"string","description":"Employee ID","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"email":{"type":"string","description":"Employee email","example":"rob@example.com"},"phone":{"type":"string","description":"Employee phone number (international format)","example":"+1-555-0123"},"tags":{"description":"Employee tags (array of tag IDs)","example":["68cbd72f0e3b38101f9e8bfd"],"type":"array","items":{"type":"string"}}},"required":["name","employee_id","email","phone"]}},"components/schemas/ActivateEmployeeV1Dto":{"id":"components/schemas/ActivateEmployeeV1Dto","kind":"json-schema","title":"ActivateEmployeeV1Dto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID","example":"BEE1209FF82BD720008D8262"}},"required":["employee_id"]}},"components/schemas/TransferOwnershipV1Dto":{"id":"components/schemas/TransferOwnershipV1Dto","kind":"json-schema","title":"TransferOwnershipV1Dto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the existing employee to transfer ownership from. Either employee_id or external_id is required."},"children":[]}]}]}],"example":"abc123xyz"},"external_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"External employee ID (alternative identifier). Either employee_id or external_id is required."},"children":[]}]}]}],"example":"ext-456"},"name":{"type":"string","description":"Full name of the new employee taking ownership","example":"John Mwangi"},"email":{"type":"string","description":"Email address of the new employee. Must not be in use by any active user.","example":"john.mwangi@company.com"},"phone":{"type":"string","description":"Phone number of the new employee in international format. Must not be in use by any active user.","example":"+254798765432"},"new_status":{"type":"string","description":"Status to set on the old employee record after the transfer completes. Defaults to SUSPENDED.","example":"SUSPENDED","enum":["SUSPENDED","DELETED"],"default":"SUSPENDED"}},"required":["name","email","phone"]}},"components/schemas/TransferOwnershipResponseV1Dto":{"id":"components/schemas/TransferOwnershipResponseV1Dto","kind":"json-schema","title":"TransferOwnershipResponseV1Dto","data":{"type":"object","properties":{"new_employee_id":{"type":"string","description":"Employee ID of the newly created employee","example":"xyz789abc123"},"old_employee_status":{"type":"string","description":"Status that was applied to the old employee record","example":"SUSPENDED","enum":["SUSPENDED","DELETED"]}},"required":["new_employee_id","old_employee_status"]}},"components/schemas/AllocateFundsV1Dto":{"id":"components/schemas/AllocateFundsV1Dto","kind":"json-schema","title":"AllocateFundsV1Dto","data":{"type":"object","properties":{"source_wallet":{"type":"string","description":"source wallet id","default":1,"example":1},"destination_wallet":{"type":"string","description":"source wallet id","default":1,"example":1},"amount":{"type":"number","description":"Amount to allocate/remove (in smallest currency unit)","example":5000},"description":{"type":"string","description":"Transaction description","example":"Monthly allowance allocation"},"employee_id":{"type":"string","description":"Target employee identifier","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"}},"required":["source_wallet","destination_wallet","amount","employee_id"]}},"components/schemas/DeductFundsV1Dto":{"id":"components/schemas/DeductFundsV1Dto","kind":"json-schema","title":"DeductFundsV1Dto","data":{"type":"object","properties":{"destination_wallet":{"type":"string","description":"destination wallet id","default":1,"example":1},"source_wallet":{"type":"string","description":"source wallet id","default":1,"example":1},"amount":{"type":"number","description":"Amount to deduct (in smallest currency unit)","example":5000},"description":{"type":"string","description":"Transaction description","example":"Monthly allowance allocation"},"employee_id":{"type":"string","description":"Target employee identifier","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"}},"required":["destination_wallet","source_wallet","amount","employee_id"]}},"components/schemas/PermissionResponseV1Dto":{"id":"components/schemas/PermissionResponseV1Dto","kind":"json-schema","title":"PermissionResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"description":"Array of permission role objects","type":"array","items":{"$ref":"#/components/schemas/PermissionV1Dto"}},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2026-01-08T12:07:27.605Z"}},"required":["status","timestamp"]}},"components/schemas/UpdateUserRoleV1Dto":{"id":"components/schemas/UpdateUserRoleV1Dto","kind":"json-schema","title":"UpdateUserRoleV1Dto","data":{"type":"object","properties":{"role":{"type":"string","description":"User role","enum":["CARD USER","APPROVER","ADMIN","REVIEWER","SUPER ADMIN","AUDITOR"],"example":"APPROVER"}},"required":["role"]}},"components/schemas/UpdateUsersRoleResponseV1Dto":{"id":"components/schemas/UpdateUsersRoleResponseV1Dto","kind":"json-schema","title":"UpdateUsersRoleResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"description":"Response data containing database name and permissions","allOf":[{"$ref":"#/components/schemas/UpdateUsersRoleDataV1Dto"}]},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2026-01-09T08:18:46.794Z"}},"required":["status","timestamp"]}},"components/schemas/UpdateEmployeePermissionsV1Dto":{"id":"components/schemas/UpdateEmployeePermissionsV1Dto","kind":"json-schema","title":"UpdateEmployeePermissionsV1Dto","data":{"type":"object","properties":{"permissions":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Employee permissions object with permission keys and binary values (0=disabled, 1=enabled)"},"children":[]}]}]}],"example":{"ALLOCATIONS_INITIATE":1,"ALLOCATIONS_APPROVE":1,"BULK:PAYOUTS_INITIATE":1,"BUSINESS:BALANCE_VIEW":1,"CARDS_APPROVE":1,"EXPENSES_VIEW":1}}},"required":["permissions"]}},"components/schemas/UpdateRolePermissionsV1Dto":{"id":"components/schemas/UpdateRolePermissionsV1Dto","kind":"json-schema","title":"UpdateRolePermissionsV1Dto","data":{"type":"object","properties":{"permissions":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role permissions object with permission keys and binary values (0=disabled, 1=enabled)"},"children":[]}]}]}],"example":{"ALLOCATIONS_INITIATE":1,"ALLOCATIONS_APPROVE":0,"ALLOCATIONS_VIEW":1,"BULK:PAYOUTS_INITIATE":1,"BULK:PAYOUTS_APPROVE":1,"BULK:PAYOUTS_VIEW":1,"BUSINESS:STATEMENTS_VIEW":1,"BUSINESS:BALANCE_VIEW":1,"BUSINESS:BALANCE_EDIT":1,"BUSINESS:SETTINGS_VIEW":1,"BUSINESS:SETTINGS_EDIT":1,"BUSINESS:TRENDS_VIEW":1}}},"required":["permissions"]}},"components/schemas/MandateResponseV1Dto":{"id":"components/schemas/MandateResponseV1Dto","kind":"json-schema","title":"MandateResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"number","description":"HTTP status code","example":200},"data":{"description":"Response data containing mandate objects","allOf":[{"$ref":"#/components/schemas/MandateDataV1Dto"}]},"timestamp":{"type":"string","description":"Response timestamp in ISO format","example":"2026-01-09T11:09:56.314Z"}},"required":["status","timestamp"]}},"components/schemas/UpdateMandateV1Dto":{"id":"components/schemas/UpdateMandateV1Dto","kind":"json-schema","title":"UpdateMandateV1Dto","data":{"type":"object","properties":{"mandateData":{"description":"Mandate data containing the minimum approvers configuration","example":{"minimum_approvers":2},"allOf":[{"$ref":"#/components/schemas/UpdateMandateDataV1Dto"}]}},"required":["mandateData"]}},"components/schemas/UpdateSingleApproverV1Dto":{"id":"components/schemas/UpdateSingleApproverV1Dto","kind":"json-schema","title":"UpdateSingleApproverV1Dto","data":{"type":"object","properties":{"approverData":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approver data containing level and must_approve configuration"},"children":[]}]}]}],"example":{"level":1,"must_approve":false},"allOf":[{"$ref":"#/components/schemas/UpdateApproverDataV1Dto"}]}},"required":["approverData"]}},"components/schemas/RemoveApproverFromMandateV1Dto":{"id":"components/schemas/RemoveApproverFromMandateV1Dto","kind":"json-schema","title":"RemoveApproverFromMandateV1Dto","data":{"type":"object","properties":{"approvers":{"description":"Array of approver IDs to be removed from the mandate","example":["691af15e2c7cead4901adfd2","692af15e2c7cead4901adfd3"],"type":"array","items":{"type":"string"}}},"required":["approvers"]}},"components/schemas/AddApproversToMandateV1Dto":{"id":"components/schemas/AddApproversToMandateV1Dto","kind":"json-schema","title":"AddApproversToMandateV1Dto","data":{"type":"object","properties":{"approvers":{"description":"Array of approvers to add to the mandate","example":[{"_id":"68c2cc82272ac8e89e3f930c","must_approve":false,"level":1}],"type":"array","items":{"$ref":"#/components/schemas/ApproverWithIdDto"}}},"required":["approvers"]}},"components/schemas/PaginatedVendorResponseDto":{"id":"components/schemas/PaginatedVendorResponseDto","kind":"json-schema","title":"PaginatedVendorResponseDto","data":{"type":"object","properties":{"docs":{"description":"Vendor documents","type":"array","items":{"$ref":"#/components/schemas/VendorV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateVendorV1Dto":{"id":"components/schemas/CreateVendorV1Dto","kind":"json-schema","title":"CreateVendorV1Dto","data":{"type":"object","properties":{"phone":{"type":"string","description":"Vendor phone number","example":712345678},"email":{"type":"string","description":"Vendor email address","example":"vendor@example.com"},"contact_name":{"type":"string","description":"Contact person name","example":"John Doe"},"company_name":{"type":"string","description":"Company name","example":"Acme Corporation"},"address":{"type":"string","description":"Company address","example":"P.O. Box 12345, Nairobi"},"description":{"type":"string","description":"Vendor description","example":"Office supplies vendor"},"status":{"type":"string","description":"Vendor status","enum":["ACTIVE","INACTIVE","ARCHIVED"],"example":"ACTIVE"},"payment_instructions":{"description":"Payment instructions array (at least one required)","type":"array","items":{"$ref":"#/components/schemas/CreatePaymentInstructionV1Dto"}},"taxID":{"type":"string","description":"Tax identification number","example":"P051234567X"},"read_only":{"type":"boolean","description":"Whether vendor is read-only","example":false},"externalId":{"type":"string","description":"External system ID","example":"12345"}},"required":["phone","contact_name","company_name","payment_instructions"]}},"components/schemas/VendorV1Dto":{"id":"components/schemas/VendorV1Dto","kind":"json-schema","title":"VendorV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Vendor MongoDB ID"},"phone":{"type":"string","description":"Vendor phone number"},"email":{"type":"string","description":"Vendor email address"},"contact_name":{"type":"string","description":"Contact person name"},"company_name":{"type":"string","description":"Company name"},"address":{"type":"string","description":"Company address"},"description":{"type":"string","description":"Vendor description"},"status":{"type":"string","description":"Vendor status","enum":["ACTIVE","INACTIVE","ARCHIVED"]},"payment_instructions":{"description":"Payment instructions array","type":"array","items":{"$ref":"#/components/schemas/PaymentInstructionV1Dto"}},"taxID":{"type":"string","description":"Tax identification number"},"read_only":{"type":"boolean","description":"Whether vendor is read-only"},"externalId":{"type":"string","description":"External system ID"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/RecentVendorV1Dto":{"id":"components/schemas/RecentVendorV1Dto","kind":"json-schema","title":"RecentVendorV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Vendor MongoDB ID (only present for existing suppliers)"},"vendor":{"type":"string","description":"Vendor/Company name"},"receiver":{"type":"string","description":"Receiver name"},"accno":{"type":"string","description":"Account number"},"vendor_ref":{"type":"object","description":"Vendor reference"},"channel":{"type":"string","description":"Payment channel","enum":["mpesa","mtn","pochi","airtel","xentebanktransfer","bank","rtgs","paybill","till","airtime","internal"]},"phone":{"type":"string","description":"Phone number"},"company_name":{"type":"string","description":"Company name (for existing suppliers)"},"contact_name":{"type":"string","description":"Contact person name"},"email":{"type":"string","description":"Email address"},"payment_instructions":{"description":"Payment instructions (for existing suppliers)","type":"array","items":{"$ref":"#/components/schemas/PaymentInstructionV1Dto"}}}}},"components/schemas/UpdateVendorV1Dto":{"id":"components/schemas/UpdateVendorV1Dto","kind":"json-schema","title":"UpdateVendorV1Dto","data":{"type":"object","properties":{"phone":{"type":"string","description":"Vendor phone number","example":712345678},"email":{"type":"string","description":"Vendor email address","example":"vendor@example.com"},"contact_name":{"type":"string","description":"Contact person name","example":"John Doe"},"company_name":{"type":"string","description":"Company name","example":"Acme Corporation"},"address":{"type":"string","description":"Company address","example":"P.O. Box 12345, Nairobi"},"description":{"type":"string","description":"Vendor description","example":"Office supplies vendor"},"status":{"type":"string","description":"Vendor status","enum":["ACTIVE","INACTIVE","ARCHIVED"],"example":"ACTIVE"},"payment_instructions":{"description":"Payment instructions array","type":"array","items":{"$ref":"#/components/schemas/CreatePaymentInstructionV1Dto"}},"taxID":{"type":"string","description":"Tax identification number","example":"P051234567X"},"read_only":{"type":"boolean","description":"Whether vendor is read-only","example":false},"externalId":{"type":"string","description":"External system ID","example":"12345"}}}},"components/schemas/UpdatePaymentInstructionV1Dto":{"id":"components/schemas/UpdatePaymentInstructionV1Dto","kind":"json-schema","title":"UpdatePaymentInstructionV1Dto","data":{"type":"object","properties":{"payment_instruction":{"description":"Payment instruction details","allOf":[{"$ref":"#/components/schemas/PaymentInstructionPayloadDto"}]}},"required":["payment_instruction"]}},"components/schemas/AddPaymentInstructionV1Dto":{"id":"components/schemas/AddPaymentInstructionV1Dto","kind":"json-schema","title":"AddPaymentInstructionV1Dto","data":{"type":"object","properties":{"payment_instruction":{"description":"Payment instruction details","allOf":[{"$ref":"#/components/schemas/AddPaymentInstructionPayloadDto"}]}},"required":["payment_instruction"]}},"components/schemas/PaymentChannelsResponseV1Dto":{"id":"components/schemas/PaymentChannelsResponseV1Dto","kind":"json-schema","title":"PaymentChannelsResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Request status","example":true},"data":{"description":"List of payment channels","type":"array","items":{"$ref":"#/components/schemas/PaymentChannelV1Dto"}},"message":{"type":"string","description":"Response message","example":"Country payment channels fetched successfully"}},"required":["status"]}},"components/schemas/PaginatedPaymentsResponseV1Dto":{"id":"components/schemas/PaginatedPaymentsResponseV1Dto","kind":"json-schema","title":"PaginatedPaymentsResponseV1Dto","data":{"type":"object","properties":{"payouts":{"description":"List of bulk payment batches","type":"array","items":{"$ref":"#/components/schemas/BulkPaymentV1Dto"}},"paginationData":{"description":"Pagination metadata","allOf":[{"$ref":"#/components/schemas/PaginationDataV1Dto"}]}}}},"components/schemas/CreateBulkPayoutV1Dto":{"id":"components/schemas/CreateBulkPayoutV1Dto","kind":"json-schema","title":"CreateBulkPayoutV1Dto","data":{"type":"object","properties":{"records":{"description":"Array of payout records (at least one required)","example":[{"name":"carol mwangi","phone":796725019,"email":"","amount":10,"description":"test","team":"DE8832C7","category_code":"P003","payment_type":"mpesa","bank_code":"","receiver":796725019,"account_no":"","idno":"","mpesa_number":796725019,"tags":[],"country":"Kenya","category_name":"General Materials"}],"type":"array","items":{"$ref":"#/components/schemas/PayoutRecordRequestV1Dto"}},"description":{"type":"string","description":"Batch description","example":"test"},"batchno":{"type":"string","description":"Unique batch number","example":"K8SpPERUGO9f"},"accountref":{"type":"number","description":"Account reference (org wallet)","example":1},"status":{"type":"string","description":"Batch status","enum":["draft","pending"],"example":"draft"},"initiator_id":{"type":"string","description":"Initiator ID","example":"28AFC4D3DD4A27BC077E204E"},"team_code":{"type":"string","description":"Team code","example":"DE8832C7"},"team_name":{"type":"string","description":"Team name","example":"Petty cash"},"attachments":{"description":"File attachments","example":[],"type":"array","items":{"type":"string"}},"allowDuplicates":{"type":"boolean","description":"Allow duplicate payments","example":true,"default":true},"country":{"type":"string","description":"Country","example":"Kenya","default":"Kenya"},"source":{"type":"string","description":"Selected payout source wallet ID","example":"12007"},"source_name":{"type":"string","description":"Selected payout source wallet name","example":"Test Wallet"}},"required":["records","description","batchno","accountref","status","initiator_id","team_code","team_name","allowDuplicates","country"]}},"components/schemas/BulkPaymentV1Dto":{"id":"components/schemas/BulkPaymentV1Dto","kind":"json-schema","title":"BulkPaymentV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Bulk payment MongoDB ID"},"batch_no":{"type":"string","description":"Unique batch number"},"type":{"type":"number","description":"Payment batch type"},"records":{"description":"Individual payment records","type":"array","items":{"$ref":"#/components/schemas/PaymentRecordV1Dto"}},"notes":{"type":"string","description":"Batch notes"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"currency":{"type":"string","description":"Currency code","example":"KES"},"mandate_required":{"type":"number","description":"Whether mandate is required"},"attachments":{"description":"File attachments","type":"array","items":{"type":"string"}},"approvers":{"description":"Approvers for this batch","type":"array","items":{"$ref":"#/components/schemas/ApproverV1Dto"}},"initiated_by":{"type":"string","description":"Name of person who initiated"},"initiated_by_id":{"type":"string","description":"ID of person who initiated"},"callbackURL":{"type":"string","description":"Callback URL for payment processing"},"initiated_on":{"type":"string","description":"Formatted initiation date"},"events":{"description":"Activity and approval events","type":"array","items":{"$ref":"#/components/schemas/EventV1Dto"}},"status":{"type":"string","description":"Batch status","enum":["pending","processed","failed","cancelled","draft"]},"budget":{"type":"object","description":"Associated budget"},"collaborators":{"description":"Collaborator IDs","type":"array","items":{"type":"string"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Alias for _id"},"children":[]}]}]}]},"fees":{"type":"number","description":"Total fees"},"payout_amount":{"type":"number","description":"Total payout amount"},"amount":{"type":"number","description":"Total amount"},"initiated_by_name":{"type":"string","description":"Name of initiator (alias)"},"summary":{"description":"Payment summary by type","allOf":[{"$ref":"#/components/schemas/PaymentSummaryV1Dto"}]},"recordsProcessed":{"type":"number","description":"Number of records processed"},"amountProcessed":{"type":"number","description":"Amount processed"},"recordsFailed":{"type":"number","description":"Number of failed records"},"source":{"type":"string","description":"Source wallet ID"},"source_name":{"type":"string","description":"Source wallet name"}}}},"components/schemas/BankV1Dto":{"id":"components/schemas/BankV1Dto","kind":"json-schema","title":"BankV1Dto","data":{"type":"object","properties":{"id":{"type":"number","description":"Bank ID"},"code":{"type":"string","description":"Bank code","example":"01"},"paybill":{"type":"string","description":"Bank paybill number"},"name":{"type":"string","description":"Bank name","example":"KENYA COMMERCIAL BANK"},"country":{"type":"string","description":"Country code","example":"KE"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bank status (1 = active)"},"children":[]}]}]}]},"swiftcode":{"type":"string","description":"SWIFT code","example":"KCBLKENX"},"data_json":{"type":"object","description":"Additional JSON data"},"timestamp":{"type":"string","description":"Timestamp"},"branchcode":{"type":"number","description":"Branch code"}}}},"components/schemas/CreatePaymentIntentV1Dto":{"id":"components/schemas/CreatePaymentIntentV1Dto","kind":"json-schema","title":"CreatePaymentIntentV1Dto","data":{"type":"object","properties":{"businessId":{"type":"string","description":"Business identifier","example":"4D7CA841437E366EB38C"},"employeeId":{"type":"string","description":"Employee identifier","example":"F118CCFA49505BF267361A12"},"amount":{"type":"number","description":"Payment amount","example":11},"currency":{"type":"string","description":"Currency code","example":"KES"},"source":{"type":"string","description":"source","example":"P8756"},"receiver":{"type":"string","description":"Receiver identifier (phone number)","example":790462100},"transactionRef":{"type":"string","description":"Transaction reference","example":"M-CF4X4LG8IIW"}},"required":["businessId","employeeId","amount","currency","source","receiver","transactionRef"]}},"components/schemas/PaymentIntentResponseV1Dto":{"id":"components/schemas/PaymentIntentResponseV1Dto","kind":"json-schema","title":"PaymentIntentResponseV1Dto","data":{"type":"object","properties":{"paymentIntentId":{"type":"string","description":"Payment intent identifier","example":"696678f5b1dcd75bfdecd7b6"},"intentSecret":{"type":"string","description":"Intent secret","example":"061c46149901df054f8eb5fe3374cdecc911b1c7d0c756e433dc3a21071abe51"},"nonce":{"type":"string","description":"Nonce for request verification","example":"4e1885d59b0f1d8d497fed58ea279781"},"expiresAt":{"type":"string","description":"Intent expiration timestamp (ISO 8601)","example":"2026-01-13T16:57:17.082Z"}},"required":["paymentIntentId","intentSecret","nonce","expiresAt"]}},"components/schemas/ConfirmPaymentIntentV1Dto":{"id":"components/schemas/ConfirmPaymentIntentV1Dto","kind":"json-schema","title":"ConfirmPaymentIntentV1Dto","data":{"type":"object","properties":{"paymentIntentId":{"type":"string","description":"Payment intent identifier from creation step","example":"69669e16ced2648564b4b2e4"},"intentSecret":{"type":"string","description":"Intent secret from creation step","example":"14c417861a5ac32643bf9bafabbc017cda482b26649ee08c34f86e57c896eea8"},"nonce":{"type":"string","description":"Nonce from creation step","example":"bb2d557b90f189c45daa103a7530782b"},"otp":{"type":"string","description":"One-time password (6 digits)","example":"947302"},"transaction":{"description":"Complete transaction details","allOf":[{"$ref":"#/components/schemas/ConfirmPaymentTransactionDto"}]}},"required":["paymentIntentId","intentSecret","nonce","otp","transaction"]}},"components/schemas/PaymentConfirmationResponseV1Dto":{"id":"components/schemas/PaymentConfirmationResponseV1Dto","kind":"json-schema","title":"PaymentConfirmationResponseV1Dto","data":{"type":"object","properties":{"success":{"type":"boolean","description":"Payment confirmation status","example":true},"transactionRef":{"type":"string","description":"Transaction reference for confirmed payment","example":"TXN_20260113_ABC123"},"message":{"type":"string","description":"Confirmation message","example":"Payment processed successfully"},"processedAt":{"type":"string","description":"Processing timestamp (ISO 8601)","example":"2026-01-13T14:30:00.000Z"}},"required":["success","transactionRef","message","processedAt"]}},"components/schemas/RequestMpesaPaymentV1Dto":{"id":"components/schemas/RequestMpesaPaymentV1Dto","kind":"json-schema","title":"RequestMpesaPaymentV1Dto","data":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"M-Pesa phone number","example":"254712345678"},"amount":{"type":"number","description":"Payment amount","example":100},"accountNumber":{"type":"string","description":"Account reference number","example":"INV001"},"note":{"type":"string","description":"Payment note/description","example":"Payment for invoice"}},"required":["phoneNumber","amount","accountNumber","note"]}},"components/schemas/MpesaPaymentResponseV1Dto":{"id":"components/schemas/MpesaPaymentResponseV1Dto","kind":"json-schema","title":"MpesaPaymentResponseV1Dto","data":{"type":"object","properties":{"MerchantRequestID":{"type":"string","description":"Merchant request ID","example":"9a7a-428c-9f96-2533a83f54c22766019"},"CheckoutRequestID":{"type":"string","description":"Checkout request ID","example":"ws_CO_15012026123947186710702289"},"ResponseCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response code (0 = success)"},"children":[]}]}]}],"example":"0"},"ResponseDescription":{"type":"string","description":"Response description","example":"Success. Request accepted for processing"},"CustomerMessage":{"type":"string","description":"Customer message","example":"Success. Request accepted for processing"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status (1 = success)"},"children":[]}]}]}],"example":1}},"required":["MerchantRequestID","CheckoutRequestID","ResponseCode","ResponseDescription","CustomerMessage","status"]}},"components/schemas/InitiateBulkPayoutV1Dto":{"id":"components/schemas/InitiateBulkPayoutV1Dto","kind":"json-schema","title":"InitiateBulkPayoutV1Dto","data":{"type":"object","properties":{"source":{"type":"string","description":"Selected payout source wallet ID","example":"T312007"},"source_name":{"type":"string","description":"Selected payout source wallet name","example":"OCHOA"}}}},"components/schemas/RejectPayoutV1Dto":{"id":"components/schemas/RejectPayoutV1Dto","kind":"json-schema","title":"RejectPayoutV1Dto","data":{"type":"object","properties":{"ref":{"type":"string","description":"Payout batch reference identifier","example":"vNEYv0YXJ3Lw-rv-rv-rv"},"reason":{"type":"string","description":"Required reason for rejecting the payout batch","example":"Insufficient documentation provided"}},"required":["ref","reason"]}},"components/schemas/PermissionV1Dto":{"id":"components/schemas/PermissionV1Dto","kind":"json-schema","title":"PermissionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Permission MongoDB ID"},"name":{"type":"string","description":"Permission display name","example":"View Balance"},"slug":{"type":"string","description":"Permission slug","example":"view-balance"},"description":{"type":"string","description":"Permission description","example":"See current and available balance"},"category":{"type":"string","description":"Permission category","enum":["READ","TRANSACT","ADMIN"]},"requires_ownership":{"type":"boolean","description":"Whether this is an owner-only permission"},"createdAt":{"type":"string","description":"Creation timestamp"},"updatedAt":{"type":"string","description":"Last update timestamp"}},"required":["_id","name","slug","description","category","requires_ownership"]}},"components/schemas/PermissionSyncResultDto":{"id":"components/schemas/PermissionSyncResultDto","kind":"json-schema","title":"PermissionSyncResultDto","data":{"type":"object","properties":{"upserted":{"type":"number","description":"Number of permissions upserted"},"removed":{"type":"number","description":"Number of permissions removed"}},"required":["upserted","removed"]}},"components/schemas/ComputedPermissionsDto":{"id":"components/schemas/ComputedPermissionsDto","kind":"json-schema","title":"ComputedPermissionsDto","data":{"type":"object","properties":{"permissions":{"description":"List of permission slugs","type":"array","items":{"type":"string"}},"canViewBalance":{"type":"boolean","description":"Can view wallet balance"},"canViewTransactions":{"type":"boolean","description":"Can view transaction history"},"canExport":{"type":"boolean","description":"Can export statements"},"canInitiateTransfer":{"type":"boolean","description":"Can initiate transfers"},"canApprove":{"type":"boolean","description":"Can approve transfers/payouts"},"canSpend":{"type":"boolean","description":"Can spend from wallet"},"maskAmounts":{"type":"boolean","description":"Whether amounts are masked"},"transactionHistoryDays":{"type":"number","description":"Maximum transaction history days accessible"},"limits":{"type":"object","description":"Transaction limits"},"thresholds":{"type":"object","description":"Approval thresholds"},"expiresAt":{"type":"object","description":"Policy expiration date"}},"required":["permissions","canViewBalance","canViewTransactions","canExport","canInitiateTransfer","canApprove","canSpend","maskAmounts","transactionHistoryDays"]}},"components/schemas/CheckAccessV1Dto":{"id":"components/schemas/CheckAccessV1Dto","kind":"json-schema","title":"CheckAccessV1Dto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID to check access for"},"wallet_id":{"type":"string","description":"Wallet ID to check access on"},"permission":{"type":"string","description":"Permission slug to check","example":"initiate-transfer"}},"required":["employee_id","wallet_id","permission"]}},"components/schemas/AccessCheckResultDto":{"id":"components/schemas/AccessCheckResultDto","kind":"json-schema","title":"AccessCheckResultDto","data":{"type":"object","properties":{"allowed":{"type":"boolean","description":"Whether access is allowed"},"policy":{"description":"Policy used for the check (if allowed)","allOf":[{"$ref":"#/components/schemas/PolicyV1Dto"}]},"reason":{"type":"string","description":"Reason for the result","example":"OK"}},"required":["allowed","reason"]}},"components/schemas/CheckLimitsV1Dto":{"id":"components/schemas/CheckLimitsV1Dto","kind":"json-schema","title":"CheckLimitsV1Dto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID to check limits for"},"wallet_id":{"type":"string","description":"Wallet ID to check limits on"},"amount":{"type":"number","description":"Transaction amount to validate","example":75000}},"required":["employee_id","wallet_id","amount"]}},"components/schemas/LimitsCheckResultDto":{"id":"components/schemas/LimitsCheckResultDto","kind":"json-schema","title":"LimitsCheckResultDto","data":{"type":"object","properties":{"allowed":{"type":"boolean","description":"Whether transaction is within limits"},"reason":{"type":"string","description":"Reason for the result"},"requires_approval":{"type":"boolean","description":"Whether approval is required for this amount"}},"required":["allowed","reason","requires_approval"]}},"components/schemas/QueryAuditLogsV1Dto":{"id":"components/schemas/QueryAuditLogsV1Dto","kind":"json-schema","title":"QueryAuditLogsV1Dto","data":{"type":"object","properties":{"search":{"type":"string","description":"Search action, reason, performer, or policy subject"},"policy_id":{"type":"string","description":"Filter by policy ID"},"wallet_id":{"type":"string","description":"Filter by wallet ID"},"performed_by":{"type":"string","description":"Filter by performer employee ID"},"action":{"type":"string","description":"Filter by action type","enum":["GRANTED","MODIFIED","SUSPENDED","REVOKED","EXPIRED","REACTIVATED"]},"from_date":{"type":"string","description":"Filter from date"},"to_date":{"type":"string","description":"Filter to date"},"limit":{"type":"number","description":"Number of records to return","default":50},"offset":{"type":"number","description":"Number of records to skip","default":0}}}},"components/schemas/PaginatedAuditLogsResponseDto":{"id":"components/schemas/PaginatedAuditLogsResponseDto","kind":"json-schema","title":"PaginatedAuditLogsResponseDto","data":{"type":"object","properties":{"docs":{"description":"List of audit log entries","type":"array","items":{"$ref":"#/components/schemas/AuditLogEntryDto"}},"total":{"type":"number","description":"Total count"},"page":{"type":"number","description":"Current page"},"limit":{"type":"number","description":"Items per page"},"pages":{"type":"number","description":"Total pages"}},"required":["docs","total","page","limit","pages"]}},"components/schemas/PolicyV1Dto":{"id":"components/schemas/PolicyV1Dto","kind":"json-schema","title":"PolicyV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy MongoDB ID"},"subject_type":{"type":"string","description":"Subject type","enum":["EMPLOYEE","BUSINESS","EXTERNAL"]},"employee_id":{"type":"object","description":"Employee reference (populated)"},"business_id":{"type":"string","description":"Business ID"},"external_ref":{"type":"string","description":"External reference"},"wallet_id":{"type":"string","description":"Wallet ID"},"permissions":{"description":"Granted permissions","type":"array","items":{"type":"string"}},"limits":{"description":"Transaction limits","allOf":[{"$ref":"#/components/schemas/PolicyLimitsResponseDto"}]},"thresholds":{"description":"Approval thresholds","allOf":[{"$ref":"#/components/schemas/PolicyThresholdsResponseDto"}]},"restrictions":{"description":"Display restrictions","allOf":[{"$ref":"#/components/schemas/PolicyRestrictionsResponseDto"}]},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","SUSPENDED","EXPIRED","REVOKED"]},"valid_from":{"type":"string","description":"Policy start date"},"valid_until":{"type":"string","description":"Policy expiry date"},"granted_by":{"type":"object","description":"Granter employee reference"},"revoked_by":{"type":"string","description":"Revoker employee ID"},"revoked_at":{"type":"string","description":"Revocation timestamp"},"revoke_reason":{"type":"string","description":"Revocation reason"},"label":{"type":"string","description":"Human-friendly label"},"notes":{"type":"string","description":"Additional notes"},"createdAt":{"type":"string","description":"Creation timestamp"},"updatedAt":{"type":"string","description":"Last update timestamp"}},"required":["_id","subject_type","wallet_id","permissions","status","createdAt","updatedAt"]}},"components/schemas/ModifyAccessV1Dto":{"id":"components/schemas/ModifyAccessV1Dto","kind":"json-schema","title":"ModifyAccessV1Dto","data":{"type":"object","properties":{"updates":{"description":"Fields to update","allOf":[{"$ref":"#/components/schemas/PolicyUpdatesDto"}]},"reason":{"type":"string","description":"Reason for modification"},"modified_by":{"type":"string","description":"Employee ID of the modifier (auto-populated from auth)"}},"required":["updates"]}},"components/schemas/RevokeAccessV1Dto":{"id":"components/schemas/RevokeAccessV1Dto","kind":"json-schema","title":"RevokeAccessV1Dto","data":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for revocation","example":"Employee left the company"},"revoked_by":{"type":"string","description":"Employee ID of the revoker (auto-populated from auth)"}}}},"components/schemas/SuspendAccessV1Dto":{"id":"components/schemas/SuspendAccessV1Dto","kind":"json-schema","title":"SuspendAccessV1Dto","data":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for suspension","example":"Pending investigation"},"suspended_by":{"type":"string","description":"Employee ID of the suspender (auto-populated from auth)"}}}},"components/schemas/ReactivateAccessV1Dto":{"id":"components/schemas/ReactivateAccessV1Dto","kind":"json-schema","title":"ReactivateAccessV1Dto","data":{"type":"object","properties":{"reactivated_by":{"type":"string","description":"Employee ID of the reactivator (auto-populated from auth)"}}}},"components/schemas/GrantAccessV1Dto":{"id":"components/schemas/GrantAccessV1Dto","kind":"json-schema","title":"GrantAccessV1Dto","data":{"type":"object","properties":{"subject_type":{"type":"string","description":"Subject type","enum":["EMPLOYEE","BUSINESS","EXTERNAL"],"example":"EMPLOYEE"},"employee_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Employee ID (required when subject_type is EMPLOYEE)"},"children":[]}]}]}]},"business_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Business ID (required when subject_type is BUSINESS)"},"children":[]}]}]}]},"external_ref":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"External reference (required when subject_type is EXTERNAL)"},"children":[]}]}]}]},"wallet_id":{"type":"string","description":"Wallet ID to grant access to"},"permissions":{"description":"Permission slugs to grant","example":["view-balance","view-transactions","initiate-transfer"],"type":"array","items":{"type":"string"}},"limits":{"description":"Transaction limits","allOf":[{"$ref":"#/components/schemas/PolicyLimitsDto"}]},"thresholds":{"description":"Approval thresholds","allOf":[{"$ref":"#/components/schemas/PolicyThresholdsDto"}]},"restrictions":{"description":"Display restrictions","allOf":[{"$ref":"#/components/schemas/PolicyRestrictionsDto"}]},"valid_from":{"type":"string","description":"Policy start date (defaults to now)"},"valid_until":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Policy expiry date (null = no expiry)"},"children":[]}]}]}]},"granted_by":{"type":"string","description":"Employee ID of the granter (auto-populated from auth)"},"label":{"type":"string","description":"Human-friendly label","example":"Finance Team Member"},"notes":{"type":"string","description":"Additional notes"}},"required":["subject_type","wallet_id","permissions"]}},"components/schemas/PaginatedTaxResponseDto":{"id":"components/schemas/PaginatedTaxResponseDto","kind":"json-schema","title":"PaginatedTaxResponseDto","data":{"type":"object","properties":{"docs":{"description":"Tax documents","type":"array","items":{"$ref":"#/components/schemas/TaxV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/CreateTaxV1Dto":{"id":"components/schemas/CreateTaxV1Dto","kind":"json-schema","title":"CreateTaxV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Tax name","example":"Management fee"},"type":{"type":"string","description":"Tax type","enum":["WITHHOLDING_TAX","VAT_WITHHOLDING_TAX"],"example":"VAT_WITHHOLDING_TAX"},"resident_type":{"type":"string","description":"Resident type","enum":["Resident","Non-Resident"],"example":"Resident"},"nature_of_business":{"type":"string","description":"Nature of business","example":"Management, Professional, Training or Consultancy Fees"},"rate":{"type":"number","description":"Tax rate","example":5}},"required":["name","type","resident_type","rate"]}},"components/schemas/TaxV1Dto":{"id":"components/schemas/TaxV1Dto","kind":"json-schema","title":"TaxV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tax MongoDB ID"},"name":{"type":"string","description":"Tax name"},"type":{"type":"string","description":"Tax type","enum":["WITHHOLDING_TAX","VAT_WITHHOLDING_TAX"]},"resident_type":{"type":"string","description":"Resident type","enum":["Resident","Non-Resident"]},"nature_of_business":{"type":"string","description":"Nature of business"},"rate":{"type":"number","description":"Tax rate"},"status":{"type":"string","description":"Tax status","enum":["ACTIVE","ARCHIVED"]},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/UpdateTaxV1Dto":{"id":"components/schemas/UpdateTaxV1Dto","kind":"json-schema","title":"UpdateTaxV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Tax name","example":"Management fee"},"type":{"type":"string","description":"Tax type","enum":["WITHHOLDING_TAX","VAT_WITHHOLDING_TAX"],"example":"VAT_WITHHOLDING_TAX"},"resident_type":{"type":"string","description":"Resident type","enum":["Resident","Non-Resident"],"example":"Resident"},"nature_of_business":{"type":"string","description":"Nature of business","example":"Management, Professional, Training or Consultancy Fees"},"rate":{"type":"number","description":"Tax rate","example":5}}}},"components/schemas/TaxTransactionsResponseV1Dto":{"id":"components/schemas/TaxTransactionsResponseV1Dto","kind":"json-schema","title":"TaxTransactionsResponseV1Dto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Response status","example":true},"status_code":{"type":"number","description":"HTTP status code","example":200},"message":{"type":"string","description":"Response message","example":"WithHolding Taxes Retrieved"},"data":{"description":"Tax transactions data","type":"array","items":{"$ref":"#/components/schemas/TaxTransactionV1Dto"}}},"required":["status","status_code","message"]}},"components/schemas/PaginatedSubscriptionResponseDto":{"id":"components/schemas/PaginatedSubscriptionResponseDto","kind":"json-schema","title":"PaginatedSubscriptionResponseDto","data":{"type":"object","properties":{"docs":{"description":"Subscription documents","type":"array","items":{"$ref":"#/components/schemas/SubscriptionV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"object","description":"Limit per page"},"page":{"type":"object","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/PaginatedExpensesDto":{"id":"components/schemas/PaginatedExpensesDto","kind":"json-schema","title":"PaginatedExpensesDto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Status of the operation","example":true},"message":{"type":"string","description":"Response message","example":"Add Susbcription payment"},"data":{"description":"Paginated expenses data","allOf":[{"$ref":"#/components/schemas/PaginatedExpensesDataDto"}]}},"required":["status","message","data"]}},"components/schemas/AmountSpentRequestDto":{"id":"components/schemas/AmountSpentRequestDto","kind":"json-schema","title":"AmountSpentRequestDto","data":{"type":"object","properties":{"from":{"type":"string","description":"Start date in ISO format","example":"2025-12-31T21:00:00.000+00:00"},"to":{"type":"string","description":"End date in ISO format","example":"2026-01-30T21:00:00.000+00:00"},"currency":{"type":"string","description":"Currency code","example":"KES"},"business_id":{"type":"string","description":"Business ID","example":"4D7CA841437E366EB38C"},"period":{"type":"string","description":"Period type","example":"MONTHLY"},"subscriptionId":{"type":"string","description":"Subscription ID","example":"67b44aea86c1ccabbe965827"}},"required":["from","to","currency","business_id","period","subscriptionId"]}},"components/schemas/AmountSpentResponseDto":{"id":"components/schemas/AmountSpentResponseDto","kind":"json-schema","title":"AmountSpentResponseDto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Status of the operation","example":true},"message":{"type":"string","description":"Response message","example":"Fetch total amount per period"},"data":{"description":"Amount spent data","allOf":[{"$ref":"#/components/schemas/AmountSpentDataDto"}]}},"required":["status","message","data"]}},"components/schemas/CreateSubscriptionRequestDto":{"id":"components/schemas/CreateSubscriptionRequestDto","kind":"json-schema","title":"CreateSubscriptionRequestDto","data":{"type":"object","properties":{"name":{"type":"string","description":"Merchant/subscription name","example":"DIGITALOCEAN.COM"},"limit":{"type":"object","description":"Spending limit","example":"10"},"cards":{"description":"Array of card IDs","example":["683ee0b950009c749ba23312"],"type":"array","items":{"type":"string"}},"assignee":{"type":"string","description":"Employee ID to assign the subscription to","example":"67befe9f17f57a814696e291"},"status":{"type":"string","description":"Subscription status","example":"DRAFT"},"frequency_period_unit":{"type":"string","description":"Frequency period unit (MONTH, YEAR, etc.)","example":"MONTH"},"wallet_name":{"type":"string","description":"Wallet display name","example":"xyz - MAIN"},"wallet_currency":{"type":"string","description":"Wallet currency code","example":"KES"},"wallet_id":{"type":"string","description":"Wallet identifier","example":"1271"},"web_url":{"type":"string","description":"Merchant website URL","example":"https://www.digitalocean.com"},"create_new_merchant":{"type":"boolean","description":"Flag to create new merchant","example":false},"team":{"description":"Team assignment","allOf":[{"$ref":"#/components/schemas/CreateSubscriptionTeamDto"}]},"subcategory":{"description":"Expense category","allOf":[{"$ref":"#/components/schemas/CreateSubscriptionSubcategoryDto"}]},"is_request":{"type":"boolean","description":"Flag indicating if this is a request","example":false},"org_wallet_ref":{"type":"number","description":"Organization wallet reference","example":1},"business_id":{"type":"string","description":"Organization business ID","example":"E74490ACDCAF716DC722"},"notes":{"type":"string","description":"Additional notes","example":"Brian Ryb is requesting creation of a DIGITALOCEAN.COM subscription"}},"required":["name","limit","cards","assignee","status","frequency_period_unit","wallet_name","wallet_currency","wallet_id","team","subcategory","org_wallet_ref","business_id"]}},"components/schemas/SubscriptionV1Dto":{"id":"components/schemas/SubscriptionV1Dto","kind":"json-schema","title":"SubscriptionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Subscription ID"},"business":{"description":"Business information","allOf":[{"$ref":"#/components/schemas/SubscriptionBusinessDto"}]},"name":{"type":"string","description":"Subscription name"},"limit":{"type":"number","description":"Subscription limit"},"cards":{"description":"Associated cards","type":"array","items":{"$ref":"#/components/schemas/SubscriptionCardDto"}},"assignee":{"description":"Subscription assignee","allOf":[{"$ref":"#/components/schemas/SubscriptionAssigneeDto"}]},"status":{"type":"string","description":"Subscription status","enum":["DRAFT","ACTIVE","PAUSED","REJECTED","DELETED","PENDING"],"example":"ACTIVE"},"wallet_id":{"type":"string","description":"Wallet ID"},"wallet_currency":{"type":"string","description":"Wallet currency"},"frequency_period_unit":{"type":"string","description":"Frequency period unit"},"frequency":{"type":"number","description":"Frequency"},"icon":{"type":"string","description":"Subscription icon URL"},"merchant_category_code":{"type":"string","description":"Merchant category code"},"merchant_receiver_name":{"type":"string","description":"Merchant receiver name"},"amount_spent":{"type":"number","description":"Amount spent"},"last_transacted_amount":{"type":"number","description":"Last transacted amount"},"score":{"type":"number","description":"Score"},"next_invoice_date":{"type":"string","description":"Next invoice date"},"createdAt":{"type":"string","description":"Created date"},"updatedAt":{"type":"string","description":"Updated date"},"subcategory":{"description":"Subcategory information","allOf":[{"$ref":"#/components/schemas/SubscriptionSubcategoryDto"}]},"team":{"description":"Subcategory information","allOf":[{"$ref":"#/components/schemas/SubscriptionTeamDto"}]}}}},"components/schemas/UpdateStatusRequestDto":{"id":"components/schemas/UpdateStatusRequestDto","kind":"json-schema","title":"UpdateStatusRequestDto","data":{"type":"object","properties":{"status":{"type":"string","description":"Subscription status","enum":["ACTIVE","PAUSED"],"example":"ACTIVE"}},"required":["status"]}},"components/schemas/UpdateTeamRequestDto":{"id":"components/schemas/UpdateTeamRequestDto","kind":"json-schema","title":"UpdateTeamRequestDto","data":{"type":"object","properties":{"team":{"description":"Team information","allOf":[{"$ref":"#/components/schemas/TeamDto"}]},"updateExpenses":{"type":"boolean","description":"Whether to update existing expenses","example":false}},"required":["team","updateExpenses"]}},"components/schemas/UpdateLimitsBillingFrequencyRequestDto":{"id":"components/schemas/UpdateLimitsBillingFrequencyRequestDto","kind":"json-schema","title":"UpdateLimitsBillingFrequencyRequestDto","data":{"type":"object","properties":{"limit":{"type":"string","description":"Subscription limit","example":"10"},"frequency_period_unit":{"type":"string","description":"Frequency period unit","example":"YEAR","enum":["DAY","WEEK","MONTH","YEAR"]},"frequency":{"type":"number","description":"Frequency value","example":1}},"required":["limit","frequency_period_unit","frequency"]}},"components/schemas/AssignEmployeeRequestDto":{"id":"components/schemas/AssignEmployeeRequestDto","kind":"json-schema","title":"AssignEmployeeRequestDto","data":{"type":"object","properties":{"employee_oid":{"type":"string","description":"Employee object ID"},"card_oid":{"type":"string","description":"Card object ID"}},"required":["employee_oid","card_oid"]}},"components/schemas/UpdateSubcategoryRequestDto":{"id":"components/schemas/UpdateSubcategoryRequestDto","kind":"json-schema","title":"UpdateSubcategoryRequestDto","data":{"type":"object","properties":{"subcategory":{"description":"Subcategory information","allOf":[{"$ref":"#/components/schemas/SubscriptionSubcategoryDto"}]},"updateExpenses":{"type":"boolean","description":"Whether to update existing expenses","example":false}},"required":["subcategory","updateExpenses"]}},"components/schemas/AutoGenerateResponseDto":{"id":"components/schemas/AutoGenerateResponseDto","kind":"json-schema","title":"AutoGenerateResponseDto","data":{"type":"object","properties":{"status":{"type":"boolean","description":"Status of the operation","example":true},"data":{"description":"Array of generated subscriptions","example":[],"type":"array","items":{"type":"object"}},"message":{"type":"string","description":"Response message","example":"Subscriptions Payload AutoGenerated Successfully"}},"required":["status","data","message"]}},"components/schemas/PaginatedAuditEventResponseDto":{"id":"components/schemas/PaginatedAuditEventResponseDto","kind":"json-schema","title":"PaginatedAuditEventResponseDto","data":{"type":"object","properties":{"docs":{"description":"Audit event documents","type":"array","items":{"$ref":"#/components/schemas/AuditEventV1Dto"}},"total":{"type":"number","description":"Total count"},"limit":{"type":"number","description":"Limit per page"},"page":{"type":"number","description":"Current page"},"pages":{"type":"number","description":"Total pages"}}}},"components/schemas/AuditDigestResponseDto":{"id":"components/schemas/AuditDigestResponseDto","kind":"json-schema","title":"AuditDigestResponseDto","data":{"type":"object","properties":{"groups":{"description":"Grouped audit events with insights","type":"array","items":{"$ref":"#/components/schemas/DigestGroupDto"}},"stats":{"description":"Aggregate statistics","allOf":[{"$ref":"#/components/schemas/DigestStatsDto"}]}},"required":["groups","stats"]}},"components/schemas/CreateCustomerDto":{"id":"components/schemas/CreateCustomerDto","kind":"json-schema","title":"CreateCustomerDto","data":{"type":"object","properties":{"type":{"type":"string","description":"Customer type. \"walkIn\" auto-sets name to \"WalkIn\" and nulls all other fields. \"regular\" requires name and taxPin.","enum":["regular","walkIn"],"example":"regular"},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer name. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"regular"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; ignored for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"walkIn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (auto-set to \"WalkIn\")."},"children":[]}]}]}],"example":"Acme Corp"},"email":{"type":"string","description":"Customer email address (optional).","example":"billing@acme.com"},"phone":{"type":"string","description":"Customer phone number (optional).","example":"+254700000000"},"address":{"type":"string","description":"Customer physical address.","example":"123 Main Street, Nairobi"},"person":{"description":"Array of person identifiers associated with this customer.","example":["person-001","person-002"],"type":"array","items":{"type":"string"}},"taxPin":{"type":"string","description":"KRA Tax PIN.","example":"A123456789Z"}},"required":["type"]}},"components/schemas/UpdateCustomerDto":{"id":"components/schemas/UpdateCustomerDto","kind":"json-schema","title":"UpdateCustomerDto","data":{"type":"object","properties":{"name":{"type":"string","description":"Customer name.","example":"Acme Corp Updated"},"email":{"type":"string","description":"Customer email address.","example":"billing@acme.com"},"phone":{"type":"string","description":"Customer phone number.","example":"+254700000000"},"address":{"type":"string","description":"Customer physical address.","example":"123 Main Street, Nairobi"},"person":{"description":"Array of person identifiers associated with this customer.","example":["person-001"],"type":"array","items":{"type":"string"}},"taxPin":{"type":"string","description":"KRA Tax PIN.","example":"A123456789Z"}}}},"components/schemas/PolicyGroupV1Dto":{"id":"components/schemas/PolicyGroupV1Dto","kind":"json-schema","title":"PolicyGroupV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy group MongoDB ObjectId"},"description":{"type":"string","description":"Description of what this policy group governs"},"subject":{"type":"string","description":"Subject area of the policy group (e.g. Employee Spend, Expense Review)"},"policies":{"description":"Policy types within this group","type":"array","items":{"$ref":"#/components/schemas/PolicySummaryInGroupV1Dto"}},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp"},"updatedAt":{"type":"string","description":"ISO 8601 last-updated timestamp"}}}},"components/schemas/PolicyGroupWithPoliciesV1Dto":{"id":"components/schemas/PolicyGroupWithPoliciesV1Dto","kind":"json-schema","title":"PolicyGroupWithPoliciesV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy group MongoDB ObjectId"},"description":{"type":"string","description":"Description of what this policy group governs"},"subject":{"type":"string","description":"Subject area of the policy group (e.g. Employee Spend, Expense Review)"},"policies":{"description":"Policy types within this group, each with their business policies and rules","type":"array","items":{"$ref":"#/components/schemas/PolicyWithRulesV1Dto"}},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp"},"updatedAt":{"type":"string","description":"ISO 8601 last-updated timestamp"}}}},"components/schemas/PolicyWithBusinessPoliciesV1Dto":{"id":"components/schemas/PolicyWithBusinessPoliciesV1Dto","kind":"json-schema","title":"PolicyWithBusinessPoliciesV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy group MongoDB ObjectId"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED"]},"description":{"type":"string","description":"Human-readable description of the policy type"},"policy_code":{"type":"string","description":"Policy code (e.g. SUBCATEGORY, CHANNELS, VENDORS)"},"business_policies":{"description":"Business-specific policies configured under this policy type","type":"array","items":{"$ref":"#/components/schemas/BusinessPolicyV1Dto"}}}}},"components/schemas/BusinessPolicyV1Dto":{"id":"components/schemas/BusinessPolicyV1Dto","kind":"json-schema","title":"BusinessPolicyV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Business policy MongoDB ObjectId"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED","DELETED"]},"policy":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parent policy group — either a MongoDB ObjectId string or an expanded PolicyRefV1Dto object"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/PolicyRefV1Dto"}]},"business":{"type":"string","description":"Business MongoDB ObjectId this policy belongs to"},"policy_type":{"type":"string","description":"Policy scope (e.g. business, budget)"},"policy_code":{"type":"string","description":"Policy code inherited from the parent policy group"},"employees":{"description":"Employee IDs this policy is scoped to","type":"array","items":{"type":"string"}},"teams":{"description":"Team IDs this policy is scoped to","type":"array","items":{"type":"string"}},"budgets":{"description":"Budget IDs this policy is scoped to","type":"array","items":{"type":"string"}},"priority":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Priority order among policies of the same type (lower = higher priority)"},"children":[]}]}]}]},"workflow":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approval workflow attached to this policy — null when no approval is required"},"children":[]}]}]}],"nullable":true},"rules":{"description":"Rules defining the conditions and actions of this policy","type":"array","items":{"$ref":"#/components/schemas/PolicyRuleV1Dto"}},"name":{"type":"string","description":"Human-readable name for this business policy"},"description":{"type":"string","description":"Optional description for this business policy"},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp"},"updatedAt":{"type":"string","description":"ISO 8601 last-updated timestamp"}}}},"components/schemas/UpsertCategoryPolicyV1Dto":{"id":"components/schemas/UpsertCategoryPolicyV1Dto","kind":"json-schema","title":"UpsertCategoryPolicyV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Business policy MongoDB ObjectId. When present the policy is updated; omit to create.","example":"6a3ebb7893bb2649e19cb8a6"},"name":{"type":"string","description":"Human-readable name for the policy","example":"Company Travel spend limits"},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Target scope of the policy: business | team | employee"},"children":[]}]}]}],"example":"business"},"status":{"type":"string","description":"Policy status. INACTIVE is accepted as an alias for DISABLED.","enum":["ACTIVE","DISABLED","INACTIVE","DELETED"],"example":"ACTIVE"},"description":{"type":"string","description":"Optional description"},"priority":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Priority order (lower = higher priority)"},"children":[]}]}]}],"example":1},"workflow":{"type":"object","description":"Approval workflow ID or null","nullable":true},"employees":{"description":"Employee IDs scoped to this policy","type":"array","items":{"type":"string"}},"teams":{"description":"Team IDs scoped to this policy","type":"array","items":{"type":"string"}},"budgets":{"description":"Budget IDs scoped to this policy","type":"array","items":{"type":"string"}},"rules":{"description":"Rules defining conditions and actions of this policy","type":"array","items":{"$ref":"#/components/schemas/PolicyRuleV1Dto"}},"require_tax_compliant_receipt":{"type":"boolean","description":"Whether tax-compliant receipts are required"}},"required":["name","type"]}},"components/schemas/UpdateBusinessPolicyV1Dto":{"id":"components/schemas/UpdateBusinessPolicyV1Dto","kind":"json-schema","title":"UpdateBusinessPolicyV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Business policy MongoDB ObjectId","example":"6a3ebb7893bb2649e19cb8a6"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED","INACTIVE","DELETED"],"example":"ACTIVE"},"policy":{"type":"string","description":"Parent policy group ID or object","example":"66788b3e2805e9ffbda6dcf7"},"business":{"type":"string","description":"Business MongoDB ObjectId","example":"631b067a46830ae81217f860"},"policy_type":{"type":"string","description":"Policy scope type (e.g. business, budget)","example":"business"},"employees":{"description":"Employee IDs this policy is scoped to","type":"array","items":{"type":"string"}},"teams":{"description":"Team IDs this policy is scoped to","type":"array","items":{"type":"string"}},"budgets":{"description":"Budget IDs this policy is scoped to","type":"array","items":{"type":"string"}},"priority":{"type":"number","description":"Priority order among policies of the same type","example":1},"workflow":{"type":"object","description":"Approval workflow ID or null when no approval is required","example":"6a3e6c5387ee44d7d52a3092","nullable":true},"rules":{"description":"Rules defining the conditions and actions of this policy","type":"array","items":{"$ref":"#/components/schemas/PolicyRuleV1Dto"}},"name":{"type":"string","description":"Human-readable name for the policy","example":"Test"},"description":{"type":"string","description":"Optional description for the policy","example":"test"},"require_tax_compliant_receipt":{"type":"boolean","description":"Whether tax-compliant receipts are required (legacy top-level field)"}}}},"components/schemas/PolicyWorkflowV1Dto":{"id":"components/schemas/PolicyWorkflowV1Dto","kind":"json-schema","title":"PolicyWorkflowV1Dto","data":{"type":"object","properties":{"name":{"type":"string","example":"Travel subcategory approvals"},"description":{"type":"string","example":"Approval workflow for travel spend"},"auto_approval":{"type":"boolean","example":false},"requester_can_approve":{"type":"boolean","example":true},"status":{"type":"string","enum":["active","inactive","archived"]},"type":{"type":"string","enum":["business","team"],"default":"business","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workflow scope type (not policy_type)."},"children":[]}]}]}]},"currency":{"type":"string","example":"KES","description":"Currency the workflow applies to."},"teams":{"example":["68c1656caa7b2a7f2769a267"],"description":"Team ObjectIds when type is team.","type":"array","items":{"type":"string"}},"requester_approval_conditions":{"example":[],"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/PolicyWorkflowStepDto"}}},"required":["steps"]}},"components/schemas/CreateBusinessPolicyV1Dto":{"id":"components/schemas/CreateBusinessPolicyV1Dto","kind":"json-schema","title":"CreateBusinessPolicyV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for the new business policy","example":"testing category"},"description":{"type":"string","description":"Optional description for the policy","example":""},"type":{"type":"string","description":"Policy scope type (e.g. business, budget)","example":"business"}},"required":["name","type"]}},"components/schemas/ConversionRateRequestV1Dto":{"id":"components/schemas/ConversionRateRequestV1Dto","kind":"json-schema","title":"ConversionRateRequestV1Dto","data":{"type":"object","properties":{"from":{"type":"string","example":"USD","description":"Source currency code (ISO 4217)"},"to":{"type":"string","example":"KES","description":"Target currency code (ISO 4217)"}},"required":["from","to"]}},"components/schemas/ConversionRateResponseV1Dto":{"id":"components/schemas/ConversionRateResponseV1Dto","kind":"json-schema","title":"ConversionRateResponseV1Dto","data":{"type":"object","properties":{"from":{"type":"string","example":"USD"},"to":{"type":"string","example":"KES"},"rate":{"type":"number","example":129.122},"timestamp":{"type":"string","example":"2026-04-23T00:00:00Z"},"markup":{"$ref":"#/components/schemas/FxMarkupDto"}},"required":["from","to","rate","timestamp","markup"]}},"components/schemas/HistoricRateRequestV1Dto":{"id":"components/schemas/HistoricRateRequestV1Dto","kind":"json-schema","title":"HistoricRateRequestV1Dto","data":{"type":"object","properties":{"from":{"type":"string","example":"USD","description":"Source currency code (ISO 4217)"},"to":{"type":"string","example":"KES","description":"Target currency code (ISO 4217)"},"date":{"type":"string","example":"2024-12-02","description":"Historical date (YYYY-MM-DD)"}},"required":["from","to","date"]}},"components/schemas/FxTransferRequestV1Dto":{"id":"components/schemas/FxTransferRequestV1Dto","kind":"json-schema","title":"FxTransferRequestV1Dto","data":{"type":"object","properties":{"amount":{"type":"number","example":100,"description":"Transfer amount"},"description":{"type":"string","example":"Internal transfer between accounts","description":"Transfer description"},"currency":{"type":"string","example":"USD","description":"Currency code (ISO 4217)"},"fromWalletId":{"type":"string","example":"wallet_1","description":"Source wallet ID"},"toWalletId":{"type":"string","example":"wallet_2","description":"Destination wallet ID"},"reference":{"type":"string","example":"FX_a1b2c3d4e5","description":"Reference (auto-generated if not provided)"}},"required":["amount","description","currency","fromWalletId","toWalletId"]}},"components/schemas/FundsCatalogueResponseDto":{"id":"components/schemas/FundsCatalogueResponseDto","kind":"json-schema","title":"FundsCatalogueResponseDto","data":{"type":"object","properties":{"funds":{"type":"array","items":{"$ref":"#/components/schemas/FundCatalogueItemDto"}}},"required":["funds"]}},"components/schemas/ListInvestmentAccountsResponseDto":{"id":"components/schemas/ListInvestmentAccountsResponseDto","kind":"json-schema","title":"ListInvestmentAccountsResponseDto","data":{"type":"object","properties":{"accounts":{"type":"array","items":{"$ref":"#/components/schemas/FundAccountSummaryDto"}}},"required":["accounts"]}},"components/schemas/FundAccountDetailDto":{"id":"components/schemas/FundAccountDetailDto","kind":"json-schema","title":"FundAccountDetailDto","data":{"type":"object","properties":{"fund_account_id":{"type":"string","example":"fa_01HXYZ...","description":"Customer's fund account ID"},"fund_id":{"type":"string","example":"fund_britam_kes_mmf","description":"Catalogue fund ID"},"fund_name":{"type":"string","example":"Britam KES Money Market Fund"},"vendor":{"type":"string","example":"BRITAM"},"product":{"type":"string","example":"MONEY_MARKET"},"currency":{"type":"string","example":"KES"},"org_wallet_ref":{"type":"string","example":"1","description":"Organization wallet reference for this fund account currency."},"account_reference":{"type":"string","example":"BA100020873BOYA","description":"External account reference (display-only)"},"approval_ref":{"type":"string","example":"INV-OPT-123456","description":"Approval request reference for pending opt-in records."},"investment_wallet_id":{"type":"string","example":"I622957","description":"Boya wallet id of the MMF investment account. Used by the dashboard as the destination when topping up the investment account from a business wallet."},"state":{"type":"string","enum":["opt_in_pending","active","closing","opt_in_failed"],"example":"active"},"invested":{"description":"Total invested principal (native currency)","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"wallet_available_balance":{"description":"Available cash in the investment wallet before it is invested with the custodian.","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"opt_in_date":{"type":"string","example":"2024-08-12","description":"Opt-in date (date-only, ISO 8601)"},"treasury_operators":{"example":["64f0a1b2c3d4e5f600112233","64f0a1b2c3d4e5f600445566"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Employee ids permitted to transfer funds from this account (the wallet's employees_allowed_to_make_payments). Drives the Treasury Operators panel."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"investment_permissions":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentPermissionGrantDto"}},"available_balance":{"description":"Live Britam balance for the account (uncached upstream call).","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"pending_investment":{"description":"Aggregate pending-investment total awaiting custodian confirmation.","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"native_currency":{"type":"string","description":"Currency of the native account totals.","example":"KES"}},"required":["fund_account_id","fund_id","fund_name","vendor","product","currency","state","invested","native_currency"]}},"components/schemas/InterestSeriesResponseDto":{"id":"components/schemas/InterestSeriesResponseDto","kind":"json-schema","title":"InterestSeriesResponseDto","data":{"type":"object","properties":{"range":{"type":"string","enum":["7D","1M","3M","ALL"]},"currency":{"type":"string","example":"KES"},"series":{"type":"array","items":{"$ref":"#/components/schemas/InterestSeriesPointDto"}},"total_interest":{"type":"number","example":1284.56,"description":"Sum of series.amount within range"}},"required":["range","currency","series","total_interest"]}},"components/schemas/ProjectionsResponseDto":{"id":"components/schemas/ProjectionsResponseDto","kind":"json-schema","title":"ProjectionsResponseDto","data":{"type":"object","properties":{"yield_used":{"type":"number","example":8.2,"description":"Annualised yield used for projection (percent)"},"yield_unit":{"type":"string","example":"percent"},"daily_interest":{"type":"number","example":22.47,"description":"Implied daily interest, native currency"},"currency":{"type":"string","example":"KES"},"horizons":{"type":"array","items":{"$ref":"#/components/schemas/ProjectionHorizonDto"}}},"required":["yield_used","yield_unit","daily_interest","currency","horizons"]}},"components/schemas/InvestmentTransactionsResponseDto":{"id":"components/schemas/InvestmentTransactionsResponseDto","kind":"json-schema","title":"InvestmentTransactionsResponseDto","data":{"type":"object","properties":{"docs":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentTransactionDto"}},"page":{"type":"number","example":1},"page_size":{"type":"number","example":25},"total":{"type":"number","example":142}},"required":["docs","page","page_size","total"]}},"components/schemas/OptInRequestDto":{"id":"components/schemas/OptInRequestDto","kind":"json-schema","title":"OptInRequestDto","data":{"type":"object","properties":{"fund_id":{"type":"string","example":"fund_britam_kes_mmf","description":"Catalogue fund id"},"amount":{"type":"number","example":100000,"description":"Initial allocation, native currency"},"currency":{"type":"string","enum":["KES","USD"]},"accepted_terms":{"type":"boolean","example":true,"description":"Must be true"}},"required":["fund_id","amount","currency","accepted_terms"]}},"components/schemas/OptInResponseDto":{"id":"components/schemas/OptInResponseDto","kind":"json-schema","title":"OptInResponseDto","data":{"type":"object","properties":{"fund_account_id":{"type":"string","example":"fa_01HXYZ..."},"state":{"type":"string","example":"opt_in_pending"},"message":{"type":"string","example":"opt-in approval requested"}},"required":["fund_account_id","state","message"]}},"components/schemas/OptInApprovalResponseDto":{"id":"components/schemas/OptInApprovalResponseDto","kind":"json-schema","title":"OptInApprovalResponseDto","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OptInApprovalRequestDto"},"message":{"type":"string","example":"Investment opt-in request fetched"}},"required":["data"]}},"components/schemas/InvestRequestDto":{"id":"components/schemas/InvestRequestDto","kind":"json-schema","title":"InvestRequestDto","data":{"type":"object","properties":{"amount":{"type":"number","example":50000,"description":"Top-up amount, native currency"}},"required":["amount"]}},"components/schemas/InvestResponseDto":{"id":"components/schemas/InvestResponseDto","kind":"json-schema","title":"InvestResponseDto","data":{"type":"object","properties":{"reference":{"type":"string","example":"inv_01HXYZ..."},"status":{"type":"string","example":"PROCESSING"}},"required":["reference","status"]}},"components/schemas/TopUpRequestDto":{"id":"components/schemas/TopUpRequestDto","kind":"json-schema","title":"TopUpRequestDto","data":{"type":"object","properties":{"source_wallet_id":{"type":"string","example":"W123456","description":"Business wallet to debit"},"amount":{"type":"number","example":10000,"maximum":1000000000},"currency":{"type":"string","example":"KES"},"reference":{"type":"string","example":"MMF-TOPUP-..."}},"required":["source_wallet_id","amount","currency","reference"]}},"components/schemas/WithdrawRequestDto":{"id":"components/schemas/WithdrawRequestDto","kind":"json-schema","title":"WithdrawRequestDto","data":{"type":"object","properties":{"amount":{"type":"number","example":25000,"description":"Withdrawal amount, native currency"}},"required":["amount"]}},"components/schemas/WithdrawResponseDto":{"id":"components/schemas/WithdrawResponseDto","kind":"json-schema","title":"WithdrawResponseDto","data":{"type":"object","properties":{"reference":{"type":"string","example":"wd_01HXYZ..."},"status":{"type":"string","example":"PROCESSING"}},"required":["reference","status"]}},"components/schemas/InvestmentAccountPermissionsDto":{"id":"components/schemas/InvestmentAccountPermissionsDto","kind":"json-schema","title":"InvestmentAccountPermissionsDto","data":{"type":"object","properties":{"fund_account_id":{"type":"string","example":"fa_01HXYZ...","description":"Customer's fund account ID"},"investment_wallet_id":{"type":"string","example":"I622957","description":"Boya wallet id backing the investment account."},"treasury_operators":{"example":["64f0a1b2c3d4e5f600112233","64f0a1b2c3d4e5f600445566"],"description":"Employee ids permitted to transfer funds from this account (treasury operators).","type":"array","items":{"type":"string"}},"grants":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentPermissionGrantDto"}}},"required":["fund_account_id","treasury_operators","grants"]}},"components/schemas/UpdateInvestmentPermissionsRequestDto":{"id":"components/schemas/UpdateInvestmentPermissionsRequestDto","kind":"json-schema","title":"UpdateInvestmentPermissionsRequestDto","data":{"type":"object","properties":{"treasury_operators":{"example":["64f0a1b2c3d4e5f600112233","64f0a1b2c3d4e5f600445566"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full replacement list of employee ids permitted to transfer funds from this account. Sent wholesale — the upstream replaces the wallet permission list with exactly these ids."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"grants":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentPermissionGrantDto"}}},"required":["treasury_operators"]}},"components/schemas/PortfolioResponseDto":{"id":"components/schemas/PortfolioResponseDto","kind":"json-schema","title":"PortfolioResponseDto","data":{"type":"object","properties":{"account_count":{"type":"number","example":2},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/FundAccountDetailDto"}},"totals_by_currency":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioCurrencyTotalsDto"}}},"required":["account_count","accounts","totals_by_currency"]}},"components/schemas/PortfolioPerformanceResponseDto":{"id":"components/schemas/PortfolioPerformanceResponseDto","kind":"json-schema","title":"PortfolioPerformanceResponseDto","data":{"type":"object","properties":{"range":{"type":"string","enum":["MTD","YTD","ALL"]},"currencies":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioPerformanceCurrencyDto"}}},"required":["range","currencies"]}},"components/schemas/PortfolioActivityResponseDto":{"id":"components/schemas/PortfolioActivityResponseDto","kind":"json-schema","title":"PortfolioActivityResponseDto","data":{"type":"object","properties":{"range":{"type":"string","enum":["7D","30D","ALL"]},"type":{"type":"string","enum":["ALL","INVESTMENT","INTEREST","WITHDRAWAL"]},"docs":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentTransactionDto"}},"total":{"type":"number","example":42}},"required":["range","type","docs","total"]}},"components/schemas/CreateBillV1Dto":{"id":"components/schemas/CreateBillV1Dto","kind":"json-schema","title":"CreateBillV1Dto","data":{"type":"object","properties":{"invoice_no":{"type":"string","example":"INV-001"},"invoice_amount":{"type":"number","example":12000},"status":{"type":"string","enum":["draft","outstanding"]},"supplier":{"type":"object"},"budget_owner":{"type":"object"},"team":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selected team. The middleware derives budget_owner from its reviewers/employees before forwarding."},"children":[]}]}]}]},"payments":{"type":"array","items":{"type":"string"}},"attachments":{"type":"array","items":{"type":"string"}},"withholding_taxes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","example":"Consulting services - June"},"due_date":{"type":"string","example":"2026-06-30","description":"Due date (YYYY-MM-DD)"},"budget":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Budget ObjectId(s) this bill is assigned to (upstream stores "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"budget: [ObjectId]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"is_draft":{"type":"boolean","example":true,"description":"Whether the bill is saved as a draft"},"category":{"type":"string","description":"Category name"},"category_code":{"type":"string","description":"Category / subcategory code"},"paid_amount":{"type":"number","description":"Amount already paid / to be paid"},"send_on":{"type":"string","description":"Date the bill payment should be sent (YYYY-MM-DD)"},"currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Bill currency"},"wallet_currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Wallet currency"},"original_currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Original currency"},"tags":{"description":"Tag ids attached to the bill","type":"array","items":{"type":"string"}},"fx_rate":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"FX rate at time of bill creation (original → wallet currency)"},"children":[]}]}]}],"example":129.5}},"required":["invoice_no","invoice_amount","supplier"]}},"components/schemas/BulkCreateBillsV1Dto":{"id":"components/schemas/BulkCreateBillsV1Dto","kind":"json-schema","title":"BulkCreateBillsV1Dto","data":{"type":"object","properties":{"bills":{"description":"Bills to create","type":"array","items":{"$ref":"#/components/schemas/CreateBillV1Dto"}}},"required":["bills"]}},"components/schemas/UploadBillFileV1Dto":{"id":"components/schemas/UploadBillFileV1Dto","kind":"json-schema","title":"UploadBillFileV1Dto","data":{"type":"object","properties":{"file":{"type":"string","description":"Base64-encoded file content (no data URI prefix). Maximum supports a 10MB file.","maxLength":14680064},"file_name":{"type":"string","example":"invoice.pdf"},"content_type":{"type":"string","example":"application/pdf"}},"required":["file","file_name","content_type"]}},"components/schemas/BillWorkflowV1Dto":{"id":"components/schemas/BillWorkflowV1Dto","kind":"json-schema","title":"BillWorkflowV1Dto","data":{"type":"object","properties":{"name":{"type":"string","example":"Bill vendor invoice payments"},"description":{"type":"string","example":"Vendor bill payment approval workflow"},"action_type":{"type":"number","example":5},"auto_approval":{"type":"boolean","example":false},"requester_can_approve":{"type":"boolean","example":true},"status":{"type":"string","enum":["active","inactive","archived"]},"type":{"type":"string","enum":["business","team"]},"business":{"type":"string","example":"699f07c39420ef9b3cb0d667","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Business ObjectId the workflow belongs to. Upstream stores and queries workflows by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"business"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so it must be forwarded or the workflow is saved unattached and never listed."},"children":[]}]}]}]},"currency":{"type":"string","example":"KES"},"wallet_currency":{"type":"string","example":"KES"},"original_currency":{"type":"string","example":"KES"},"currency_code":{"type":"string","example":"KES"},"teams":{"example":[],"type":"array","items":{"type":"string"}},"requester_approval_conditions":{"example":[],"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/BillWorkflowStepDto"}}},"required":["name","steps"]}},"components/schemas/UpdateBillV1Dto":{"id":"components/schemas/UpdateBillV1Dto","kind":"json-schema","title":"UpdateBillV1Dto","data":{"type":"object","properties":{"invoice_no":{"type":"string","example":"INV-001"},"invoice_amount":{"type":"number","example":12000},"status":{"type":"string","enum":["draft","outstanding"]},"supplier":{"type":"object"},"budget_owner":{"type":"object"},"team":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selected team. The middleware derives budget_owner from its reviewers/employees before forwarding."},"children":[]}]}]}]},"payments":{"type":"array","items":{"type":"string"}},"attachments":{"type":"array","items":{"type":"string"}},"withholding_taxes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","example":"Consulting services - June"},"due_date":{"type":"string","example":"2026-06-30","description":"Due date (YYYY-MM-DD)"},"budget":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Budget ObjectId(s) this bill is assigned to (upstream stores "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"budget: [ObjectId]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"is_draft":{"type":"boolean","example":true,"description":"Whether the bill is saved as a draft"},"category":{"type":"string","description":"Category name"},"category_code":{"type":"string","description":"Category / subcategory code"},"paid_amount":{"type":"number","description":"Amount already paid / to be paid"},"send_on":{"type":"string","description":"Date the bill payment should be sent (YYYY-MM-DD)"},"currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Bill currency"},"wallet_currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Wallet currency"},"original_currency":{"type":"string","enum":["KES","USD","UGX"],"description":"Original currency"},"tags":{"description":"Tag ids attached to the bill","type":"array","items":{"type":"string"}},"fx_rate":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"FX rate at time of bill creation (original → wallet currency)"},"children":[]}]}]}],"example":129.5}}}},"components/schemas/AddVendorPaymentMethodV1Dto":{"id":"components/schemas/AddVendorPaymentMethodV1Dto","kind":"json-schema","title":"AddVendorPaymentMethodV1Dto","data":{"type":"object","properties":{"channel":{"type":"string","example":"bank","description":"Payment channel type"},"bank_code":{"type":"string","example":"01","description":"Bank code"},"bankCode":{"type":"string","example":"01","description":"Bank code alternative field"},"bank":{"type":"string","example":"Equity Bank","description":"Bank name"},"account_number":{"type":"string","example":"1234567890","description":"Account number"},"accno":{"type":"string","example":"1234567890","description":"Account number alternative field"},"phone":{"type":"string","example":712345678,"description":"Phone number for mobile payments"},"till":{"type":"string","example":"123456","description":"Till number"},"till_no":{"type":"string","example":"123456","description":"Till number alternative field"},"business_no":{"type":"string","example":"247247","description":"Paybill business number"},"is_default":{"type":"boolean","example":true,"description":"Whether this is the default method"}},"required":["channel"]}},"components/schemas/AddBillAttachmentV1Dto":{"id":"components/schemas/AddBillAttachmentV1Dto","kind":"json-schema","title":"AddBillAttachmentV1Dto","data":{"type":"object","properties":{"file_name":{"type":"string","example":"invoice.pdf"},"url":{"type":"string","description":"URL returned by the upload endpoint"},"content_type":{"type":"string","example":"application/pdf"},"size":{"type":"number","example":102400}},"required":["file_name","url","content_type"]}},"components/schemas/AddBillPaymentV1Dto":{"id":"components/schemas/AddBillPaymentV1Dto","kind":"json-schema","title":"AddBillPaymentV1Dto","data":{"type":"object","properties":{"amount":{"type":"number","description":"Payment amount"},"status":{"type":"string","enum":["draft","pending","outstanding"]},"is_tax_payment":{"type":"boolean","description":"Marks this as a tax remittance payment"},"withholding_taxes":{"description":"WithHoldingTax ObjectIds linked to this payment","type":"array","items":{"type":"object"}},"payment_instruction":{"type":"object","description":"Selected payment instruction"},"source":{"type":"string","description":"Source wallet reference/id"},"source_name":{"type":"string","description":"Source wallet display name"},"budget":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Budget ObjectId(s) funding this payment. Upstream links the budget to the payment (schema: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"budget: [ObjectId]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"send_on":{"type":"string","description":"Date the bill payment should be sent (YYYY-MM-DD)"},"idempotency_key":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idempotency key making this payment safe to retry. Also accepted as the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Idempotency-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header; forwarded upstream so a retry is deduped instead of double-charging."},"children":[]}]}]}]}}}},"components/schemas/RejectBillPaymentV1Dto":{"id":"components/schemas/RejectBillPaymentV1Dto","kind":"json-schema","title":"RejectBillPaymentV1Dto","data":{"type":"object","properties":{"reason":{"type":"string","example":"Incorrect invoice details"}},"required":["reason"]}},"components/schemas/WithdrawBillApprovalV1Dto":{"id":"components/schemas/WithdrawBillApprovalV1Dto","kind":"json-schema","title":"WithdrawBillApprovalV1Dto","data":{"type":"object","properties":{"reason":{"type":"string","example":"Withdrawn by initiator"}}}},"components/schemas/StringArrayFilterDto":{"id":"components/schemas/StringArrayFilterDto","kind":"json-schema","title":"StringArrayFilterDto","data":{"type":"object","properties":{"data":{"description":"Array of selected filter ids","example":["cat-1","cat-2"],"type":"array","items":{"type":"string"}}}}},"components/schemas/SubcategoryDto":{"id":"components/schemas/SubcategoryDto","kind":"json-schema","title":"SubcategoryDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Subcategory MongoDB ID"},"category":{"description":"Category details","allOf":[{"$ref":"#/components/schemas/CategoryDto"}]},"code":{"type":"string","description":"Subcategory code"},"name":{"type":"string","description":"Subcategory name"}}}},"components/schemas/TeamDto":{"id":"components/schemas/TeamDto","kind":"json-schema","title":"TeamDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Team MongoDB ID"},"name":{"type":"string","description":"Team name"},"code":{"type":"string","description":"Team code"}}}},"components/schemas/TagDto":{"id":"components/schemas/TagDto","kind":"json-schema","title":"TagDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tag MongoDB ID"},"name":{"type":"string","description":"Tag name"},"tag_group":{"type":"string","description":"Tag group ID"},"employee":{"description":"Employee info","allOf":[{"$ref":"#/components/schemas/EmployeeInfoDto"}]},"is_deleted":{"type":"boolean","description":"Is deleted flag"},"__v":{"type":"number","description":"Version key"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"teams":{"description":"Associated team IDs","type":"array","items":{"type":"string"}}}}},"components/schemas/ScanDto":{"id":"components/schemas/ScanDto","kind":"json-schema","title":"ScanDto","data":{"type":"object","properties":{"scanId":{"type":"string","description":"Scan ID"},"total":{"type":"object","description":"Total amount from scan"},"date":{"type":"string","description":"Date from scan"},"vendorNames":{"type":"string","description":"Vendor names from scan"},"taxValidity":{"description":"Tax validity info","allOf":[{"$ref":"#/components/schemas/TaxValidityDto"}]},"lineItems":{"description":"Line items from scan","type":"array","items":{"$ref":"#/components/schemas/LineItemDto"}},"taxCompliant":{"type":"boolean","description":"Tax compliant flag"},"expenseAmountMatchesTotal":{"type":"boolean","description":"Expense amount matches total flag"},"validityScore":{"type":"number","description":"Validity score"},"caption":{"type":"string","description":"Validity caption"}}}},"components/schemas/LineItemDto":{"id":"components/schemas/LineItemDto","kind":"json-schema","title":"LineItemDto","data":{"type":"object","properties":{"description":{"type":"string","description":"Item description"},"price":{"type":"number","description":"Item price"},"quantity":{"type":"number","description":"Item quantity"}}}},"components/schemas/EmployeeInfoDto":{"id":"components/schemas/EmployeeInfoDto","kind":"json-schema","title":"EmployeeInfoDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Employee MongoDB ID"},"name":{"type":"string","description":"Employee name"},"organization_email":{"type":"string","description":"Employee organization email"},"tags":{"description":"Employee tags","type":"array","items":{"type":"string"}},"supervisor":{"type":"object","description":"Employee supervisor"},"customer_id":{"type":"string","description":"Customer ID"},"customer_name":{"type":"string","description":"Customer name"}}}},"components/schemas/ReviewDto":{"id":"components/schemas/ReviewDto","kind":"json-schema","title":"ReviewDto","data":{"type":"object","properties":{"person":{"type":"string","description":"Reviewer person name"},"notes":{"type":"string","description":"Review notes"},"employee_id":{"type":"string","description":"Reviewer employee ID"},"status":{"type":"string","description":"Review status"},"_id":{"type":"string","description":"Review MongoDB ID"},"reviewed_on":{"type":"string","description":"Review timestamp"}}}},"components/schemas/CategoryReportDataDto":{"id":"components/schemas/CategoryReportDataDto","kind":"json-schema","title":"CategoryReportDataDto","data":{"type":"object","properties":{"labels":{"description":"Category labels","example":["Freight & Logistics","Test 1","B2B Wholesale Sales"],"type":"array","items":{"type":"string"}},"data":{"description":"Dataset containing data and colors","type":"array","items":{"$ref":"#/components/schemas/CategoryReportDatasetDto"}},"total":{"type":"number","description":"Total amount across all categories","example":1496}},"required":["labels","data","total"]}},"components/schemas/EmployeeDto":{"id":"components/schemas/EmployeeDto","kind":"json-schema","title":"EmployeeDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Employee MongoDB ID"},"name":{"type":"string","description":"Employee name"},"employee_id":{"type":"string","description":"Employee ID"},"role":{"type":"string","description":"Employee role"}}}},"components/schemas/ApprovalRequestDto":{"id":"components/schemas/ApprovalRequestDto","kind":"json-schema","title":"ApprovalRequestDto","data":{"type":"object","properties":{"ref":{"type":"string","description":"Unique approval request reference"},"narrative":{"type":"string","description":"Approval request narrative"},"initiated_by":{"type":"string","description":"Employee ObjectId who initiated the request"},"initiated_on":{"type":"string","description":"Timestamp when request was initiated"},"business":{"type":"string","description":"Business ObjectId"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request status: 0=pending, 1=approved, 2=rejected"},"children":[]}]}]}]},"is_batch":{"type":"boolean","description":"Is batch request"},"action_type":{"type":"number","description":"Action type enum value"},"mandate":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mandate — number of approvals required"},"children":[]}]}]}]},"participants":{"description":"Approval participants","type":"array","items":{"$ref":"#/components/schemas/ApprovalParticipantDto"}},"records":{"description":"Associated transaction records","type":"array","items":{"type":"object"}},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"card":{"type":"string","description":"Associated card ObjectId"},"auto_approve":{"type":"boolean","description":"Auto approve flag"},"source":{"type":"string","description":"Source of request"},"attachments":{"description":"Attachment file references","type":"array","items":{"type":"string"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"}}}},"components/schemas/CustomerObjectDto":{"id":"components/schemas/CustomerObjectDto","kind":"json-schema","title":"CustomerObjectDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Customer MongoDB ObjectId","example":"69dd1e56d2756bba9fa9983b"},"name":{"type":"string","description":"Customer display name","example":"Giraffe Center"},"email":{"type":"string","example":"giraffe@acme.com"},"phone":{"type":"string","example":"+254700000012"},"address":{"type":"string","example":"123 Karen Street, Nairobi"},"type":{"type":"string","example":"regular","enum":["regular","walkIn"]},"status":{"type":"string","example":"active","enum":["active","deleted"]},"person":{"example":["123"],"type":"array","items":{"type":"string"}},"taxPin":{"type":"string","example":"A123456789Z"}},"required":["_id","name"]}},"components/schemas/TagObjectDto":{"id":"components/schemas/TagObjectDto","kind":"json-schema","title":"TagObjectDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tag document ID","example":"68a2de3b73b7e53060aca3df"},"tag_group":{"type":"string","description":"Tag group ID this tag belongs to","example":"68a2de0194af89ac7c37aaa9"},"name":{"type":"string","description":"Tag display name","example":"Safaricom"},"employee":{"description":"Employee who owns the tag","allOf":[{"$ref":"#/components/schemas/TagEmployeeDto"}]},"teams":{"description":"Teams this tag is scoped to","type":"array","items":{"type":"string"}},"is_deleted":{"type":"boolean","description":"Whether the tag is deleted","example":false},"tag_group_name":{"type":"string","description":"Tag group name","example":"Projects"},"mapping_id":{"type":"string","description":"Mapping ID","example":"bfabdae2-ea2a-41f4-a838-b08494b93674"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"__v":{"type":"number"}},"required":["_id","tag_group","name"]}},"components/schemas/PhysicalCardOrderV1Dto":{"id":"components/schemas/PhysicalCardOrderV1Dto","kind":"json-schema","title":"PhysicalCardOrderV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Card MongoDB ID"},"vcn":{"type":"string","description":"Virtual card number (raw)"},"ref":{"type":"string","description":"Card reference"},"last4":{"type":"string","description":"Last 4 digits of card"},"bin":{"type":"string","description":"BIN number"},"name":{"type":"string","description":"Card name/label"},"brand":{"type":"string","description":"Card brand (VISA, Mastercard, etc.)"},"provider":{"type":"string","description":"Card provider/issuer"},"employee":{"description":"Employee details","allOf":[{"$ref":"#/components/schemas/EmployeeDto"}]},"business":{"type":"string","description":"Business ID"},"account":{"type":"string","description":"Account ID"},"user":{"type":"string","description":"User ID"},"exp_month":{"type":"string","description":"Expiration month (MM)"},"exp_year":{"type":"string","description":"Expiration year (YY or YYYY)"},"basis_fingerprint":{"type":"string","description":"Basis fingerprint for security"},"blocked":{"type":"boolean","description":"Is card blocked"},"retired":{"type":"boolean","description":"Is card retired"},"dormant":{"type":"boolean","description":"Is card dormant"},"purged":{"type":"boolean","description":"Is card purged"},"verified":{"type":"boolean","description":"Is card verified"},"is_virtual":{"type":"boolean","description":"Is virtual card"},"is_offline":{"type":"boolean","description":"Is offline card"},"physical_pin_set":{"type":"boolean","description":"Physical PIN is set"},"subscription_card":{"type":"boolean","description":"Is subscription card"},"balance":{"type":"number","description":"Current card balance"},"currency":{"type":"string","description":"Card currency"},"tracking_number":{"type":"string","description":"Card delivery tracking number"},"issued_on":{"type":"string","description":"Card issued on timestamp"},"issued_by":{"type":"string","description":"Card issued by user"},"updated_by":{"type":"string","description":"Card updated by user"},"blocked_by":{"type":"string","description":"Blocked by user ID"},"frisk":{"type":"number","description":"Risk/frisk level"},"wallet_type":{"type":"string","description":"Wallet type"},"works_only_at":{"description":"Places where card works only","type":"array","items":{"type":"string"}},"works_only_at_mid":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MID restrictions for works_only_at"},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"works_everywhere_except":{"description":"Places where card is blocked","type":"array","items":{"type":"string"}},"category_spend_limits":{"description":"Category spending limits","type":"array","items":{"type":"object"}},"events":{"description":"Card events history","type":"array","items":{"type":"object"}},"org_wallet_ref":{"type":"number","description":"Organization wallet reference"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"statusDisplay":{"type":"string","description":"Card status display name"},"typeDisplay":{"type":"string","description":"Card type display name"},"isActive":{"type":"boolean","description":"Is card active"},"isExpired":{"type":"boolean","description":"Is card expired"},"expiryFormatted":{"type":"string","description":"Formatted expiry date"},"employeeName":{"type":"string","description":"Employee name from employee object"},"employeeId":{"type":"string","description":"Employee ID from employee object"},"approval_request":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approval request object — present only for SINGLE USE PREPAID cards"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ApprovalRequestDto"}]},"approved_by":{"type":"string","description":"Person who approved the order"},"invoice_no":{"type":"string","description":"Invoice number"},"delivery_address":{"type":"string","description":"Full delivery address"},"wallet_id":{"type":"string","description":"Wallet ID"},"linked":{"type":"boolean","description":"Is linked"},"status":{"type":"string","description":"Order status","example":"printing"}}}},"components/schemas/ApprovalDto":{"id":"components/schemas/ApprovalDto","kind":"json-schema","title":"ApprovalDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"698eae9e8e02c65ba2c4d0ea"},"id":{"type":"string","example":"698eae9e8e02c65ba2c4d0ea"},"ref":{"type":"string","example":"SUB-84f6ecb209"},"narrative":{"type":"string","example":"Rob is requesting creation of a Lucidchart subscription"},"initiated_by":{"type":"string","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"business":{"$ref":"#/components/schemas/ApprovalBusinessDto"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0 = pending, 1 = approved, 2 = rejected"},"children":[]}]}]}],"example":0},"is_batch":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0 = single, 1 = batch"},"children":[]}]}]}],"example":0},"action_type":{"type":"number","enum":[1,2,3,4,5,6,7,8,9,10,11,12],"example":12},"mandate":{"type":"number","example":1},"participants":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalParticipantDto"}},"records":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalRecordDto"}},"callback_url":{"type":"string","example":"https://api.boyahq.com/subscription/process-subscription-request"},"org_wallet_ref":{"type":"string","example":"5"},"is_expenses_batch":{"type":"boolean","example":false},"auto_approve":{"type":"boolean","example":false},"isPolicyrequest":{"type":"boolean","example":false},"budget":{"type":"object"},"initiated_on":{"type":"string","example":"2026-02-13T04:54:54.492Z"},"createdAt":{"type":"string","example":"2026-02-13T04:54:54.493Z"},"updatedAt":{"type":"string","example":"2026-02-13T04:55:35.967Z"},"attachments":{"type":"array","items":{"type":"string"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalEventDto"}},"request_status":{"type":"number","example":0},"initiatedByName":{"type":"string","example":"Rob"},"business_id":{"type":"string","example":"zyatjjbfhwwrzzmpgrpsbkcpnldfge"},"email":{"type":"string","example":"rob@boyahq.com"},"phone":{"type":"string","example":"+254710702289"},"requested_on":{"type":"string","example":"2026-02-13T14:26:47Z"},"updated_on":{"type":"string","example":"2026-02-13T07:55:35Z"}},"required":["_id","id","ref","narrative","initiated_by","business","status","is_batch","action_type","mandate","participants","records","org_wallet_ref","is_expenses_batch","auto_approve","isPolicyrequest","initiated_on","createdAt","updatedAt","request_status","initiatedByName","business_id","requested_on","updated_on"]}},"components/schemas/ApprovalContextDto":{"id":"components/schemas/ApprovalContextDto","kind":"json-schema","title":"ApprovalContextDto","data":{"type":"object","properties":{"id":{"type":"string","example":"698eae9e8e02c65ba2c4d0ea"},"ref":{"type":"string","example":"SUB-84f6ecb209"},"approvalType":{"type":"number","enum":[1,2,3,4,5,6,7,8,9,10,11,12],"example":12},"approvalTypeLabel":{"type":"string","example":"Subscription"},"icon":{"type":"string","example":"autorenew"},"color":{"type":"string","example":"#06b6d4"},"title":{"type":"string","example":"Subscription - KES 5,000"},"narrative":{"type":"string","example":"Rob is requesting creation of a Lucidchart subscription"},"amount":{"type":"number","example":5000},"currency":{"type":"string","example":"KES"},"requester":{"$ref":"#/components/schemas/RequesterDto"},"approvalChain":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalStepDto"}},"currentApprover":{"$ref":"#/components/schemas/ApprovalStepDto"},"pendingApprovers":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalStepDto"}},"completedApprovers":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalStepDto"}},"riskScore":{"type":"string","enum":["low","medium","high","critical"],"example":"medium"},"riskFactors":{"example":["High value: KES 50,000","After-hours submission"],"type":"array","items":{"type":"string"}},"tags":{"example":["Subscription","Urgent","High Value"],"type":"array","items":{"type":"string"}},"requestedAt":{"format":"date-time","type":"string","example":"2026-02-13T04:54:54.492Z"},"timeSinceRequest":{"type":"string","example":"2d ago"},"lastActionAt":{"format":"date-time","type":"string","example":"2026-02-13T04:55:35.810Z"},"isUrgent":{"type":"boolean","example":true},"isOverdue":{"type":"boolean","example":false},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0=pending, 1=approved, 2=rejected"},"children":[]}]}]}],"example":0},"statusLabel":{"type":"string","example":"Pending Approval"},"progress":{"$ref":"#/components/schemas/ApprovalProgressDto"},"isBatch":{"type":"boolean","example":false},"batchSize":{"type":"number","example":5},"isPolicyBased":{"type":"boolean","example":false},"isAutoApproveEligible":{"type":"boolean","example":false},"records":{"type":"array","items":{"type":"object"}},"payout":{"type":"object","description":"Payout summary for PAYOUT approval types"},"invoice":{"type":"object","description":"Invoice details for INVOICE approval types"},"events":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalEventDigestDto"}},"availableActions":{"example":["approve","reject","view_details"],"type":"array","items":{"type":"string"}},"recommendedAction":{"type":"string","enum":["approve","review","reject","request_info"],"example":"review"}},"required":["id","ref","approvalType","approvalTypeLabel","icon","color","title","narrative","requester","approvalChain","pendingApprovers","completedApprovers","riskScore","riskFactors","tags","requestedAt","timeSinceRequest","isUrgent","isOverdue","status","statusLabel","progress","isBatch","isPolicyBased","isAutoApproveEligible","records","events","availableActions"]}},"components/schemas/PaginatedDataDto":{"id":"components/schemas/PaginatedDataDto","kind":"json-schema","title":"PaginatedDataDto","data":{"type":"object","properties":{"total":{"type":"number","description":"Total number of items","example":100},"pages":{"type":"number","description":"Total number of pages","example":10},"page":{"type":"number","description":"Current page number","example":1},"limit":{"type":"number","description":"Number of items per page","example":10},"docs":{"type":"array","description":"Array of items"}},"required":["total","pages","page","limit","docs"]}},"components/schemas/CashflowReportDataDto":{"id":"components/schemas/CashflowReportDataDto","kind":"json-schema","title":"CashflowReportDataDto","data":{"type":"object","properties":{"accounts":{"description":"Array of account cashflow details","type":"array","items":{"$ref":"#/components/schemas/CashflowAccountDto"}},"summary":{"description":"Summary totals","allOf":[{"$ref":"#/components/schemas/CashflowSummaryDto"}]},"period":{"description":"Report period","allOf":[{"$ref":"#/components/schemas/CashflowPeriodDto"}]}},"required":["accounts","summary","period"]}},"components/schemas/ReservationDto":{"id":"components/schemas/ReservationDto","kind":"json-schema","title":"ReservationDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Reservation ID"},"amount":{"type":"number","description":"Reserved amount"},"purpose":{"type":"string","description":"Reservation purpose"},"employee_id":{"type":"string","description":"Employee ID who made reservation"},"status":{"type":"string","description":"Reservation status"},"createdAt":{"type":"string","description":"Created timestamp"},"expiresAt":{"type":"string","description":"Expiry timestamp"}}}},"components/schemas/OwnerDto":{"id":"components/schemas/OwnerDto","kind":"json-schema","title":"OwnerDto","data":{"type":"object","properties":{"name":{"type":"string","description":"Employee name"},"role":{"type":"string","description":"Owner role (OWNER, ADMIN, etc.)"},"_id":{"type":"string","description":"Owner record ID"}}}},"components/schemas/AlertContactDto":{"id":"components/schemas/AlertContactDto","kind":"json-schema","title":"AlertContactDto","data":{"type":"object","properties":{"name":{"type":"string","description":"Contact name"},"email":{"type":"string","description":"Contact email"},"phone":{"type":"string","description":"Contact phone number"}}}},"components/schemas/ConfigurationDto":{"id":"components/schemas/ConfigurationDto","kind":"json-schema","title":"ConfigurationDto","data":{"type":"object","properties":{"key":{"type":"string","description":"Configuration key"},"value":{"type":"object","description":"Configuration value"},"description":{"type":"string","description":"Configuration description"},"is_active":{"type":"boolean","description":"Is active flag"}}}},"components/schemas/RuleDto":{"id":"components/schemas/RuleDto","kind":"json-schema","title":"RuleDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Rule ID"},"operation":{"type":"string","description":"Rule operation"},"enabled":{"type":"boolean","description":"Is enabled flag"}}}},"components/schemas/BankInfoDto":{"id":"components/schemas/BankInfoDto","kind":"json-schema","title":"BankInfoDto","data":{"type":"object","properties":{"name":{"type":"string","description":"Bank name"},"accountNumber":{"type":"string","description":"Bank account number"},"accountName":{"type":"string","description":"Bank account name"},"branchName":{"type":"string","description":"Bank branch name"},"swiftCode":{"type":"string","description":"SWIFT code"},"bankCode":{"type":"string","description":"Bank code"},"businessNumber":{"type":"string","description":"Mpesa Paybill Business number"},"country":{"type":"string","description":"Country code"},"bank_logo_url":{"type":"string","description":"Bank logo"}}}},"components/schemas/DepositInstructionsDto":{"id":"components/schemas/DepositInstructionsDto","kind":"json-schema","title":"DepositInstructionsDto","data":{"type":"object","properties":{"bank":{"description":"Bank wire transfer instructions","allOf":[{"$ref":"#/components/schemas/BankDepositInstructionsDto"}]},"mpesa":{"description":"M-Pesa Pay Bill instructions (KES only)","allOf":[{"$ref":"#/components/schemas/MpesaDepositInstructionsDto"}]}}}},"components/schemas/ExpenseTagDto":{"id":"components/schemas/ExpenseTagDto","kind":"json-schema","title":"ExpenseTagDto","data":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID"},"tagGroupId":{"type":"string","description":"Tag group ID"},"name":{"type":"string","description":"Tag name"},"employee":{"type":"object","description":"Employee"}},"required":["id","tagGroupId","name"]}},"components/schemas/MoneyMovementDataDto":{"id":"components/schemas/MoneyMovementDataDto","kind":"json-schema","title":"MoneyMovementDataDto","data":{"type":"object","properties":{"moneyIn":{"description":"Money in details","allOf":[{"$ref":"#/components/schemas/MoneyInDto"}]},"moneyOut":{"description":"Money out details","allOf":[{"$ref":"#/components/schemas/MoneyOutDto"}]}},"required":["moneyIn","moneyOut"]}},"components/schemas/IftDto":{"id":"components/schemas/IftDto","kind":"json-schema","title":"IftDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"IFT MongoDB ID"},"ref":{"type":"string","description":"Reference number"},"amount":{"type":"number","description":"Transaction amount (negative for debits)"},"description":{"type":"string","description":"Transaction description"},"account":{"type":"string","description":"Account number"},"person":{"type":"string","description":"Person name"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"currency":{"type":"string","description":"Currency code"},"created_by":{"type":"string","description":"Created by user ID"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/TopupDto":{"id":"components/schemas/TopupDto","kind":"json-schema","title":"TopupDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Topup MongoDB ID"},"ref":{"type":"string","description":"Reference number"},"description":{"type":"string","description":"Topup description"},"amount":{"type":"number","description":"Topup amount"},"account":{"type":"string","description":"Account number"},"channel":{"type":"string","description":"Payment channel (MPESA, etc.)"},"is_employee_topup":{"type":"boolean","description":"Employee topup flag"},"exported":{"type":"boolean","description":"Exported flag"},"sync_successful":{"type":"boolean","description":"Sync successful flag"},"created_by":{"type":"string","description":"Created by user ID"},"status":{"type":"string","description":"Topup status"},"subcategory":{"description":"Subcategory details","allOf":[{"$ref":"#/components/schemas/SubcategoryDto"}]},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"attachments":{"description":"Attachment URLs","type":"array","items":{"type":"string"}}}}},"components/schemas/RefundDto":{"id":"components/schemas/RefundDto","kind":"json-schema","title":"RefundDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Refund MongoDB ID"},"ref":{"type":"string","description":"Reference number"},"transaction_ref":{"type":"string","description":"Transaction reference"},"description":{"type":"string","description":"Refund description"},"amount":{"type":"number","description":"Refund amount"},"account":{"type":"string","description":"Account number"},"employee_id":{"type":"string","description":"Employee ID"},"status":{"type":"string","description":"Refund status"},"vendor":{"type":"string","description":"Refund vendor"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"currency":{"type":"string","description":"Currency code"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/BulkCreateCategoryItemV1Dto":{"id":"components/schemas/BulkCreateCategoryItemV1Dto","kind":"json-schema","title":"BulkCreateCategoryItemV1Dto","data":{"type":"object","properties":{"category":{"type":"string","description":"Category name (will be used as group)","example":"Office Expenses"},"subcategory":{"type":"string","description":"Subcategory name","example":"Water Bill"},"code":{"type":"string","description":"Subcategory code","example":"405034"},"description":{"type":"string","description":"Subcategory description","example":"Water bill"}},"required":["category","subcategory","description"]}},"components/schemas/TeamReviewerDto":{"id":"components/schemas/TeamReviewerDto","kind":"json-schema","title":"TeamReviewerDto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID"},"name":{"type":"string","description":"Reviewer name"},"read_only":{"type":"boolean","description":"Read-only access flag"},"added_by":{"type":"string","description":"Added by user"},"_id":{"type":"string","description":"Reviewer MongoDB ID"},"added_on":{"type":"string","description":"Date added"}}}},"components/schemas/TeamAlertDto":{"id":"components/schemas/TeamAlertDto","kind":"json-schema","title":"TeamAlertDto","data":{"type":"object","properties":{"employee_id":{"type":"string","description":"Employee ID"},"phone":{"type":"string","description":"Phone number"},"name":{"type":"string","description":"Name"},"currency":{"description":"Currencies","type":"array","items":{"type":"string"}},"_id":{"type":"string","description":"Alert MongoDB ID"}}}},"components/schemas/TeamBudgetDto":{"id":"components/schemas/TeamBudgetDto","kind":"json-schema","title":"TeamBudgetDto","data":{"type":"object","properties":{"currency":{"type":"string","description":"Currency code"},"amount":{"type":"number","description":"Budget amount"},"_id":{"type":"string","description":"Budget MongoDB ID"}}}},"components/schemas/TeamLimitDto":{"id":"components/schemas/TeamLimitDto","kind":"json-schema","title":"TeamLimitDto","data":{"type":"object","properties":{"currency":{"type":"string","description":"Currency code"},"amount":{"type":"number","description":"Limit amount"},"_id":{"type":"string","description":"Limit MongoDB ID"}}}},"components/schemas/TeamBalanceDto":{"id":"components/schemas/TeamBalanceDto","kind":"json-schema","title":"TeamBalanceDto","data":{"type":"object","properties":{"currency":{"type":"string","description":"Currency code"},"balance":{"type":"number","description":"Current balance"}}}},"components/schemas/TeamWalletDto":{"id":"components/schemas/TeamWalletDto","kind":"json-schema","title":"TeamWalletDto","data":{"type":"object","properties":{"walletId":{"type":"string","description":"Wallet ID"},"accountNumber":{"type":"string","description":"Account number"},"availableBalance":{"type":"number","description":"Available balance"},"name":{"type":"string","description":"Wallet name"}}}},"components/schemas/EmployeeWalletDto":{"id":"components/schemas/EmployeeWalletDto","kind":"json-schema","title":"EmployeeWalletDto","data":{"type":"object","properties":{"boya_accno":{"type":"string","description":"Boya account number"},"walletId":{"type":"string","description":"Wallet ID"},"currency":{"type":"string","description":"Currency code"},"availableBalance":{"type":"number","description":"Available balance"},"wallet_type":{"type":"string","description":"Wallet type"}}}},"components/schemas/EmployeePermissionsDto":{"id":"components/schemas/EmployeePermissionsDto","kind":"json-schema","title":"EmployeePermissionsDto","data":{"type":"object","properties":{"ALLOCATIONS_INITIATE":{"type":"number","description":"Allocations initiate permission"},"ALLOCATIONS_VIEW":{"type":"number","description":"Allocations view permission"},"BULK:PAYOUTS_INITIATE":{"type":"number","description":"Bulk payouts initiate permission"},"BULK:PAYOUTS_VIEW":{"type":"number","description":"Bulk payouts view permission"},"BUSINESS:STATEMENTS_VIEW":{"type":"number","description":"Business statements view permission"},"BUSINESS:BALANCE_VIEW":{"type":"number","description":"Business balance view permission"},"BUSINESS:BALANCE_EDIT":{"type":"number","description":"Business balance edit permission"},"BUSINESS:TRENDS_VIEW":{"type":"number","description":"Business trends view permission"},"BUSINESS:SETTINGS_VIEW":{"type":"number","description":"Business settings view permission"},"BUSINESS:SETTINGS_EDIT":{"type":"number","description":"Business settings edit permission"},"CARDS_VIEW":{"type":"number","description":"Cards view permission"},"CARDS_EDIT":{"type":"number","description":"Cards edit permission"},"EMPLOYEES:BALANCE_VIEW":{"type":"number","description":"Employees balance view permission"},"PAYROLL_INITIATE":{"type":"number","description":"Payroll initiate permission"},"PAYROLL_VIEW":{"type":"number","description":"Payroll view permission"},"PAYABLES_INITIATE":{"type":"number","description":"Payables initiate permission"},"PAYABLES_VIEW":{"type":"number","description":"Payables view permission"},"PEOPLE_VIEW":{"type":"number","description":"People view permission"},"PEOPLE_EDIT":{"type":"number","description":"People edit permission"},"PEOPLE_ARCHIVE":{"type":"number","description":"People archive permission"},"PEOPLE_ALLOCATE":{"type":"number","description":"People allocate permission"},"EXPENSES_VIEW":{"type":"number","description":"Expenses view permission"},"EXPENSES_EXPORT":{"type":"number","description":"Expenses export permission"},"EXPENSES_REVIEW":{"type":"number","description":"Expenses review permission"},"SETTINGS:CATEGORY_VIEW":{"type":"number","description":"Settings category view permission"},"SETTINGS:CATEGORY_EDIT":{"type":"number","description":"Settings category edit permission"},"SETTINGS:INTEGRATIONS_VIEW":{"type":"number","description":"Settings integrations view permission"},"SETTINGS:INTEGRATIONS_EDIT":{"type":"number","description":"Settings integrations edit permission"},"SETTINGS:ROLES_VIEW":{"type":"number","description":"Settings roles view permission"},"SETTINGS:REPRESENTATIVES_VIEW":{"type":"number","description":"Settings representatives view permission"},"SETTINGS:REPRESENTATIVES_EDIT":{"type":"number","description":"Settings representatives edit permission"},"INVOICE_VIEW":{"type":"number","description":"Invoice view permission"},"INVOICE_EDIT":{"type":"number","description":"Invoice edit permission"},"SUPPLIER_VIEW":{"type":"number","description":"Supplier view permission"},"SUPPLIER_EDIT":{"type":"number","description":"Supplier edit permission"},"SUB:ACCOUNTS_VIEW":{"type":"number","description":"Sub-accounts view permission"},"SUB:ACCOUNTS_EDIT":{"type":"number","description":"Sub-accounts edit permission"},"SUB:ACCOUNTS_ALLOCATE":{"type":"number","description":"Sub-accounts allocate permission"},"BUDGETS_CREATE":{"type":"number","description":"Budgets create permission"},"SUBSCRIPTIONS_VIEW":{"type":"number","description":"Subscriptions view permission"},"EXPENSES:RECEIPT_EDIT":{"type":"number","description":"Expenses receipt edit permission"}}}},"components/schemas/EmployeeTeamDto":{"id":"components/schemas/EmployeeTeamDto","kind":"json-schema","title":"EmployeeTeamDto","data":{"type":"object","properties":{"code":{"type":"string","description":"Team code"},"name":{"type":"string","description":"Team name"},"_id":{"type":"string","description":"Team MongoDB ID"},"status":{"type":"string","description":"Team status"}}}},"components/schemas/StatementItemDto":{"id":"components/schemas/StatementItemDto","kind":"json-schema","title":"StatementItemDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Transaction MongoDB ID"},"currency":{"type":"string","description":"Transaction currency (USD/KES)"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"account":{"type":"string","description":"Account number"},"credit":{"type":"number","description":"Credit amount"},"debit":{"type":"number","description":"Debit amount"},"description":{"type":"string","description":"Transaction description"},"ref":{"type":"string","description":"Transaction reference"},"created_by":{"type":"string","description":"Created by user ID"},"transaction_type":{"type":"string","description":"Transaction type","enum":["IFT","EXPENSE","TOPUP","REFUND","INTERNAL TRANSFER","OVERDRAFT","REPAYMENT","BRANCH TRANSFER"]},"running_balance":{"type":"number","description":"Running account balance"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"id":{"type":"string","description":"Auto-generated ID field"}}}},"components/schemas/UpdateUsersRoleDataV1Dto":{"id":"components/schemas/UpdateUsersRoleDataV1Dto","kind":"json-schema","title":"UpdateUsersRoleDataV1Dto","data":{"type":"object","properties":{"databaseName":{"type":"string","description":"Business database identifier","example":"biz_4badab471100"},"data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permission object with dynamic categories and actions. Each category contains action keys with binary values (0=disabled, 1=enabled)."},"children":[]}]}]}],"additionalProperties":{"type":"object","additionalProperties":{"type":"number","enum":[0,1]}},"example":{"ALLOCATIONS":{"INITIATE":1,"VIEW":1},"BULK:PAYOUTS":{"INITIATE":1,"VIEW":1},"BUSINESS:STATEMENTS":{"VIEW":1}}}}}},"components/schemas/MandateDataV1Dto":{"id":"components/schemas/MandateDataV1Dto","kind":"json-schema","title":"MandateDataV1Dto","data":{"type":"object","properties":{"data":{"description":"Array of mandate objects","type":"array","items":{"$ref":"#/components/schemas/MandateV1Dto"}}}}},"components/schemas/UpdateMandateDataV1Dto":{"id":"components/schemas/UpdateMandateDataV1Dto","kind":"json-schema","title":"UpdateMandateDataV1Dto","data":{"type":"object","properties":{"minimum_approvers":{"type":"number","description":"Minimum number of approvers required for this mandate","example":2,"minimum":1}},"required":["minimum_approvers"]}},"components/schemas/UpdateApproverDataV1Dto":{"id":"components/schemas/UpdateApproverDataV1Dto","kind":"json-schema","title":"UpdateApproverDataV1Dto","data":{"type":"object","properties":{"level":{"type":"number","description":"Approval level/tier in the approval hierarchy","example":1,"minimum":1},"must_approve":{"type":"boolean","description":"Whether this approver must approve (mandatory approval)","example":false}},"required":["level","must_approve"]}},"components/schemas/ApproverWithIdDto":{"id":"components/schemas/ApproverWithIdDto","kind":"json-schema","title":"ApproverWithIdDto","data":{"type":"object","properties":{"level":{"type":"number","description":"Approval level/tier in the approval hierarchy","example":1,"minimum":1},"must_approve":{"type":"boolean","description":"Whether this approver must approve (mandatory approval)","example":false},"_id":{"type":"string","description":"Employee object id","example":"68c2cc82272ac8e89e3f930c"}},"required":["level","must_approve","_id"]}},"components/schemas/CreatePaymentInstructionV1Dto":{"id":"components/schemas/CreatePaymentInstructionV1Dto","kind":"json-schema","title":"CreatePaymentInstructionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment instruction MongoDB ID (for updates)"},"channel":{"type":"string","description":"Payment channel type","enum":["mpesa","mtn","pochi","airtel","xentebanktransfer","bank","rtgs","paybill","till","airtime","internal"],"example":"bank"},"phone":{"type":"string","description":"Phone number for mpesa payments","example":712345678},"accno":{"type":"string","description":"Account number for bank payments","example":"1234567890"},"bank":{"type":"string","description":"Bank name","example":"BANK OF AFRICA K LTD"},"bank_code":{"type":"string","description":"Bank code","example":"19"},"bankCode":{"type":"string","description":"Bank code (alternative field)","example":"19"},"till":{"type":"string","description":"Till number for till payments","example":"123456"},"till_no":{"type":"string","description":"Till number (alternative field)","example":"123456"},"business_no":{"type":"string","description":"Business number for paybill payments","example":"247247"},"is_default":{"type":"boolean","description":"Whether this is the default payment method","example":true}},"required":["channel"]}},"components/schemas/PaymentInstructionV1Dto":{"id":"components/schemas/PaymentInstructionV1Dto","kind":"json-schema","title":"PaymentInstructionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment instruction MongoDB ID"},"channel":{"type":"string","description":"Payment channel type","enum":["mpesa","mtn","pochi","airtel","xentebanktransfer","bank","rtgs","paybill","till","airtime","internal"]},"phone":{"type":"string","description":"Phone number for mpesa payments"},"accno":{"type":"string","description":"Account number for bank payments"},"bank":{"type":"string","description":"Bank name"},"bank_code":{"type":"string","description":"Bank code"},"bankCode":{"type":"string","description":"Bank code (alternative field)"},"till":{"type":"string","description":"Till number for till payments"},"business_no":{"type":"string","description":"Business number for paybill payments"},"is_default":{"type":"boolean","description":"Whether this is the default payment method"}}}},"components/schemas/PaymentInstructionPayloadDto":{"id":"components/schemas/PaymentInstructionPayloadDto","kind":"json-schema","title":"PaymentInstructionPayloadDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment instruction MongoDB ID"},"channel":{"type":"string","description":"Payment channel type","example":"bank"},"phone":{"type":"string","description":"Phone number for mobile payments"},"accno":{"type":"string","description":"Account number for bank payments"},"bank":{"type":"string","description":"Bank name"},"till":{"type":"string","description":"Till number"},"business_no":{"type":"string","description":"Business number for paybill payments"},"till_no":{"type":"string","description":"Till number (alternative field)"},"bankCode":{"type":"string","description":"Bank code"},"bank_code":{"type":"string","description":"Bank code (alternative field)"}}}},"components/schemas/AddPaymentInstructionPayloadDto":{"id":"components/schemas/AddPaymentInstructionPayloadDto","kind":"json-schema","title":"AddPaymentInstructionPayloadDto","data":{"type":"object","properties":{"channel":{"type":"string","description":"Payment channel type","example":"bank"},"phone":{"type":"string","description":"Phone number for mobile payments"},"accno":{"type":"string","description":"Account number for bank payments"},"bank":{"type":"string","description":"Bank name"},"till":{"type":"string","description":"Till number"},"business_no":{"type":"string","description":"Business number for paybill payments"},"till_no":{"type":"string","description":"Till number (alternative field)"},"bankCode":{"type":"string","description":"Bank code"},"bank_code":{"type":"string","description":"Bank code (alternative field)"}}}},"components/schemas/PaymentChannelV1Dto":{"id":"components/schemas/PaymentChannelV1Dto","kind":"json-schema","title":"PaymentChannelV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment channel MongoDB ID"},"method":{"type":"string","description":"Payment method identifier","example":"mpesa"},"name":{"type":"string","description":"Display name for the payment channel","example":"Send Money"},"currency":{"type":"string","description":"Currency code","example":"KES"},"country":{"type":"string","description":"Country code","example":"KENYA"},"status":{"type":"string","description":"Channel status","enum":["ACTIVE","INACTIVE"],"example":"ACTIVE"},"type":{"type":"string","description":"Payment type","example":"SENDMONEY"},"provider":{"type":"string","description":"Payment provider","example":"SAFARICOM"},"beneficiary":{"type":"string","description":"Beneficiary type","example":"phone"},"validation":{"description":"Validation rules for the payment channel","allOf":[{"$ref":"#/components/schemas/PaymentChannelValidationV1Dto"}]},"gateway":{"type":"string","description":"Payment gateway identifier"},"group":{"type":"string","description":"Payment channel group","example":"mpesa"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/PaginationDataV1Dto":{"id":"components/schemas/PaginationDataV1Dto","kind":"json-schema","title":"PaginationDataV1Dto","data":{"type":"object","properties":{"total":{"type":"number","description":"Total number of records"},"perPage":{"type":"object","description":"Records per page"},"currentPage":{"type":"object","description":"Current page number"},"totalPages":{"type":"number","description":"Total number of pages"}}}},"components/schemas/PayoutRecordRequestV1Dto":{"id":"components/schemas/PayoutRecordRequestV1Dto","kind":"json-schema","title":"PayoutRecordRequestV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Recipient name","example":"carol mwangi"},"phone":{"type":"string","description":"Phone number (required)","example":796725019},"email":{"type":"string","description":"Email address","example":"carol@example.com"},"amount":{"type":"number","description":"Payment amount (must be positive)","example":10},"description":{"type":"string","description":"Payment description","example":"test"},"team":{"type":"string","description":"Team code","example":"DE8832C7"},"category_code":{"type":"string","description":"Category code","example":"P003"},"payment_type":{"type":"string","description":"Payment type","enum":["mpesa","airtel","mtn","xente","pochi","paybill","till","bank","rtgs"],"example":"mpesa"},"bank_code":{"type":"string","description":"Bank code (required for bank and RTGS payments)","example":"01"},"receiver":{"type":"string","description":"Receiver identifier (required for mpesa, airtel, mtn, xente, pochi, paybill)","example":796725019},"account_no":{"type":"string","description":"Account number (required for paybill, bank, and RTGS payments)","example":""},"idno":{"type":"string","description":"ID number","example":""},"mpesa_number":{"type":"string","description":"M-Pesa number","example":796725019},"tags":{"description":"Tags associated with payment","example":[],"type":"array","items":{"type":"string"}},"country":{"type":"string","description":"Country","example":"Kenya","default":"Kenya"},"category_name":{"type":"string","description":"Category name","example":"General Materials"},"branch_code":{"type":"string","description":"Branch code (required for RTGS payments)","example":"001"},"swift_code":{"type":"string","description":"SWIFT/BIC code (required for RTGS payments)","example":"ABCDKENA"}},"required":["name","phone","amount","description","team","category_code","payment_type","country","category_name"]}},"components/schemas/PaymentRecordV1Dto":{"id":"components/schemas/PaymentRecordV1Dto","kind":"json-schema","title":"PaymentRecordV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment record MongoDB ID"},"batch":{"type":"string","description":"Batch ID reference"},"batch_no":{"type":"string","description":"Batch number"},"mpesa_number":{"type":"string","description":"M-Pesa phone number"},"payment_type":{"type":"string","description":"Payment type","example":"mpesa"},"receiver":{"type":"string","description":"Receiver identifier"},"bank_name":{"type":"string","description":"Bank name"},"bank_code":{"type":"string","description":"Bank code"},"branch_code":{"type":"string","description":"Branch code"},"swift_code":{"type":"string","description":"SWIFT code"},"account_no":{"type":"string","description":"Account number"},"name":{"type":"string","description":"Recipient name"},"phone":{"type":"string","description":"Phone number"},"email":{"type":"string","description":"Email address"},"idno":{"type":"string","description":"ID number"},"description":{"type":"string","description":"Payment description"},"amount":{"type":"number","description":"Payment amount"},"fees":{"type":"number","description":"Transaction fees"},"status":{"type":"string","description":"Payment status","enum":["pending","processed","failed","cancelled"]},"transaction_ref":{"type":"string","description":"Internal transaction reference"},"category_name":{"type":"string","description":"Category name"},"category_code":{"type":"string","description":"Category code"},"team_code":{"type":"string","description":"Team code"},"noOfRetries":{"type":"number","description":"Number of retry attempts"},"send_on":{"type":"string","description":"Scheduled send date"},"is_duplicate":{"type":"boolean","description":"Whether record is a duplicate"},"tags":{"description":"Tags associated with the payment","type":"array","items":{"$ref":"#/components/schemas/TagV1Dto"}},"error_message":{"type":"string","description":"Error message if payment failed"},"external_ref":{"type":"string","description":"External reference from payment provider"},"__v":{"type":"number","description":"Version key"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"}}}},"components/schemas/ApproverV1Dto":{"id":"components/schemas/ApproverV1Dto","kind":"json-schema","title":"ApproverV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Approver name"},"email":{"type":"string","description":"Approver email"},"phone":{"type":"string","description":"Approver phone"},"employee_id":{"type":"string","description":"Employee ID"},"notes":{"type":"string","description":"Approval notes"},"mandatory":{"type":"boolean","description":"Whether approval is mandatory"},"level":{"type":"number","description":"Approval level"},"status":{"type":"string","description":"Approval status","enum":["pending","approved","cancelled"]},"_id":{"type":"string","description":"Approver record ID"}}}},"components/schemas/EventV1Dto":{"id":"components/schemas/EventV1Dto","kind":"json-schema","title":"EventV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Event ID"},"record":{"type":"string","description":"Related record ID"},"recordType":{"type":"string","description":"Record type","enum":["ACTIVITY","APPROVAL"]},"description":{"type":"string","description":"Event description"},"person":{"type":"string","description":"Person who performed the action"},"item":{"type":"string","description":"Item type"},"recordIds":{"description":"Related record IDs","type":"array","items":{"type":"string"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/PaymentSummaryV1Dto":{"id":"components/schemas/PaymentSummaryV1Dto","kind":"json-schema","title":"PaymentSummaryV1Dto","data":{"type":"object","properties":{"mpesa":{"type":"number","description":"M-Pesa total"},"pochi":{"type":"number","description":"Pochi La Biashara total"},"boya":{"type":"number","description":"Boya total"},"bank":{"type":"number","description":"Bank transfer total"},"rtgs":{"type":"number","description":"RTGS total"},"till":{"type":"number","description":"Till number total"},"airtime":{"type":"number","description":"Airtime total"},"paybill":{"type":"number","description":"Paybill total"},"xente":{"type":"number","description":"Xente total"},"mtn":{"type":"number","description":"MTN total"},"airtel":{"type":"number","description":"Airtel total"}}}},"components/schemas/ConfirmPaymentTransactionDto":{"id":"components/schemas/ConfirmPaymentTransactionDto","kind":"json-schema","title":"ConfirmPaymentTransactionDto","data":{"type":"object","properties":{"source":{"type":"string","description":"Payment source (card token or identifier)","example":"82622342945EE8C0-DUMMY"},"payment_type":{"type":"string","description":"Payment type","example":"CARD"},"group":{"type":"string","description":"Payment group/channel","example":"mpesa"},"amount":{"type":"number","description":"Transaction amount","example":10},"currency":{"type":"string","description":"Currency code","example":"KES"},"accno":{"type":"string","description":"Account number","example":693345001},"notes":{"type":"string","description":"Transaction notes","example":"Test a Payment via intents flow."},"categoryid":{"type":"string","description":"Category ID","example":"123XYZ"},"description":{"type":"string","description":"Transaction description","example":"Pay Biwott"},"receivername":{"type":"string","description":"Receiver name","example":"Biwott"},"receiver":{"type":"string","description":"Receiver identifier (phone/account)","example":790462100},"ref":{"type":"string","description":"Transaction reference","example":"M-CF4X4LG8IIE"},"txRef":{"type":"string","description":"Transaction reference (duplicate of ref)","example":"M-CF4X4LG8IIE"},"bank":{"$ref":"#/components/schemas/BankDetailsDto"},"physical_receipt":{"type":"string"},"other_receipts":{"type":"string"},"is_a_request":{"type":"boolean"},"initial":{"type":"boolean","description":"Indicates if this is an initial transaction","example":false},"timestamp":{"type":"string"},"expense_tags":{"type":"array","items":{"type":"string"}},"expense_id":{"type":"string"},"vendor":{"type":"string"},"vendor_id":{"type":"string"},"wallet_id":{"type":"string","description":"Wallet identifier","example":"P8756"},"requisition_reference":{"type":"string"},"sms":{"type":"string","description":"SMS notification content or reference","example":""},"checksum":{"type":"string","description":"Data integrity verification checksum","example":""}},"required":["source","payment_type","group","amount","currency","description","receiver","ref","txRef","initial","sms","checksum"]}},"components/schemas/AuditLogEntryDto":{"id":"components/schemas/AuditLogEntryDto","kind":"json-schema","title":"AuditLogEntryDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Audit log MongoDB ID"},"policy_id":{"type":"string","description":"Policy ID"},"wallet_id":{"type":"string","description":"Wallet ID"},"action":{"type":"string","description":"Action performed","enum":["GRANTED","MODIFIED","SUSPENDED","REVOKED","EXPIRED","REACTIVATED"]},"performed_by":{"type":"object","description":"Employee who performed the action"},"changes":{"type":"object","description":"Changes made"},"reason":{"type":"string","description":"Reason for the action"},"ip_address":{"type":"string","description":"IP address of the request"},"user_agent":{"type":"string","description":"User agent of the request"},"createdAt":{"type":"string","description":"Timestamp of the action"},"updatedAt":{"type":"string","description":"Last update timestamp"}},"required":["_id","policy_id","wallet_id","action","createdAt"]}},"components/schemas/PolicyLimitsResponseDto":{"id":"components/schemas/PolicyLimitsResponseDto","kind":"json-schema","title":"PolicyLimitsResponseDto","data":{"type":"object","properties":{"per_transaction":{"type":"object","description":"Per-transaction limit"},"daily_total":{"type":"object","description":"Daily total limit"},"monthly_total":{"type":"object","description":"Monthly total limit"},"currency":{"type":"string","description":"Currency code"}}}},"components/schemas/PolicyThresholdsResponseDto":{"id":"components/schemas/PolicyThresholdsResponseDto","kind":"json-schema","title":"PolicyThresholdsResponseDto","data":{"type":"object","properties":{"approval_required_above":{"type":"object","description":"Amount above which approval is required"},"auto_flag_above":{"type":"object","description":"Amount above which transaction is auto-flagged"}}}},"components/schemas/PolicyRestrictionsResponseDto":{"id":"components/schemas/PolicyRestrictionsResponseDto","kind":"json-schema","title":"PolicyRestrictionsResponseDto","data":{"type":"object","properties":{"mask_balance":{"type":"boolean","description":"Whether balance is masked"},"mask_transaction_amounts":{"type":"boolean","description":"Whether transaction amounts are masked"},"max_transaction_history_days":{"type":"number","description":"Maximum transaction history days accessible"}}}},"components/schemas/PolicyUpdatesDto":{"id":"components/schemas/PolicyUpdatesDto","kind":"json-schema","title":"PolicyUpdatesDto","data":{"type":"object","properties":{"permissions":{"description":"Updated permission slugs","example":["view-balance","view-transactions","export-statements"],"type":"array","items":{"type":"string"}},"limits":{"description":"Updated transaction limits","allOf":[{"$ref":"#/components/schemas/PolicyLimitsDto"}]},"thresholds":{"description":"Updated approval thresholds","allOf":[{"$ref":"#/components/schemas/PolicyThresholdsDto"}]},"restrictions":{"description":"Updated display restrictions","allOf":[{"$ref":"#/components/schemas/PolicyRestrictionsDto"}]},"valid_until":{"type":"string","description":"Updated expiry date"},"label":{"type":"string","description":"Updated label"}}}},"components/schemas/PolicyLimitsDto":{"id":"components/schemas/PolicyLimitsDto","kind":"json-schema","title":"PolicyLimitsDto","data":{"type":"object","properties":{"per_transaction":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-transaction limit (null = no limit)"},"children":[]}]}]}],"example":100000},"daily_total":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Daily total limit (null = no limit)"},"children":[]}]}]}],"example":500000},"monthly_total":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monthly total limit (null = no limit)"},"children":[]}]}]}],"example":2000000},"currency":{"type":"string","description":"Currency code","example":"KES","default":"KES"}}}},"components/schemas/PolicyThresholdsDto":{"id":"components/schemas/PolicyThresholdsDto","kind":"json-schema","title":"PolicyThresholdsDto","data":{"type":"object","properties":{"approval_required_above":{"type":"object","description":"Amount above which approval is required","example":50000},"auto_flag_above":{"type":"object","description":"Amount above which transaction is auto-flagged","example":200000}}}},"components/schemas/PolicyRestrictionsDto":{"id":"components/schemas/PolicyRestrictionsDto","kind":"json-schema","title":"PolicyRestrictionsDto","data":{"type":"object","properties":{"mask_balance":{"type":"boolean","description":"Whether to mask balance display","default":false},"mask_transaction_amounts":{"type":"boolean","description":"Whether to mask transaction amounts","default":false},"max_transaction_history_days":{"type":"number","description":"Maximum transaction history days accessible","default":90}}}},"components/schemas/TaxTransactionV1Dto":{"id":"components/schemas/TaxTransactionV1Dto","kind":"json-schema","title":"TaxTransactionV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tax transaction ID"},"name":{"type":"string","description":"Transaction name","example":"Witholding Tax - emm3m44"},"status":{"type":"string","description":"Transaction status","enum":["OUTSTANDING","PROCESSING","FAILED"]},"bill":{"description":"Associated bill details","allOf":[{"$ref":"#/components/schemas/BillV1Dto"}]},"tax":{"description":"Tax rate details","allOf":[{"$ref":"#/components/schemas/TaxDetailsV1Dto"}]},"base_amount":{"type":"number","description":"Base amount"},"withheld_amount":{"type":"number","description":"Withheld amount"},"source":{"type":"string","description":"Source"},"source_name":{"type":"string","description":"Source name"},"source_account_number":{"type":"string","description":"Source account number"},"__v":{"type":"number","description":"Version key"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"tax_prn":{"type":"string","description":"Tax PRN (Payment Reference Number)"}}}},"components/schemas/PaginatedExpensesDataDto":{"id":"components/schemas/PaginatedExpensesDataDto","kind":"json-schema","title":"PaginatedExpensesDataDto","data":{"type":"object","properties":{"docs":{"description":"Array of expense documents","example":[],"type":"array","items":{"type":"object"}},"total":{"type":"number","description":"Total number of expenses","example":0},"limit":{"type":"number","description":"Number of items per page","example":4},"page":{"type":"number","description":"Current page number","example":1},"pages":{"type":"number","description":"Total number of pages","example":1}},"required":["docs","total","limit","page","pages"]}},"components/schemas/AmountSpentDataDto":{"id":"components/schemas/AmountSpentDataDto","kind":"json-schema","title":"AmountSpentDataDto","data":{"type":"object","properties":{"amountSpent":{"description":"Array of amounts spent","example":[],"type":"array","items":{"type":"object"}},"periodBreakdown":{"description":"Breakdown by period","type":"array","items":{"$ref":"#/components/schemas/PeriodBreakdownDto"}}},"required":["amountSpent","periodBreakdown"]}},"components/schemas/CreateSubscriptionTeamDto":{"id":"components/schemas/CreateSubscriptionTeamDto","kind":"json-schema","title":"CreateSubscriptionTeamDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Team ID","example":"688877881b49af84b1aa11d9"},"code":{"type":"string","description":"Team code","example":"74CAAEEA"},"name":{"type":"string","description":"Team name","example":"AAR Bamburi"}},"required":["_id","code","name"]}},"components/schemas/CreateSubscriptionSubcategoryDto":{"id":"components/schemas/CreateSubscriptionSubcategoryDto","kind":"json-schema","title":"CreateSubscriptionSubcategoryDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Subcategory ID","example":"64f04ea40aac0abfb44b3bb7"},"code":{"type":"string","description":"Subcategory code","example":"P003"},"name":{"type":"string","description":"Subcategory name","example":"General Materials"}},"required":["_id","code","name"]}},"components/schemas/SubscriptionBusinessDto":{"id":"components/schemas/SubscriptionBusinessDto","kind":"json-schema","title":"SubscriptionBusinessDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Business ID"},"name":{"type":"string","description":"Business name"},"email":{"type":"string","description":"Business email"},"phone":{"type":"string","description":"Business phone"},"country":{"type":"string","description":"Business country"}}}},"components/schemas/SubscriptionCardDto":{"id":"components/schemas/SubscriptionCardDto","kind":"json-schema","title":"SubscriptionCardDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Card ID"},"exp_month":{"type":"string","description":"Card expiration month"},"exp_year":{"type":"string","description":"Card expiration year"},"brand":{"type":"string","description":"Card brand"},"last4":{"type":"string","description":"Last 4 digits of card"},"bin":{"type":"string","description":"Card BIN"},"blocked":{"type":"boolean","description":"Card blocked status"},"retired":{"type":"boolean","description":"Card retired status"},"issued_on":{"type":"string","description":"Card issued date"},"provider":{"type":"string","description":"Card provider"},"currency":{"type":"string","description":"Card currency"},"tracking_number":{"type":"string","description":"Card tracking number"},"is_virtual":{"type":"boolean","description":"Is virtual card"},"is_offline":{"type":"boolean","description":"Is offline card"},"dormant":{"type":"boolean","description":"Card dormant status"},"purged":{"type":"boolean","description":"Card purged status"}}}},"components/schemas/SubscriptionAssigneeDto":{"id":"components/schemas/SubscriptionAssigneeDto","kind":"json-schema","title":"SubscriptionAssigneeDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Assignee ID"},"name":{"type":"string","description":"Assignee name"},"employee_id":{"type":"string","description":"Employee ID"},"team_code":{"type":"string","description":"Team code"}}}},"components/schemas/SubscriptionSubcategoryDto":{"id":"components/schemas/SubscriptionSubcategoryDto","kind":"json-schema","title":"SubscriptionSubcategoryDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Subcategory ID"},"code":{"type":"string","description":"Subcategory Code"},"name":{"type":"string","description":"Subcategory Name"}}}},"components/schemas/SubscriptionTeamDto":{"id":"components/schemas/SubscriptionTeamDto","kind":"json-schema","title":"SubscriptionTeamDto","data":{"type":"object","properties":{"code":{"type":"string","description":"Team Code"},"name":{"type":"string","description":"Team Name"}}}},"components/schemas/AuditEventV1Dto":{"id":"components/schemas/AuditEventV1Dto","kind":"json-schema","title":"AuditEventV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Audit event MongoDB ID"},"id":{"type":"string","description":"Audit event ID"},"business":{"type":"string","description":"Business ID"},"recordType":{"type":"string","description":"Record type","enum":["ACTIVITY","MODIFICATION","CREATION","DELETION"]},"description":{"type":"string","description":"Event description"},"person":{"type":"string","description":"Person who performed the action"},"item":{"type":"string","description":"Item type affected","enum":["LOGIN","SUBSCRIPTION","INVESTMENT","EXPENSE","TRANSACTION","EMPLOYEE","VENDOR"]},"ip_address":{"type":"string","description":"IP address of the request"},"location":{"type":"string","description":"Location country code"},"recordIds":{"description":"Related record IDs","type":"array","items":{"type":"string"}},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"}}}},"components/schemas/DigestGroupDto":{"id":"components/schemas/DigestGroupDto","kind":"json-schema","title":"DigestGroupDto","data":{"type":"object","properties":{"id":{"type":"string","description":"Unique group identifier","example":"group-0"},"type":{"type":"string","description":"Group type","enum":["insight","session","activity"],"example":"insight"},"priority":{"type":"string","description":"Priority level","enum":["high","normal","low"],"example":"high"},"title":{"type":"string","description":"Brief title describing what happened","example":"Multiple Login Attempts"},"summary":{"type":"string","description":"One-sentence summary for executives","example":"Faith logged in 4 times within 8 minutes"},"timestamp":{"type":"string","description":"ISO timestamp of most recent event","example":"2026-02-05T14:30:45.000Z"},"insight":{"type":"string","description":"Natural language explanation with context and assessment","example":"This pattern may indicate connection issues or automated testing. No security concerns detected - same IP and location."},"confidence":{"type":"number","description":"Confidence score (0-1)","example":0.85},"actors":{"description":"Actors involved in this group","example":["Faith","Rob"],"type":"array","items":{"type":"string"}},"location":{"type":"string","description":"Location (human-readable)","example":"Kenya"},"events":{"description":"Events in this group","type":"array","items":{"$ref":"#/components/schemas/DigestEventDto"}}},"required":["id","type","priority","title","summary","timestamp","insight","confidence","actors","events"]}},"components/schemas/DigestStatsDto":{"id":"components/schemas/DigestStatsDto","kind":"json-schema","title":"DigestStatsDto","data":{"type":"object","properties":{"totalEvents":{"type":"number","description":"Total events in digest","example":15},"uniqueUsers":{"type":"number","description":"Number of unique users","example":3},"topAction":{"type":"string","description":"Most common action type","example":"Investment queries"},"timeSpan":{"type":"string","description":"Time span covered","example":"24 hours"},"byType":{"description":"Event counts by record type","allOf":[{"$ref":"#/components/schemas/DigestStatsByTypeDto"}]},"byPerson":{"type":"object","description":"Event counts by person","example":{"Rob":8,"Faith":5}}},"required":["totalEvents","uniqueUsers","topAction","timeSpan","byType","byPerson"]}},"components/schemas/PolicySummaryInGroupV1Dto":{"id":"components/schemas/PolicySummaryInGroupV1Dto","kind":"json-schema","title":"PolicySummaryInGroupV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy type MongoDB ObjectId"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED"]},"description":{"type":"string","description":"Human-readable description of the policy type"},"policy_code":{"type":"string","description":"Policy code (e.g. CHANNELS, SUBCATEGORY, TAGS)"},"rules":{"description":"Default rules for this policy type","type":"array","items":{"$ref":"#/components/schemas/PolicyRuleV1Dto"}},"business_policy_id":{"type":"string","description":"ID of the active business policy under this type, if any"}}}},"components/schemas/PolicyWithRulesV1Dto":{"id":"components/schemas/PolicyWithRulesV1Dto","kind":"json-schema","title":"PolicyWithRulesV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy type MongoDB ObjectId"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED"]},"description":{"type":"string","description":"Human-readable description of the policy type"},"policy_code":{"type":"string","description":"Policy code (e.g. CHANNELS, SUBCATEGORY, VENDORS)"},"business_policies":{"description":"Business-specific policies under this type","type":"array","items":{"$ref":"#/components/schemas/BusinessPolicyV1Dto"}},"rules":{"description":"Default rules for this policy type","type":"array","items":{"$ref":"#/components/schemas/PolicyRuleV1Dto"}}}}},"components/schemas/PolicyRefV1Dto":{"id":"components/schemas/PolicyRefV1Dto","kind":"json-schema","title":"PolicyRefV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Policy group MongoDB ObjectId"},"status":{"type":"string","description":"Policy status","enum":["ACTIVE","DISABLED","DELETED"]},"description":{"type":"string","description":"Human-readable description of the policy type"},"policy_code":{"type":"string","description":"Policy code identifier (e.g. SUBCATEGORY, CHANNELS, VENDORS)"}}}},"components/schemas/PolicyRuleV1Dto":{"id":"components/schemas/PolicyRuleV1Dto","kind":"json-schema","title":"PolicyRuleV1Dto","data":{"type":"object","properties":{"conditions":{"description":"Conditions that must be met for this rule to apply","type":"array","items":{"$ref":"#/components/schemas/PolicyConditionV1Dto"}},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Action to take when conditions are met (e.g. allow, block, request_approval, require_receipt)"},"children":[]}]}]}]},"period_unit":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Time unit for the spending period. TRANSACTION = per-payment limit; HOUR/DAY/WEEK/MONTH/YEAR = cumulative window"},"children":[]}]}]}],"enum":["TRANSACTION","HOUR","DAY","WEEK","MONTH","YEAR"],"example":"TRANSACTION"},"period":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of period units for the spending limit window. Use 0 when period_unit is TRANSACTION"},"children":[]}]}]}],"example":0},"kick_off_date":{"type":"string","description":"ISO 8601 date when the rule becomes active"},"target":{"type":"string","description":"Who this rule targets (e.g. everyone)"},"target_employees":{"description":"Specific employee IDs this rule targets","type":"array","items":{"type":"string"}},"exempt_employees":{"description":"Employee IDs exempt from this rule","type":"array","items":{"type":"string"}},"target_teams":{"description":"Team IDs this rule targets","type":"array","items":{"type":"string"}},"exempt_teams":{"description":"Team IDs exempt from this rule","type":"array","items":{"type":"string"}},"target_sub_categories":{"description":"Subcategories this rule targets","type":"array","items":{"type":"string"}},"exempt_sub_categories":{"description":"Subcategories exempt from this rule","type":"array","items":{"type":"string"}},"target_channels":{"description":"Payment channels this rule targets (e.g. mpesa, bills, tills)","type":"array","items":{"type":"string"}},"target_roles":{"description":"Employee roles this rule targets","type":"array","items":{"type":"string"}},"require_tax_compliant_receipt":{"type":"boolean","description":"Whether a tax-compliant receipt is required"},"funding_source_strategy":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Funding source strategy (e.g. business_wallet, initiator_wallet)"},"children":[]}]}]}]},"exempt_wallet_types":{"description":"Wallet types exempt from this rule","type":"array","items":{"type":"string"}}}}},"components/schemas/PolicyWorkflowStepDto":{"id":"components/schemas/PolicyWorkflowStepDto","kind":"json-schema","title":"PolicyWorkflowStepDto","data":{"type":"object","properties":{"approval_mandate":{"type":"string","enum":["all","any_of"],"default":"all"},"minimum_approvers":{"type":"number","example":1},"is_auto_approval":{"type":"boolean","example":false},"daily_limit":{"type":"object","example":1000000,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-day approval limit. Optional — the gateway fills a per-currency default when omitted."},"children":[]}]}]}]},"transaction_limit":{"type":"object","example":500000,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-transaction approval limit. Optional — the gateway fills a per-currency default when omitted."},"children":[]}]}]}]},"amount_approval_condition":{"$ref":"#/components/schemas/PolicyWorkflowAmountConditionDto"},"approvers":{"type":"array","items":{"$ref":"#/components/schemas/PolicyWorkflowApproverDto"}}},"required":["minimum_approvers","approvers"]}},"components/schemas/FxMarkupDto":{"id":"components/schemas/FxMarkupDto","kind":"json-schema","title":"FxMarkupDto","data":{"type":"object","properties":{"buy":{"type":"number","example":2},"sell":{"type":"number","example":2}},"required":["buy","sell"]}},"components/schemas/FundCatalogueItemDto":{"id":"components/schemas/FundCatalogueItemDto","kind":"json-schema","title":"FundCatalogueItemDto","data":{"type":"object","properties":{"fund_id":{"type":"string","example":"fund_britam_mmf_kes"},"fund_name":{"type":"string","example":"Britam Money Market Fund (KES)"},"vendor":{"type":"string","example":"BRITAM"},"asset_manager":{"type":"string","example":"Britam Asset Managers"},"product":{"type":"string","example":"MONEY_MARKET"},"currency":{"type":"string","example":"KES"},"min_initial_investment":{"$ref":"#/components/schemas/MoneyDto"},"effective_yield":{"description":"Current effective annual yield assumption.","allOf":[{"$ref":"#/components/schemas/YieldDto"}]},"interest_frequency":{"type":"string","example":"Daily"},"risk_level":{"type":"string","example":"Low"},"withdrawals_allowed":{"type":"boolean","example":true}},"required":["fund_id","fund_name","vendor","asset_manager","product","currency","min_initial_investment","effective_yield","interest_frequency","risk_level","withdrawals_allowed"]}},"components/schemas/FundAccountSummaryDto":{"id":"components/schemas/FundAccountSummaryDto","kind":"json-schema","title":"FundAccountSummaryDto","data":{"type":"object","properties":{"fund_account_id":{"type":"string","example":"fa_01HXYZ...","description":"Customer's fund account ID"},"fund_id":{"type":"string","example":"fund_britam_kes_mmf","description":"Catalogue fund ID"},"fund_name":{"type":"string","example":"Britam KES Money Market Fund"},"vendor":{"type":"string","example":"BRITAM"},"product":{"type":"string","example":"MONEY_MARKET"},"currency":{"type":"string","example":"KES"},"org_wallet_ref":{"type":"string","example":"1","description":"Organization wallet reference for this fund account currency."},"account_reference":{"type":"string","example":"BA100020873BOYA","description":"External account reference (display-only)"},"approval_ref":{"type":"string","example":"INV-OPT-123456","description":"Approval request reference for pending opt-in records."},"investment_wallet_id":{"type":"string","example":"I622957","description":"Boya wallet id of the MMF investment account. Used by the dashboard as the destination when topping up the investment account from a business wallet."},"state":{"type":"string","enum":["opt_in_pending","active","closing","opt_in_failed"],"example":"active"},"invested":{"description":"Total invested principal (native currency)","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"wallet_available_balance":{"description":"Available cash in the investment wallet before it is invested with the custodian.","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"opt_in_date":{"type":"string","example":"2024-08-12","description":"Opt-in date (date-only, ISO 8601)"},"treasury_operators":{"example":["64f0a1b2c3d4e5f600112233","64f0a1b2c3d4e5f600445566"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Employee ids permitted to transfer funds from this account (the wallet's employees_allowed_to_make_payments). Drives the Treasury Operators panel."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"investment_permissions":{"type":"array","items":{"$ref":"#/components/schemas/InvestmentPermissionGrantDto"}}},"required":["fund_account_id","fund_id","fund_name","vendor","product","currency","state","invested"]}},"components/schemas/MoneyDto":{"id":"components/schemas/MoneyDto","kind":"json-schema","title":"MoneyDto","data":{"type":"object","properties":{"amount":{"type":"number","example":125000.5,"description":"Numeric amount"},"currency":{"type":"string","example":"KES","description":"ISO 4217 currency code"}},"required":["amount","currency"]}},"components/schemas/InvestmentPermissionGrantDto":{"id":"components/schemas/InvestmentPermissionGrantDto","kind":"json-schema","title":"InvestmentPermissionGrantDto","data":{"type":"object","properties":{"employee_id":{"type":"string","example":"64f0a1b2c3d4e5f600112233"},"actions":{"type":"array","items":{"type":"string","enum":["VIEW","TOP_UP","INVEST","WITHDRAW","MANAGE"]}}},"required":["employee_id","actions"]}},"components/schemas/InterestSeriesPointDto":{"id":"components/schemas/InterestSeriesPointDto","kind":"json-schema","title":"InterestSeriesPointDto","data":{"type":"object","properties":{"date":{"type":"string","example":"2024-08-12","description":"Date-only, ISO 8601"},"amount":{"type":"number","example":12.34,"description":"Interest credited on this date, native currency"},"currency":{"type":"string","example":"KES"}},"required":["date","amount","currency"]}},"components/schemas/ProjectionHorizonDto":{"id":"components/schemas/ProjectionHorizonDto","kind":"json-schema","title":"ProjectionHorizonDto","data":{"type":"object","properties":{"horizon":{"type":"string","enum":["EOM","3M","6M","12M"]},"projected_interest":{"type":"number","example":4200.5,"description":"Projected interest at horizon, native currency"},"currency":{"type":"string","example":"KES"}},"required":["horizon","projected_interest","currency"]}},"components/schemas/InvestmentTransactionDto":{"id":"components/schemas/InvestmentTransactionDto","kind":"json-schema","title":"InvestmentTransactionDto","data":{"type":"object","properties":{"id":{"type":"string","example":"txn_01HXYZ..."},"occurred_at":{"type":"string","example":"2024-08-12T09:14:00.000Z","description":"ISO 8601 timestamp"},"type":{"type":"string","enum":["ALL","MMF-INVESTMENT","MMF-INTEREST","MMF-WITHDRAWAL","MMF-UNKNOWN"]},"amount":{"type":"number","example":50000,"description":"Signed amount: credit positive, debit negative"},"currency":{"type":"string","example":"KES"},"status":{"type":"string","example":"SUCCESS"},"description":{"type":"string","example":"Britam KES MMF interest"},"reference":{"type":"string","example":"MMF-D4B58C018D","description":"Internal Boya reference"},"external_reference":{"type":"string","example":"132210551","description":"Custodian (Britam) provider reference"},"credit":{"type":"number","example":42.28,"description":"Raw credit amount from the ledger"},"debit":{"type":"number","example":0,"description":"Raw debit amount from the ledger"}},"required":["id","occurred_at","type","amount","currency"]}},"components/schemas/OptInApprovalRequestDto":{"id":"components/schemas/OptInApprovalRequestDto","kind":"json-schema","title":"OptInApprovalRequestDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"64f1f77bc6d4f24b75a0c101"},"ref":{"type":"string","example":"INV-OPT-123456"},"status":{"type":"string","example":"PENDING"},"participants":{"type":"array","items":{"type":"object"}},"records":{"type":"array","items":{"type":"object"}}}}},"components/schemas/PortfolioCurrencyTotalsDto":{"id":"components/schemas/PortfolioCurrencyTotalsDto","kind":"json-schema","title":"PortfolioCurrencyTotalsDto","data":{"type":"object","properties":{"currency":{"type":"string","example":"KES"},"total_invested":{"$ref":"#/components/schemas/MoneyDto"},"available_balance":{"$ref":"#/components/schemas/MoneyDto"},"account_count":{"type":"number","example":1}},"required":["currency","total_invested","available_balance","account_count"]}},"components/schemas/PortfolioPerformanceCurrencyDto":{"id":"components/schemas/PortfolioPerformanceCurrencyDto","kind":"json-schema","title":"PortfolioPerformanceCurrencyDto","data":{"type":"object","properties":{"currency":{"type":"string","example":"KES"},"total_interest":{"$ref":"#/components/schemas/MoneyDto"},"series":{"type":"array","items":{"$ref":"#/components/schemas/InterestSeriesPointDto"}}},"required":["currency","total_interest","series"]}},"components/schemas/BillWorkflowStepDto":{"id":"components/schemas/BillWorkflowStepDto","kind":"json-schema","title":"BillWorkflowStepDto","data":{"type":"object","properties":{"approval_mandate":{"type":"string","enum":["all","any_of"],"default":"any_of"},"minimum_approvers":{"type":"number","example":1},"is_auto_approval":{"type":"boolean","example":false},"daily_limit":{"type":"object","example":200},"transaction_limit":{"type":"object","example":5000},"amount_approval_condition":{"$ref":"#/components/schemas/BillWorkflowAmountConditionDto"},"approvers":{"type":"array","items":{"$ref":"#/components/schemas/BillWorkflowApproverDto"}}},"required":["minimum_approvers","approvers"]}},"components/schemas/CategoryDto":{"id":"components/schemas/CategoryDto","kind":"json-schema","title":"CategoryDto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Category MongoDB ID"},"groupid":{"type":"string","description":"Category group ID"},"name":{"type":"string","description":"Category name"}}}},"components/schemas/TaxValidityDto":{"id":"components/schemas/TaxValidityDto","kind":"json-schema","title":"TaxValidityDto","data":{"type":"object","properties":{"pin":{"type":"string","description":"PIN number"},"cu":{"type":"object","description":"CU details"},"invoice":{"type":"object","description":"Invoice details"},"tax":{"type":"object","description":"Tax details"}}}},"components/schemas/CategoryReportDatasetDto":{"id":"components/schemas/CategoryReportDatasetDto","kind":"json-schema","title":"CategoryReportDatasetDto","data":{"type":"object","properties":{"data":{"description":"Data values for each category","example":[1013,78,10,240,58],"type":"array","items":{"type":"number"}},"backgroundColor":{"description":"Background colors for each category","example":["#EA088B","#662F8E","#191970"],"type":"array","items":{"type":"string"}},"hoverBackgroundColor":{"description":"Hover background colors for each category","example":["#EA088B","#662F8E","#191970"],"type":"array","items":{"type":"string"}}},"required":["data","backgroundColor","hoverBackgroundColor"]}},"components/schemas/ApprovalParticipantDto":{"id":"components/schemas/ApprovalParticipantDto","kind":"json-schema","title":"ApprovalParticipantDto","data":{"type":"object","properties":{"employee":{"type":"string","description":"Participant employee ObjectId"},"id":{"type":"string","description":"Employee identifier string"},"status":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Participant status: 1=pending, 0=approved, 2=rejected"},"children":[]}]}]}]},"reason":{"type":"string","description":"Reason for decision"},"approval_type":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approval type: 1=mandatory, 0=optional"},"children":[]}]}]}]},"requested_on":{"type":"string","description":"Requested on timestamp"},"actioned_on":{"type":"string","description":"Actioned on timestamp"},"level":{"type":"number","description":"Approval hierarchy level"}}}},"components/schemas/TagEmployeeDto":{"id":"components/schemas/TagEmployeeDto","kind":"json-schema","title":"TagEmployeeDto","data":{"type":"object","properties":{"customer_id":{"type":"string","description":"Customer ID of the tag owner","example":"EAA8F4AF3B1DF2EA8D45"},"customer_name":{"type":"string","description":"Customer name of the tag owner","example":"Ivy Ngele ; 00111"}}}},"components/schemas/ApprovalBusinessDto":{"id":"components/schemas/ApprovalBusinessDto","kind":"json-schema","title":"ApprovalBusinessDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"631b067a46830ae81217f860"},"business_id":{"type":"string","example":"zyatjjbfhwwrzzmpgrpsbkcpnldfge"},"name":{"type":"string","example":"Boya Limited"}},"required":["_id","business_id","name"]}},"components/schemas/ApprovalRecordDto":{"id":"components/schemas/ApprovalRecordDto","kind":"json-schema","title":"ApprovalRecordDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"698eae9e8e02c65ba2c4d0ea"},"ref":{"type":"string","example":"SUB-3e70cd6484"},"amount":{"type":"number","example":100},"currency":{"type":"string","example":"USD"},"description":{"type":"string","example":"Mpesa transaction"},"notes":{"type":"string","example":"Rob is requesting creation of a subscription"},"receiver_name":{"type":"string","example":"Lucidchart"},"fees":{"type":"number","example":0},"transaction_ref":{"type":"string","example":"D-UGUKVSPHMJGFE"},"team":{"$ref":"#/components/schemas/ApprovalTeamDto"},"payment_instruction":{"$ref":"#/components/schemas/PaymentInstructionDto"},"status":{"type":"string","example":"pending"}}}},"components/schemas/ApprovalEventDto":{"id":"components/schemas/ApprovalEventDto","kind":"json-schema","title":"ApprovalEventDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"698eaec7c3e3ddd24c2dfa47"},"recordType":{"type":"string","example":"APPROVAL"},"description":{"type":"string","example":"Approved request: #SUB-84f6ecb209"},"person":{"type":"string","example":"Rob"},"createdAt":{"type":"string","example":"2026-02-13T04:55:35.850Z"}},"required":["_id","recordType","description","person","createdAt"]}},"components/schemas/RequesterDto":{"id":"components/schemas/RequesterDto","kind":"json-schema","title":"RequesterDto","data":{"type":"object","properties":{"id":{"type":"string","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"name":{"type":"string","example":"Rob"},"email":{"type":"string","example":"rob@boyahq.com"},"phone":{"type":"string","example":"+254710702289"}},"required":["id","name","email","phone"]}},"components/schemas/ApprovalStepDto":{"id":"components/schemas/ApprovalStepDto","kind":"json-schema","title":"ApprovalStepDto","data":{"type":"object","properties":{"id":{"type":"string","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"name":{"type":"string","example":"Rob"},"employeeId":{"type":"string","example":"sgggbrfldhqcudjvhhwjpzcdcpcwws"},"level":{"type":"number","example":1},"status":{"type":"string","enum":["completed","pending","rejected","awaiting"],"example":"pending"},"statusLabel":{"type":"string","example":"Pending Review"},"requestedAt":{"format":"date-time","type":"string","example":"2026-02-13T04:54:54.492Z"},"actionedAt":{"format":"date-time","type":"string","example":"2026-02-13T04:55:35.810Z"},"reason":{"type":"string","example":""},"duration":{"type":"string","example":"1h 30m"},"isCurrentUser":{"type":"boolean","example":true}},"required":["id","name","employeeId","level","status","statusLabel","requestedAt"]}},"components/schemas/ApprovalProgressDto":{"id":"components/schemas/ApprovalProgressDto","kind":"json-schema","title":"ApprovalProgressDto","data":{"type":"object","properties":{"completed":{"type":"number","example":1},"total":{"type":"number","example":2},"percentage":{"type":"number","example":50}},"required":["completed","total","percentage"]}},"components/schemas/ApprovalEventDigestDto":{"id":"components/schemas/ApprovalEventDigestDto","kind":"json-schema","title":"ApprovalEventDigestDto","data":{"type":"object","properties":{"type":{"type":"string","example":"APPROVAL"},"description":{"type":"string","example":"Approved request: #SUB-84f6ecb209"},"person":{"type":"string","example":"Rob"},"timestamp":{"format":"date-time","type":"string","example":"2026-02-13T04:55:35.850Z"}},"required":["type","description","person","timestamp"]}},"components/schemas/CashflowAccountDto":{"id":"components/schemas/CashflowAccountDto","kind":"json-schema","title":"CashflowAccountDto","data":{"type":"object","properties":{"accountId":{"type":"string","description":"Account identifier","example":"acc-1"},"accountName":{"type":"string","description":"Account name","example":"Main Account"},"accountType":{"type":"string","description":"Account type","example":"BUSINESS_WALLET"},"currency":{"type":"string","description":"Account currency","example":"KES"},"openingBalance":{"type":"number","description":"Opening balance at start of period","example":100000},"expense":{"type":"number","description":"Total expenses during period","example":0},"moneyIn":{"type":"number","description":"Total money received during period","example":0},"iftIn":{"type":"number","description":"Internal fund transfers in","example":0},"iftOut":{"type":"number","description":"Internal fund transfers out","example":0},"closingBalance":{"type":"number","description":"Closing balance at end of period","example":120000}},"required":["accountId","accountName","accountType","currency","openingBalance","expense","moneyIn","iftIn","iftOut","closingBalance"]}},"components/schemas/CashflowSummaryDto":{"id":"components/schemas/CashflowSummaryDto","kind":"json-schema","title":"CashflowSummaryDto","data":{"type":"object","properties":{"openingBalance":{"type":"object","description":"Opening balance totals by currency","example":{"KES":2217.32,"total":2217.32}},"closingBalance":{"type":"object","description":"Closing balance totals by currency","example":{"KES":2037.32,"total":2037.32}},"currency":{"type":"string","description":"Primary currency for the report","example":"KES"}},"required":["openingBalance","closingBalance","currency"]}},"components/schemas/CashflowPeriodDto":{"id":"components/schemas/CashflowPeriodDto","kind":"json-schema","title":"CashflowPeriodDto","data":{"type":"object","properties":{"startDate":{"type":"string","description":"Period start date","example":"2026-05-01"},"endDate":{"type":"string","description":"Period end date","example":"2026-05-15"}},"required":["startDate","endDate"]}},"components/schemas/BankDepositInstructionsDto":{"id":"components/schemas/BankDepositInstructionsDto","kind":"json-schema","title":"BankDepositInstructionsDto","data":{"type":"object","properties":{"bank":{"type":"string","description":"Bank name for wire transfer"},"bankCode":{"type":"string","description":"Bank code"},"branchCode":{"type":"string","description":"Branch code"},"accountNumber":{"type":"string","description":"Account number for deposit"},"bankBranch":{"type":"string","description":"Bank branch name"},"swiftCode":{"type":"string","description":"SWIFT code for international transfers"},"reference":{"type":"string","description":"Payment reference (use this in transfer description)"},"currency":{"type":"string","description":"Currency for this deposit account"}}}},"components/schemas/MpesaDepositInstructionsDto":{"id":"components/schemas/MpesaDepositInstructionsDto","kind":"json-schema","title":"MpesaDepositInstructionsDto","data":{"type":"object","properties":{"type":{"type":"string","description":"Payment type"},"businessNumber":{"type":"string","description":"M-Pesa Paybill business number"},"accountNumber":{"type":"string","description":"Account number to use when paying"}}}},"components/schemas/MoneyInDto":{"id":"components/schemas/MoneyInDto","kind":"json-schema","title":"MoneyInDto","data":{"type":"object","properties":{"totalAmount":{"type":"number","description":"Total money in for the requested period","example":139.26},"topSources":{"description":"Top 5 sources of income (payment channels)","example":[{"id":"1","name":"MPESA","amount":139.26,"avatar":"M"}],"type":"array","items":{"$ref":"#/components/schemas/TopSourceDto"}},"last3MonthsAverage":{"type":"number","description":"Average money in over the last 3 months","example":125.5},"last3MonthsData":{"description":"Money in data for the last 3 months","example":[{"month":"Oct","year":2025,"amount":120},{"month":"Nov","year":2025,"amount":130.5},{"month":"Dec","year":2025,"amount":126}],"type":"array","items":{"$ref":"#/components/schemas/MonthlyDataDto"}}},"required":["totalAmount","topSources","last3MonthsAverage","last3MonthsData"]}},"components/schemas/MoneyOutDto":{"id":"components/schemas/MoneyOutDto","kind":"json-schema","title":"MoneyOutDto","data":{"type":"object","properties":{"totalAmount":{"type":"number","description":"Total money out for the requested period","example":65},"topSpends":{"description":"Top 5 spending destinations (vendors/merchants)","example":[{"id":"1","name":"Boya Limited","amount":50,"avatar":"B"}],"type":"array","items":{"$ref":"#/components/schemas/TopSpendDto"}},"last3MonthsAverage":{"type":"number","description":"Average money out over the last 3 months","example":60.25},"last3MonthsData":{"description":"Money out data for the last 3 months","example":[{"month":"Oct","year":2025,"amount":55},{"month":"Nov","year":2025,"amount":62.5},{"month":"Dec","year":2025,"amount":63.25}],"type":"array","items":{"$ref":"#/components/schemas/MonthlyDataDto"}}},"required":["totalAmount","topSpends","last3MonthsAverage","last3MonthsData"]}},"components/schemas/MandateV1Dto":{"id":"components/schemas/MandateV1Dto","kind":"json-schema","title":"MandateV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Mandate MongoDB ID","example":"64f04e9f0aac0abfb44b3b6b"},"type":{"type":"string","description":"Type of mandate (PAYABLES, PAYROLL, etc.)","enum":["PAYABLES","PAYROLL"],"example":"PAYABLES"},"approvers":{"description":"Array of approvers for this mandate","type":"array","items":{"$ref":"#/components/schemas/MandateApproverV1Dto"}},"minimum_approvers":{"type":"number","description":"Minimum number of approvers required for this mandate","example":1}}}},"components/schemas/PaymentChannelValidationV1Dto":{"id":"components/schemas/PaymentChannelValidationV1Dto","kind":"json-schema","title":"PaymentChannelValidationV1Dto","data":{"type":"object","properties":{"required":{"description":"Required fields for this payment channel","example":["phone"],"type":"array","items":{"type":"string"}},"minimum_amount":{"type":"number","description":"Minimum transaction amount","example":10},"maximum_amount":{"type":"number","description":"Maximum transaction amount","example":150000}}}},"components/schemas/TagV1Dto":{"id":"components/schemas/TagV1Dto","kind":"json-schema","title":"TagV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tag ID"},"name":{"type":"string","description":"Tag name"},"tag_group":{"description":"Tag group details","allOf":[{"$ref":"#/components/schemas/TagGroupV1Dto"}]},"employee":{"description":"Employee associated with the tag","allOf":[{"$ref":"#/components/schemas/TagEmployeeV1Dto"}]},"is_deleted":{"type":"boolean","description":"Whether tag is deleted"},"__v":{"type":"number","description":"Version key"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"teams":{"description":"Team IDs associated with tag","type":"array","items":{"type":"string"}}}}},"components/schemas/BankDetailsDto":{"id":"components/schemas/BankDetailsDto","kind":"json-schema","title":"BankDetailsDto","data":{"type":"object","properties":{"BANKNAME":{"type":"string"},"BANKCODE":{"type":"string"},"ACCOUNTNAME":{"type":"string"},"SWIFTBIC":{"type":"string"},"BANKCITY":{"type":"string"},"BANKCOUNTRY":{"type":"string"}}}},"components/schemas/BillV1Dto":{"id":"components/schemas/BillV1Dto","kind":"json-schema","title":"BillV1Dto","data":{"type":"object","properties":{"budget_owner":{"description":"Budget owner details","allOf":[{"$ref":"#/components/schemas/BudgetOwnerV1Dto"}]},"_id":{"type":"string","description":"Bill ID"},"invoice_no":{"type":"string","description":"Invoice number"},"org_wallet_ref":{"type":"string","description":"Organization wallet reference"},"description":{"type":"string","description":"Bill description"},"category":{"type":"string","description":"Category"},"category_code":{"type":"string","description":"Category code"},"attachments":{"description":"Attachments","type":"array","items":{"$ref":"#/components/schemas/AttachmentV1Dto"}},"invoice_amount":{"type":"number","description":"Invoice amount"},"due_date":{"type":"string","description":"Due date"},"created_by":{"type":"string","description":"Created by"},"invoice_date":{"type":"string","description":"Invoice date"},"received_from":{"type":"string","description":"Received from"},"events":{"description":"Event IDs","type":"array","items":{"type":"string"}},"status":{"type":"string","description":"Bill status","enum":["outstanding","cancelled","draft","paid"]},"supplier":{"description":"Supplier details","allOf":[{"$ref":"#/components/schemas/SupplierV1Dto"}]},"auto_approve_repeat_payments":{"type":"boolean","description":"Auto approve repeat payments"},"repeat_frequency":{"type":"string","description":"Repeat frequency","enum":["none","daily","weekly","monthly"]},"no_of_repeats":{"type":"number","description":"Number of repeats"},"items":{"description":"Items","type":"array","items":{"type":"string"}},"payments":{"description":"Payments","type":"array","items":{"$ref":"#/components/schemas/PaymentV1Dto"}},"read_only":{"type":"boolean","description":"Read only flag"},"tags":{"description":"Tags","type":"array","items":{"type":"string"}},"initiated_by_id":{"type":"string","description":"Initiated by ID"},"initiated_by_name":{"type":"string","description":"Initiated by name"},"original_currency":{"type":"string","description":"Original currency"},"original_currency_amount":{"type":"number","description":"Original currency amount"},"wallet_currency":{"type":"string","description":"Wallet currency"},"fx_rate":{"type":"number","description":"FX rate"},"withholding_taxes":{"description":"Withholding taxes","type":"array","items":{"type":"string"}},"is_withholding_taxable":{"type":"boolean","description":"Is withholding taxable"},"approvers":{"description":"Approvers","type":"array","items":{"type":"string"}},"budget":{"type":"object","description":"Budget"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"updated_by":{"type":"string","description":"Updated by"}}}},"components/schemas/TaxDetailsV1Dto":{"id":"components/schemas/TaxDetailsV1Dto","kind":"json-schema","title":"TaxDetailsV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tax ID"},"name":{"type":"string","description":"Tax name"},"type":{"type":"string","description":"Tax type","enum":["PROFFESSIONAL_WITHHOLDING_TAX","VAT_WITHHOLDING_TAX"]},"rate":{"type":"number","description":"Tax rate"},"status":{"type":"string","description":"Tax status","enum":["ACTIVE","ARCHIVED"]},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"},"nature_of_business":{"type":"string","description":"Nature of business"},"resident_type":{"type":"string","description":"Resident type","enum":["Resident","Non-Resident"]}}}},"components/schemas/PeriodBreakdownDto":{"id":"components/schemas/PeriodBreakdownDto","kind":"json-schema","title":"PeriodBreakdownDto","data":{"type":"object","properties":{"period":{"type":"string","description":"Period identifier","example":"2025-05"},"periodStart":{"type":"string","description":"Period start date","example":"2025-05-31T21:00:00.000Z"},"periodEnd":{"type":"string","description":"Period end date","example":"2025-06-30T20:59:59.999Z"},"total":{"type":"number","description":"Total amount spent in this period","example":0}},"required":["period","periodStart","periodEnd","total"]}},"components/schemas/DigestEventDto":{"id":"components/schemas/DigestEventDto","kind":"json-schema","title":"DigestEventDto","data":{"type":"object","properties":{"time":{"type":"string","description":"Event time (HH:MM:SS format)","example":"14:30:45"},"action":{"type":"string","description":"Human-readable action description","example":"Logged in to the dashboard"},"ip":{"type":"string","description":"IP address","example":"129.222.187.88"},"subscription":{"type":"string","description":"Subscription ID","example":"sub_123"},"investment":{"type":"string","description":"Investment ID","example":"inv_456"},"details":{"type":"string","description":"Additional details","example":"Amount: KES 5,000"},"note":{"type":"string","description":"Warning or observation note","example":"Different IP from previous login"},"count":{"type":"number","description":"Event count for grouped actions","example":2}},"required":["time","action"]}},"components/schemas/DigestStatsByTypeDto":{"id":"components/schemas/DigestStatsByTypeDto","kind":"json-schema","title":"DigestStatsByTypeDto","data":{"type":"object","properties":{"ACTIVITY":{"type":"number","description":"Activity event count"},"MODIFICATION":{"type":"number","description":"Modification event count"},"CREATION":{"type":"number","description":"Creation event count"},"DELETION":{"type":"number","description":"Deletion event count"}}}},"components/schemas/PolicyConditionV1Dto":{"id":"components/schemas/PolicyConditionV1Dto","kind":"json-schema","title":"PolicyConditionV1Dto","data":{"type":"object","properties":{"field":{"type":"string","description":"Field the condition applies to (e.g. amount, channel, subcategory)"},"operator":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comparison operator (e.g. greater_than, equal, less_than)"},"children":[]}]}]}]},"value":{"type":"object","description":"Value to compare against"},"value_id":{"type":"string","description":"MongoDB ObjectId of the referenced value (e.g. subcategory ID)"}}}},"components/schemas/PolicyWorkflowAmountConditionDto":{"id":"components/schemas/PolicyWorkflowAmountConditionDto","kind":"json-schema","title":"PolicyWorkflowAmountConditionDto","data":{"type":"object","properties":{"type":{"type":"string","enum":["under","between","over_or_equal_to","any_amount"]},"amount":{"type":"number","example":250000},"amount_range":{"example":[1,250000],"type":"array","items":{"type":"string"}},"values":{"example":[],"type":"array","items":{"type":"string"}}},"required":["type"]}},"components/schemas/PolicyWorkflowApproverDto":{"id":"components/schemas/PolicyWorkflowApproverDto","kind":"json-schema","title":"PolicyWorkflowApproverDto","data":{"type":"object","properties":{"employee":{"type":"string","example":"65fbf2f42a5d67f03a764111"},"level":{"type":"number","example":1},"must_approve":{"type":"boolean","example":false},"amount_approval_condition":{"$ref":"#/components/schemas/PolicyWorkflowAmountConditionDto"},"non_amount_approval_conditions":{"type":"array","items":{"type":"string"}}},"required":["employee"]}},"components/schemas/YieldDto":{"id":"components/schemas/YieldDto","kind":"json-schema","title":"YieldDto","data":{"type":"object","properties":{"value":{"type":"number","example":8.2,"description":"Yield value as a number; see unit"},"unit":{"type":"string","example":"percent","enum":["percent"]}},"required":["value","unit"]}},"components/schemas/BillWorkflowAmountConditionDto":{"id":"components/schemas/BillWorkflowAmountConditionDto","kind":"json-schema","title":"BillWorkflowAmountConditionDto","data":{"type":"object","properties":{"type":{"type":"string","enum":["under","between","over_or_equal_to","any_amount"]},"amount":{"type":"number","example":250000},"amount_range":{"example":[1,250000],"type":"array","items":{"type":"string"}},"values":{"example":[],"type":"array","items":{"type":"string"}}},"required":["type"]}},"components/schemas/BillWorkflowApproverDto":{"id":"components/schemas/BillWorkflowApproverDto","kind":"json-schema","title":"BillWorkflowApproverDto","data":{"type":"object","properties":{"employee":{"type":"string","example":"65fbf2f42a5d67f03a764111"},"level":{"type":"number","example":1},"must_approve":{"type":"boolean","example":false},"amount_approval_condition":{"$ref":"#/components/schemas/BillWorkflowAmountConditionDto"},"non_amount_approval_conditions":{"type":"array","items":{"type":"string"}}},"required":["employee"]}},"components/schemas/ApprovalTeamDto":{"id":"components/schemas/ApprovalTeamDto","kind":"json-schema","title":"ApprovalTeamDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"64ec5b57ffaef6ff2a2845b3"},"code":{"type":"string","example":"0003"},"name":{"type":"string","example":"Tech"}},"required":["_id","code","name"]}},"components/schemas/PaymentInstructionDto":{"id":"components/schemas/PaymentInstructionDto","kind":"json-schema","title":"PaymentInstructionDto","data":{"type":"object","properties":{"_id":{"type":"string","example":"6808e7c3b7a3aab7e41fbe7f"},"channel":{"type":"string","example":"bank"},"phone":{"type":"string","example":""},"accno":{"type":"string","example":"1400284063131"},"bank":{"type":"string","example":"EQUITY BANK LTD"},"bank_code":{"type":"string","example":"68"},"till":{"type":"string","example":""},"business_no":{"type":"string","example":""}},"required":["_id","channel"]}},"components/schemas/TopSourceDto":{"id":"components/schemas/TopSourceDto","kind":"json-schema","title":"TopSourceDto","data":{"type":"object","properties":{"id":{"type":"string","description":"Source ID","example":"1"},"name":{"type":"string","description":"Source name (e.g., MPESA, BANK, CARD)","example":"MPESA"},"amount":{"type":"number","description":"Total amount from this source","example":139.26},"avatar":{"type":"string","description":"Avatar/initial for the source","example":"M"}},"required":["id","name","amount","avatar"]}},"components/schemas/MonthlyDataDto":{"id":"components/schemas/MonthlyDataDto","kind":"json-schema","title":"MonthlyDataDto","data":{"type":"object","properties":{"month":{"type":"string","description":"Month abbreviation (Jan, Feb, Mar, etc.)","example":"Oct"},"year":{"type":"number","description":"Year","example":2025},"amount":{"type":"number","description":"Total amount for this month","example":120}},"required":["month","year","amount"]}},"components/schemas/TopSpendDto":{"id":"components/schemas/TopSpendDto","kind":"json-schema","title":"TopSpendDto","data":{"type":"object","properties":{"id":{"type":"string","description":"Vendor ID","example":"1"},"name":{"type":"string","description":"Vendor name","example":"Boya Limited"},"amount":{"type":"number","description":"Total amount spent with this vendor","example":50},"avatar":{"type":"string","description":"Avatar/initial for the vendor","example":"B"}},"required":["id","name","amount","avatar"]}},"components/schemas/MandateApproverV1Dto":{"id":"components/schemas/MandateApproverV1Dto","kind":"json-schema","title":"MandateApproverV1Dto","data":{"type":"object","properties":{"employee":{"description":"Employee information for the approver","allOf":[{"$ref":"#/components/schemas/MandateEmployeeV1Dto"}]},"level":{"type":"number","description":"Approval level/tier in the approval hierarchy","example":1},"_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approver identifier (typically same as employee._id)"},"children":[]}]}]}],"example":"691af15e2c7cead4901adfd2"}}}},"components/schemas/TagGroupV1Dto":{"id":"components/schemas/TagGroupV1Dto","kind":"json-schema","title":"TagGroupV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Tag group ID"},"name":{"type":"string","description":"Tag group name"},"tags":{"description":"Tag IDs in this group","type":"array","items":{"type":"string"}},"is_deleted":{"type":"boolean","description":"Whether tag group is deleted"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/TagEmployeeV1Dto":{"id":"components/schemas/TagEmployeeV1Dto","kind":"json-schema","title":"TagEmployeeV1Dto","data":{"type":"object","properties":{"customer_id":{"type":"string","description":"Customer ID"},"customer_name":{"type":"string","description":"Customer name"}}}},"components/schemas/BudgetOwnerV1Dto":{"id":"components/schemas/BudgetOwnerV1Dto","kind":"json-schema","title":"BudgetOwnerV1Dto","data":{"type":"object","properties":{"name":{"type":"string","description":"Budget owner name"},"approved":{"type":"boolean","description":"Approval status"},"employee_id":{"type":"string","description":"Employee ID"}}}},"components/schemas/AttachmentV1Dto":{"id":"components/schemas/AttachmentV1Dto","kind":"json-schema","title":"AttachmentV1Dto","data":{"type":"object","properties":{"url":{"type":"string","description":"Attachment URL"},"file_name":{"type":"string","description":"File name"},"content_type":{"type":"string","description":"Content type"}}}},"components/schemas/SupplierV1Dto":{"id":"components/schemas/SupplierV1Dto","kind":"json-schema","title":"SupplierV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Supplier ID"},"phone":{"type":"string","description":"Phone number"},"email":{"type":"string","description":"Email address"},"contact_name":{"type":"string","description":"Contact name"},"company_name":{"type":"string","description":"Company name"},"address":{"type":"string","description":"Address"},"description":{"type":"string","description":"Description"},"status":{"type":"string","description":"Supplier status","enum":["ACTIVE","INACTIVE"]},"payment_instructions":{"description":"Payment instructions","type":"array","items":{"type":"string"}},"taxID":{"type":"string","description":"Tax ID"},"read_only":{"type":"boolean","description":"Read only flag"},"mapping_id":{"type":"string","description":"Mapping ID"},"createdAt":{"type":"string","description":"Created timestamp"},"updatedAt":{"type":"string","description":"Updated timestamp"},"__v":{"type":"number","description":"Version key"}}}},"components/schemas/PaymentV1Dto":{"id":"components/schemas/PaymentV1Dto","kind":"json-schema","title":"PaymentV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Payment ID"},"transaction_ref":{"type":"string","description":"Transaction reference"},"amount":{"type":"number","description":"Payment amount"},"send_on":{"type":"string","description":"Send on date"},"initiated_on":{"type":"string","description":"Initiated on date"},"approved":{"type":"boolean","description":"Approval status"},"payment_instruction":{"description":"Payment instruction details","allOf":[{"$ref":"#/components/schemas/PaymentInstructionV1Dto"}]},"error_message":{"type":"string","description":"Error message"},"status":{"type":"string","description":"Payment status","enum":["scheduled","successful","cancelled","failed"]},"approvers":{"description":"Approvers list","type":"array","items":{"type":"string"}},"completed_on":{"type":"string","description":"Completed on date"},"external_ref":{"type":"string","description":"External reference"}}}},"components/schemas/MandateEmployeeV1Dto":{"id":"components/schemas/MandateEmployeeV1Dto","kind":"json-schema","title":"MandateEmployeeV1Dto","data":{"type":"object","properties":{"_id":{"type":"string","description":"Employee MongoDB ID","example":"691af15e2c7cead4901adfd2"},"name":{"type":"string","description":"Employee full name","example":"Joan Wangare"}}}},"components/schemas/TeamModeDataDto":{"id":"components/schemas/TeamModeDataDto","kind":"json-schema","title":"TeamModeDataDto","data":{"type":"object","title":"TeamModeDataDto","additionalProperties":true,"description":"Object shape not yet published by the upstream spec.","example":{}}},"components/schemas/CategoryModeDataDto":{"id":"components/schemas/CategoryModeDataDto","kind":"json-schema","title":"CategoryModeDataDto","data":{"type":"object","title":"CategoryModeDataDto","additionalProperties":true,"description":"Object shape not yet published by the upstream spec.","example":{}}},"components/schemas/SubcategoryModeDataDto":{"id":"components/schemas/SubcategoryModeDataDto","kind":"json-schema","title":"SubcategoryModeDataDto","data":{"type":"object","title":"SubcategoryModeDataDto","additionalProperties":true,"description":"Object shape not yet published by the upstream spec.","example":{}}},"schema_107":{"kind":"json-schema","data":{"enum":["draft","outstanding","paid","cancelled","refunded"],"type":"string"},"id":"schema_107"},"schema_108":{"kind":"json-schema","data":{"example":1,"type":"number"},"id":"schema_108"},"schema_109":{"kind":"json-schema","data":{"example":25,"type":"number"},"id":"schema_109"},"schema_110":{"kind":"json-schema","data":{"type":"string"},"id":"schema_110"},"schema_111":{"kind":"json-schema","data":{"example":"KES","type":"string"},"id":"schema_111"},"schema_112":{"kind":"json-schema","data":{"example":"KENYA","type":"string"},"id":"schema_112"},"schema_113":{"kind":"json-schema","data":{"enum":["pending","processed","cancelled","draft"],"type":"string"},"id":"schema_113"},"schema_114":{"kind":"json-schema","data":{"format":"date-time","example":"2026-02-01 00:00","type":"string"},"id":"schema_114"},"schema_115":{"kind":"json-schema","data":{"format":"date-time","example":"2026-02-07 23:59","type":"string"},"id":"schema_115"},"schema_116":{"kind":"json-schema","data":{"example":"all","type":"string"},"id":"schema_116"},"schema_117":{"kind":"json-schema","data":{"example":"true","type":"string"},"id":"schema_117"},"schema_118":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/BankV1Dto"}},"id":"schema_118"},"schema_119":{"kind":"json-schema","data":{"enum":["PENDING","APPROVED","REJECTED","CANCELLED","DRAFT"],"type":"string"},"id":"schema_119"},"schema_120":{"kind":"json-schema","data":{"default":1,"example":1,"type":"number"},"id":"schema_120"},"schema_121":{"kind":"json-schema","data":{"default":100,"example":100,"type":"number"},"id":"schema_121"},"schema_122":{"kind":"json-schema","data":{"enum":["PAYOUT","TOPUP","KYC","DEBIT","INVOICE","APP_TRANSACTION","SINGLE_CARD_REQUEST","ALLOCATION_REQUEST","BANK_TRANSFER_REQUEST","INVESTMENT_OPTIN_REQUEST","POLICY_BASED","SUBSCRIPTION_REQUEST"],"type":"string"},"id":"schema_122"},"schema_123":{"kind":"json-schema","data":{"example":"2026-01-01","type":"string"},"id":"schema_123"},"schema_124":{"kind":"json-schema","data":{"example":"2026-12-31","type":"string"},"id":"schema_124"},"schema_125":{"kind":"json-schema","data":{"example":20,"type":"number"},"id":"schema_125"},"schema_126":{"kind":"json-schema","data":{"example":"1","type":"string"},"id":"schema_126"},"schema_127":{"kind":"json-schema","data":{"example":"2026-04-30","type":"string"},"id":"schema_127"},"schema_128":{"kind":"json-schema","data":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for blocking card"}}},"id":"schema_128"},"schema_129":{"kind":"json-schema","data":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for retiring card"}}},"id":"schema_129"},"schema_130":{"kind":"json-schema","data":{"example":{"single_use_cards_funding":"pre_funded","single_use_cards_source_strategy":"business_wallet","single_use_cards_workflow":null,"single_use_cards_auto_expiry_hours":"1440","required_fields":{"amount":true,"vendor":false,"customer":false,"category":true,"tags":false,"reference":false,"notes":true,"receipt":false}}},"id":"schema_130"},"schema_131":{"kind":"json-schema","data":{"example":50,"type":"number"},"id":"schema_131"},"schema_132":{"kind":"json-schema","data":{"example":"Netflix","type":"string"},"id":"schema_132"},"schema_133":{"kind":"json-schema","data":{"enum":["DRAFT","ACTIVE","PAUSED","REJECTED","DELETED","PENDING"],"type":"string"},"id":"schema_133"},"schema_134":{"kind":"json-schema","data":{"example":"67b44aea86c1ccabbe965827","type":"string"},"id":"schema_134"},"schema_135":{"kind":"json-schema","data":{"example":0,"type":"number"},"id":"schema_135"},"schema_136":{"kind":"json-schema","data":{"example":2026,"type":"number"},"id":"schema_136"},"schema_137":{"kind":"json-schema","data":{"type":"number"},"id":"schema_137"},"schema_138":{"kind":"json-schema","data":{"format":"date-time","example":"2026-01-01T23:59:59","type":"string"},"id":"schema_138"},"schema_139":{"kind":"json-schema","data":{"format":"date-time","example":"2025-11-01","type":"string"},"id":"schema_139"},"schema_140":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/BusinessCurrencyV1Dto"}},"id":"schema_140"},"schema_141":{"kind":"json-schema","data":{"example":"2026-04-18","type":"string"},"id":"schema_141"},"schema_142":{"kind":"json-schema","data":{"example":"2026-05-18","type":"string"},"id":"schema_142"},"schema_143":{"kind":"json-schema","data":{"example":"acc-123","type":"string"},"id":"schema_143"},"schema_144":{"kind":"json-schema","data":{"format":"date-time","example":"2025-12-01","type":"string"},"id":"schema_144"},"schema_145":{"kind":"json-schema","data":{"format":"date-time","example":"2025-10-01","type":"string"},"id":"schema_145"},"schema_146":{"kind":"json-schema","data":{"enum":["mpesa","mtn","pochi","airtel","xentebanktransfer","bank","rtgs","paybill","till","airtime","internal"],"type":"string"},"id":"schema_146"},"schema_147":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/RecentVendorV1Dto"}},"id":"schema_147"},"schema_148":{"kind":"json-schema","data":{"enum":["ACTIVE","DELETED","ALL"],"type":"string"},"id":"schema_148"},"schema_149":{"kind":"json-schema","data":{"example":"64f4205154a6357a7f85f656","type":"string"},"id":"schema_149"},"schema_150":{"kind":"json-schema","data":{"example":"Acme","type":"string"},"id":"schema_150"},"schema_151":{"kind":"json-schema","data":{"example":"ACTIVE","type":"string"},"id":"schema_151"},"schema_152":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeBalanceDto"}},"id":"schema_152"},"schema_153":{"kind":"json-schema","data":{"example":"2024-01-01T00:00:00Z","type":"string"},"id":"schema_153"},"schema_154":{"kind":"json-schema","data":{"example":"2024-12-31T23:59:59Z","type":"string"},"id":"schema_154"},"schema_155":{"kind":"json-schema","data":{"default":"7D","enum":["7D","1M","3M","ALL"],"type":"string"},"id":"schema_155"},"schema_156":{"kind":"json-schema","data":{"minimum":0,"maximum":100,"example":9,"type":"number"},"id":"schema_156"},"schema_157":{"kind":"json-schema","data":{"default":"ALL","enum":["ALL","MMF-INVESTMENT","MMF-INTEREST","MMF-WITHDRAWAL","MMF-UNKNOWN"],"type":"string"},"id":"schema_157"},"schema_158":{"kind":"json-schema","data":{"default":1,"type":"number"},"id":"schema_158"},"schema_159":{"kind":"json-schema","data":{"maximum":100,"default":25,"type":"number"},"id":"schema_159"},"schema_160":{"kind":"json-schema","data":{"default":"MTD","enum":["MTD","YTD","ALL"],"type":"string"},"id":"schema_160"},"schema_161":{"kind":"json-schema","data":{"default":"7D","enum":["7D","30D","ALL"],"type":"string"},"id":"schema_161"},"schema_162":{"kind":"json-schema","data":{"default":"ALL","enum":["ALL","INVESTMENT","INTEREST","WITHDRAWAL"],"type":"string"},"id":"schema_162"},"schema_163":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PolicyGroupV1Dto"}},"id":"schema_163"},"schema_164":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PolicyGroupWithPoliciesV1Dto"}},"id":"schema_164"},"schema_165":{"kind":"json-schema","data":{"example":"66788af92805e9ffbda6dcee","type":"string"},"id":"schema_165"},"schema_166":{"kind":"json-schema","data":{"example":"697b6c810a21d470ffaca828","type":"string"},"id":"schema_166"},"schema_167":{"kind":"json-schema","data":{"example":"CDCAF716DC722","type":"string"},"id":"schema_167"},"schema_168":{"kind":"json-schema","data":{"example":"abcdefghijklmnopqrstuvwxyzabcd","type":"string"},"id":"schema_168"},"schema_169":{"kind":"json-schema","data":{"enum":["subcategory","category"],"type":"string"},"id":"schema_169"},"schema_170":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/BusinessPolicyV1Dto"}},"id":"schema_170"},"schema_171":{"kind":"json-schema","data":{"example":"6a3ebb7893bb2649e19cb8a6","type":"string"},"id":"schema_171"},"schema_172":{"kind":"json-schema","data":{"example":"66788b3e2805e9ffbda6dcf7","type":"string"},"id":"schema_172"},"schema_173":{"kind":"json-schema","data":{"enum":["ACTIVE","SUSPENDED","EXPIRED","REVOKED"],"type":"string"},"id":"schema_173"},"schema_174":{"kind":"json-schema","data":{"default":false,"type":"string"},"id":"schema_174"},"schema_175":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PolicyV1Dto"}},"id":"schema_175"},"schema_176":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PermissionV1Dto"}},"id":"schema_176"},"schema_177":{"kind":"json-schema","data":{"example":15,"type":"number"},"id":"schema_177"},"schema_178":{"kind":"json-schema","data":{"example":100,"type":"number"},"id":"schema_178"}},"exampleStore":{"paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object":{"value":{"employee_id":"EMP001","amount":5000,"currency":"KES","notes":"Purchase office supplies","subcategory_id":"CAT_OFFICE","customer":{"_id":"69dd1e56d2756bba9fa9983b","name":"Giraffe Center","email":"giraffe@acme.com","phone":"+254700000012","address":"123 Karen Street, Nairobi","type":"regular","status":"active","person":["123"],"taxPin":"A123456789Z"}},"key":"with_customer_object","summary":"Request with full customer object (preferred)","id":"paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_object"},"paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id":{"value":{"employee_id":"EMP001","amount":5000,"currency":"KES","notes":"Purchase office supplies","subcategory_id":"CAT_OFFICE","customer_id":"69dd1e56d2756bba9fa9983b","customer_name":"Giraffe Center"},"key":"with_customer_id","summary":"Request with customer_id (legacy)","id":"paths/~1cards~1single-use~1request/post/requestBody/content/application~1json/examples/with_customer_id"},"paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer":{"value":{"type":"regular","name":"Acme Corp","taxPin":"A123456789Z","email":"billing@acme.com","phone":"+254700000000","address":"123 Main Street, Nairobi","person":[]},"key":"regular_customer","summary":"Regular customer (only name is required; everything else is optional)","id":"paths/~1customers/post/requestBody/content/application~1json/examples/regular_customer"},"paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer":{"value":{"type":"walkIn"},"key":"walkin_customer","summary":"Walk-In customer (type only required)","id":"paths/~1customers/post/requestBody/content/application~1json/examples/walkin_customer"}},"securitySchemeStore":{"oauth2ClientCredentials":{"id":"oauth2ClientCredentials","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your client_id and client_secret for a short-lived (5 minute) bearer access token, then send it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.boyahq.com/v2/oauth/token","scopes":{"accounts:read":"Read accounts","accounts:write":"Write accounts","approvals:read":"Read approvals (private label)","approvals:write":"Write approvals (private label)","audit-trail:read":"Read audit trail (private label)","bills:read":"Read bills","bills:write":"Write bills","business-policies:read":"Read business policies (private label)","business-policies:write":"Write business policies (private label)","cards:read":"Read cards (private label)","cards:write":"Write cards (private label)","categories:read":"Read categories","categories:write":"Write categories","customers:read":"Read customers","customers:write":"Write customers","employees:read":"Read employees","employees:write":"Write employees","expenses:read":"Read expenses","expenses:write":"Write expenses","fx:read":"Read fx","fx:write":"Write fx (private label)","investments:read":"Read investments (private label)","investments:write":"Write investments (private label)","payments:read":"Read payments (private label)","payments:write":"Write payments (private label)","roles:read":"Read roles (private label)","roles:write":"Write roles (private label)","subscriptions:read":"Read subscriptions","subscriptions:write":"Write subscriptions","tags:read":"Read tags","taxes:read":"Read taxes","taxes:write":"Write taxes","teams:read":"Read teams","teams:write":"Write teams","transactions:read":"Read transactions","transactions:write":"Write transactions","vendors:read":"Read vendors","vendors:write":"Write vendors","wallet-policies:read":"Read wallet policies (private label)","wallet-policies:write":"Write wallet policies (private label)"}}}}},"servers":[{"url":"/_mock/v2/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://api.boyahq.com/v2","description":"Production"},{"url":"https://sandbox.api.boyahq.com/v2","description":"Sandbox"}]},"options":{"hideSidebar":true,"mockServer":{"url":"/_mock/v2/openapi","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/v2/openapi.json?download"},{"url":"/_bundle/v2/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Boya API","description":"Boya is the financial operating system for business operations. The v2 API uses OAuth2 client-credentials authentication and signed webhooks.\n\nOperations badged **Private label** require a commercial entitlement — [contact sales](mailto:sales@boyahq.com)."}},"baseSlug":"/v2/openapi","routesMapping":{}}