Per-request RFC 9449 DPoP proof signed with ES256. Protected requests use Authorization: DPoP your_access_token_here. Create a new proof for the exact method and normalized target URI, and include the server nonce when challenged.
OAuth 2.0 with RFC 9700 security practices. Discover exact environment endpoints from /.well-known/openid-configuration and /.well-known/oauth-authorization-server, and discover the resource from /.well-known/oauth-protected-resource. Authorization-code clients use PKCE S256, the exact environment resource, nonce with openid, and DPoP binding. Confidential clients also require PAR and private_key_jwt. Access and refresh tokens are sender-constrained with DPoP. purchases:execute is unavailable and omitted from this scope registry.
Safe virtual-account economics for mapped beneficiaries.
Maximum array length: 100
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Perflo Financial Agents API","colors":{"primary":"#18A877","light":"#42C99A","dark":"#0C6C4E"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"proofoftech","hasAudioNarration":false,"actualSubdomain":"proofoftech","customDomains":["docs.perflo-api.proofof.tech"],"gitSource":{"type":"github","owner":"gcharang","repo":"perflo-financial-agents-api","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8b75c3ad2bd01e3bcee66d","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"API Reference","count":42},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"beneficiaries","count":7},{"language":"default","tag":"Use the API","count":5},{"language":"default","tag":"OAuth \u0026 OpenID Connect","count":5},{"language":"default","tag":"cards","count":5},{"language":"default","tag":"accounts","count":4},{"language":"default","tag":"operation-webhooks","count":4},{"language":"default","tag":"services","count":4},{"language":"default","tag":"system","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/beneficiaries/list-beneficiary-virtual-accounts","slug":"/api-reference/beneficiaries/list-beneficiary-virtual-accounts","pageMetadata":{"title":"List beneficiary virtual accounts","description":"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/virtual-accounts","href":"/api-reference/beneficiaries/list-beneficiary-virtual-accounts","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List beneficiary virtual accounts","description":"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/virtual-accounts","href":"/api-reference/beneficiaries/list-beneficiary-virtual-accounts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.","operationId":"listBeneficiaryVirtualAccounts","security":["6f724c02-bc0a-430d-bbec-301ce6a2acfa"],"summary":"List beneficiary virtual accounts","tags":["beneficiaries"],"parameters":["bfb94f64-92c6-4908-a080-f1c254abdf5c"],"responses":{"200":"edc76f4a-27c7-4bd8-8639-e3960e7d5efd","401":"bb7dffb8-73bd-42e1-aa4c-cedd4b29adcb","403":"cae5ae29-6587-483b-9864-546663736b93","409":"95b35768-2eac-4da4-bf32-74a86b4fe7a6","422":"ea32b383-7748-41f2-9dc1-cbf10d6c6527","429":"720429f2-7932-458a-a482-067288863f39","500":"d6644266-500a-4a46-9e2a-b32ee573ab7f","503":"26d14cf3-d2ef-4c85-ba4b-cb894a6daa77"},"method":"get","type":"path","servers":["90688a52-5405-4865-83c1-4d1cf346ac00"],"path":"/v1/beneficiaries/virtual-accounts","baseUrlOptions":["https://api-gateway.perflo.ai"],"title":"List beneficiary virtual accounts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bfb94f64-92c6-4908-a080-f1c254abdf5c":{"description":"Optional caller request identifier. Unsafe values are replaced with a generated UUID.","in":"header","name":"X-Request-Id","required":false,"schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string","isRequired":false,"description":"Optional caller request identifier. Unsafe values are replaced with a generated UUID.","uniqueKey":"","typeLabel":"string"}}},"responses":{"edc76f4a-27c7-4bd8-8639-e3960e7d5efd":{"description":"Safe virtual-account economics for mapped beneficiaries.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"virtual_accounts":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"beneficiary_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"API-owned opaque beneficiary identifier.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].beneficiary_id","typeLabel":"string\u003cuuid>"},"currency_in":{"type":"string","pattern":"^[A-Z][A-Z0-9._-]{0,31}$","description":"Accepted funding asset or currency.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].currency_in","typeLabel":"string"},"currency_out":{"type":"string","pattern":"^[A-Z][A-Z0-9._-]{0,31}$","description":"Payout asset or currency.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].currency_out","typeLabel":"string"},"rail_out":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)*$","description":"Normalized payout rail.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].rail_out","typeLabel":"string"},"minimum_amount":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,37})(?:\\.\\d{1,18})?$","description":"Minimum source amount.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].minimum_amount","typeLabel":"string"},"maximum_amount":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,37})(?:\\.\\d{1,18})?$","description":"Maximum source amount.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].maximum_amount","typeLabel":"string"},"fee_fixed":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,37})(?:\\.\\d{1,18})?$","description":"Fixed provider fee.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].fee_fixed","typeLabel":"string"},"fee_basis_points":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,37})(?:\\.\\d{1,18})?$","description":"Variable provider fee in basis points.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].fee_basis_points","typeLabel":"string"},"application_fee_basis_points":{"oneOf":[{"type":"string","description":"Application fee in basis points, or null when this read does not state it.","pattern":"^(?:0|[1-9]\\d{0,37})(?:\\.\\d{1,18})?$","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].application_fee_basis_points.oneOf.0","typeLabel":"string"},{"type":"null","description":"Application fee in basis points, or null when this read does not state it.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].application_fee_basis_points.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].application_fee_basis_points","typeLabel":"string | null"},"purpose_codes":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096,"description":"Non-empty safe display text.","uniqueKey":"virtual_accounts.items.[INDEX].purpose_codes.items.[INDEX]","typeLabel":"string"},"description":"Accepted purpose codes.","isRequired":true,"uniqueKey":"virtual_accounts.items.[INDEX].purpose_codes","typeLabel":"string[]"}},"required":["beneficiary_id","currency_in","currency_out","rail_out","minimum_amount","maximum_amount","fee_fixed","fee_basis_points","application_fee_basis_points","purpose_codes"],"additionalProperties":false,"description":"Safe virtual-account economics without deposit addresses, memos, provider IDs, or keys.","uniqueKey":"virtual_accounts.items.[INDEX]","typeLabel":"object"},"description":"Safe virtual-account economics for mapped beneficiaries.","isRequired":true,"uniqueKey":"virtual_accounts","typeLabel":"object[]"}},"required":["virtual_accounts"],"additionalProperties":false,"description":"Current safe beneficiary virtual-account projections.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"virtual_accounts":[{"beneficiary_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","currency_in":"\u003cstring>","currency_out":"\u003cstring>","rail_out":"\u003cstring>","minimum_amount":"\u003cstring>","maximum_amount":"\u003cstring>","fee_fixed":"\u003cstring>","fee_basis_points":"\u003cstring>","application_fee_basis_points":"\u003cstring>","purpose_codes":["\u003cstring>"]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"bb7dffb8-73bd-42e1-aa4c-cedd4b29adcb":{"description":"The access token or DPoP proof is invalid.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}},"WWW-Authenticate":{"description":"OAuth DPoP authentication challenge. Inspect the challenge before deciding whether to request a new token or proof.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"cae5ae29-6587-483b-9864-546663736b93":{"description":"The current grant does not authorize this request.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}},"WWW-Authenticate":{"description":"OAuth DPoP authentication challenge. Inspect the challenge before deciding whether to request a new token or proof.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"95b35768-2eac-4da4-bf32-74a86b4fe7a6":{"description":"The provider binding or idempotency intent conflicts.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"ea32b383-7748-41f2-9dc1-cbf10d6c6527":{"description":"The request shape is invalid.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"720429f2-7932-458a-a482-067288863f39":{"description":"The shared request limit was exceeded.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"Retry-After":{"description":"Whole seconds to wait before sending another request to this endpoint.","schema":{"minimum":1,"type":"integer"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"d6644266-500a-4a46-9e2a-b32ee573ab7f":{"description":"The response contract failed.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"},"26d14cf3-d2ef-4c85-ba4b-cb894a6daa77":{"description":"A required authorization, operation, or provider dependency is unavailable.","headers":{"X-Request-Id":{"description":"Request identifier echoed on every API response.","schema":{"pattern":"^[A-Za-z0-9._~-]{8,128}$","type":"string"}},"DPoP-Nonce":{"description":"Current protected-resource nonce for the next DPoP proof. Replace any previously stored resource nonce.","schema":{"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"Stable URL identifying the problem class.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"Short human-readable problem title.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code for this occurrence.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","minLength":1,"description":"Human-readable occurrence detail.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","pattern":"^\\/.*","description":"Request path identifying this problem occurrence.","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable Perflo error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"fields":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","minLength":1,"description":"Human-readable validation failure.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","minLength":1,"description":"Dot-delimited path to the invalid field.","isRequired":true,"uniqueKey":"fields.oneOf.0.items.[INDEX].path","typeLabel":"string"}},"required":["message","path"],"additionalProperties":false,"description":"One field-level request validation failure.","uniqueKey":"fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Field-level failures, or null when the problem is not field-specific.","isRequired":true,"uniqueKey":"fields.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fields","typeLabel":"object[] | null"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._~-]{8,128}$","description":"Request identifier used to correlate API responses with server logs.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether repeating the identical request can safely succeed.","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"submission_uncertain":{"type":"boolean","description":"Whether an upstream write may have landed and must not be resubmitted.","isRequired":true,"uniqueKey":"submission_uncertain","typeLabel":"boolean"}},"required":["type","title","status","detail","instance","code","fields","request_id","retryable","submission_uncertain"],"additionalProperties":false,"description":"RFC 9457 problem details with stable Perflo correlation and retry semantics.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"detail":"\u003cstring>","instance":"\u003cstring>","code":"\u003cstring>","fields":[{"message":"\u003cstring>","path":"\u003cstring>"}],"request_id":"\u003cstring>","retryable":true,"submission_uncertain":true}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6f724c02-bc0a-430d-bbec-301ce6a2acfa":{"PerfloDPoPProof":{"description":"Per-request RFC 9449 DPoP proof signed with ES256. Protected requests use `Authorization: DPoP your_access_token_here`. Create a new proof for the exact method and normalized target URI, and include the server nonce when challenged.","in":"header","name":"DPoP","type":"apiKey","scopes":[]},"PerfloOAuth":{"description":"OAuth 2.0 with RFC 9700 security practices. Discover exact environment endpoints from `/.well-known/openid-configuration` and `/.well-known/oauth-authorization-server`, and discover the resource from `/.well-known/oauth-protected-resource`. Authorization-code clients use PKCE `S256`, the exact environment resource, `nonce` with `openid`, and DPoP binding. Confidential clients also require PAR and `private_key_jwt`. Access and refresh tokens are sender-constrained with DPoP. `purchases:execute` is unavailable and omitted from this scope registry.","flows":{"authorizationCode":{"authorizationUrl":"https://api-gateway.perflo.ai/oauth/authorize","scopes":{"accounts:read":"Read the resource owner’s financial accounts, withdrawal limits, and endorsement status.","accounts:write":"Provision fiat accounts through durable operations.","activity:read":"Read the resource owner’s sanitized financial activity.","authorization:read":"Read the current OAuth grant and effective delegated policy.","beneficiaries:read":"Read beneficiaries and beneficiary reference data.","beneficiaries:write":"Create beneficiaries through durable operations.","cards:manage":"Create and manage non-sensitive card lifecycle state.","cards:read":"Read non-sensitive card state and activity.","identity:read":"Read the resource owner’s safe display preferences.","kyc:read":"Read the resource owner’s normalized verification status.","operations:read":"Read operations owned by the same subject and client.","purchases:read":"Read quote-bound service purchase state.","services:read":"Read services available under the effective grant policy.","spending:read":"Read the resource owner’s spending account.","spending:withdraw":"Create spending-account withdrawals through durable operations.","transfers:quote":"Create non-executable transfer estimates."},"tokenUrl":"https://api-gateway.perflo.ai/oauth/token"},"clientCredentials":{"scopes":{"accounts:read":"Read the resource owner’s financial accounts, withdrawal limits, and endorsement status.","accounts:write":"Provision fiat accounts through durable operations.","activity:read":"Read the resource owner’s sanitized financial activity.","authorization:read":"Read the current OAuth grant and effective delegated policy.","beneficiaries:read":"Read beneficiaries and beneficiary reference data.","beneficiaries:write":"Create beneficiaries through durable operations.","cards:manage":"Create and manage non-sensitive card lifecycle state.","cards:read":"Read non-sensitive card state and activity.","identity:read":"Read the resource owner’s safe display preferences.","kyc:read":"Read the resource owner’s normalized verification status.","operations:read":"Read operations owned by the same subject and client.","purchases:read":"Read quote-bound service purchase state.","services:read":"Read services available under the effective grant policy.","spending:read":"Read the resource owner’s spending account.","spending:withdraw":"Create spending-account withdrawals through durable operations.","transfers:quote":"Create non-executable transfer estimates."},"tokenUrl":"https://api-gateway.perflo.ai/oauth/token"}},"type":"oauth2","x-token-type":"DPoP","scopes":["beneficiaries:read"]}}},"servers":{"90688a52-5405-4865-83c1-4d1cf346ac00":{"url":"https://api-gateway.perflo.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Per-request RFC 9449 DPoP proof signed with ES256. Protected requests use `Authorization: DPoP your_access_token_here`. Create a new proof for the exact method and normalized target URI, and include the server nonce when challenged.","in":"header","name":"DPoP","type":"apiKey","scopes":[]},"schema":{"title":"DPoP","type":"string","description":"Per-request RFC 9449 DPoP proof signed with ES256. Protected requests use `Authorization: DPoP your_access_token_here`. Create a new proof for the exact method and normalized target URI, and include the server nonce when challenged.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"PerfloDPoPProof","name":"DPoP"},{"scheme":{"description":"OAuth 2.0 with RFC 9700 security practices. Discover exact environment endpoints from `/.well-known/openid-configuration` and `/.well-known/oauth-authorization-server`, and discover the resource from `/.well-known/oauth-protected-resource`. Authorization-code clients use PKCE `S256`, the exact environment resource, `nonce` with `openid`, and DPoP binding. Confidential clients also require PAR and `private_key_jwt`. Access and refresh tokens are sender-constrained with DPoP. `purchases:execute` is unavailable and omitted from this scope registry.","flows":{"authorizationCode":{"authorizationUrl":"https://api-gateway.perflo.ai/oauth/authorize","scopes":{"accounts:read":"Read the resource owner’s financial accounts, withdrawal limits, and endorsement status.","accounts:write":"Provision fiat accounts through durable operations.","activity:read":"Read the resource owner’s sanitized financial activity.","authorization:read":"Read the current OAuth grant and effective delegated policy.","beneficiaries:read":"Read beneficiaries and beneficiary reference data.","beneficiaries:write":"Create beneficiaries through durable operations.","cards:manage":"Create and manage non-sensitive card lifecycle state.","cards:read":"Read non-sensitive card state and activity.","identity:read":"Read the resource owner’s safe display preferences.","kyc:read":"Read the resource owner’s normalized verification status.","operations:read":"Read operations owned by the same subject and client.","purchases:read":"Read quote-bound service purchase state.","services:read":"Read services available under the effective grant policy.","spending:read":"Read the resource owner’s spending account.","spending:withdraw":"Create spending-account withdrawals through durable operations.","transfers:quote":"Create non-executable transfer estimates."},"tokenUrl":"https://api-gateway.perflo.ai/oauth/token"},"clientCredentials":{"scopes":{"accounts:read":"Read the resource owner’s financial accounts, withdrawal limits, and endorsement status.","accounts:write":"Provision fiat accounts through durable operations.","activity:read":"Read the resource owner’s sanitized financial activity.","authorization:read":"Read the current OAuth grant and effective delegated policy.","beneficiaries:read":"Read beneficiaries and beneficiary reference data.","beneficiaries:write":"Create beneficiaries through durable operations.","cards:manage":"Create and manage non-sensitive card lifecycle state.","cards:read":"Read non-sensitive card state and activity.","identity:read":"Read the resource owner’s safe display preferences.","kyc:read":"Read the resource owner’s normalized verification status.","operations:read":"Read operations owned by the same subject and client.","purchases:read":"Read quote-bound service purchase state.","services:read":"Read services available under the effective grant policy.","spending:read":"Read the resource owner’s spending account.","spending:withdraw":"Create spending-account withdrawals through durable operations.","transfers:quote":"Create non-executable transfer estimates."},"tokenUrl":"https://api-gateway.perflo.ai/oauth/token"}},"type":"oauth2","x-token-type":"DPoP","scopes":["beneficiaries:read"]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.0 with RFC 9700 security practices. Discover exact environment endpoints from `/.well-known/openid-configuration` and `/.well-known/oauth-authorization-server`, and discover the resource from `/.well-known/oauth-protected-resource`. Authorization-code clients use PKCE `S256`, the exact environment resource, `nonce` with `openid`, and DPoP binding. Confidential clients also require PAR and `private_key_jwt`. Access and refresh tokens are sender-constrained with DPoP. `purchases:execute` is unavailable and omitted from this scope registry.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"PerfloOAuth","name":"Authorization"}],"title":"PerfloDPoPProof \u0026 PerfloOAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"proofoftech","siteName":"Perflo Financial Agents API","title":"List beneficiary virtual accounts - Perflo Financial Agents API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-23T22:36:01.808Z","originalFileLocation":"api-reference/beneficiaries/list-beneficiary-virtual-accounts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Perflo Financial Agents API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/proofoftech/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/proofoftech/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/proofoftech/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/proofoftech/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"List beneficiary virtual accounts - Perflo Financial Agents API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Perflo Financial Agents API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://proofoftech.mintlify.site/_mintlify/api/og/v2?division=beneficiaries\u0026amp;title=List+beneficiary+virtual+accounts\u0026amp;description=Lists+safe+virtual-account+economics+without+returning+deposit+destinations+or+provider+identifiers.\u0026amp;theme=4a8942d30ddd6eae3a17fa6b\u0026amp;signature=6f293b9017b14838df4b2c3e1bf586b0be916e919fe2bc60720c5c3794cd95e5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List beneficiary virtual accounts - Perflo Financial Agents API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://proofoftech.mintlify.site/_mintlify/api/og/v2?division=beneficiaries\u0026amp;title=List+beneficiary+virtual+accounts\u0026amp;description=Lists+safe+virtual-account+economics+without+returning+deposit+destinations+or+provider+identifiers.\u0026amp;theme=4a8942d30ddd6eae3a17fa6b\u0026amp;signature=6f293b9017b14838df4b2c3e1bf586b0be916e919fe2bc60720c5c3794cd95e5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/proofoftech/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Perflo Financial Agents API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18A877\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/beneficiaries/list-beneficiary-virtual-accounts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.perflo-api.proofof.tech/#organization\",\"name\":\"Perflo Financial Agents API\",\"url\":\"https://docs.perflo-api.proofof.tech\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.perflo-api.proofof.tech#website\",\"name\":\"Perflo Financial Agents API\",\"url\":\"https://docs.perflo-api.proofof.tech\",\"publisher\":{\"@id\":\"https://docs.perflo-api.proofof.tech/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts#webpage\",\"url\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts\",\"name\":\"List beneficiary virtual accounts\",\"description\":\"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\",\"dateModified\":\"2026-08-23T22:36:01.808Z\",\"isPartOf\":{\"@id\":\"https://docs.perflo-api.proofof.tech#website\"},\"breadcrumb\":{\"@id\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"beneficiaries\",\"item\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiaries\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List beneficiary virtual accounts\",\"item\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts#apireference\",\"headline\":\"List beneficiary virtual accounts\",\"name\":\"List beneficiary virtual accounts\",\"description\":\"Lists safe virtual-account economics without returning deposit destinations or provider identifiers.\",\"url\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.perflo-api.proofof.tech/api-reference/beneficiaries/list-beneficiary-virtual-accounts#webpage\"},\"dateModified\":\"2026-08-23T22:36:01.808Z\",\"publisher\":{\"@id\":\"https://docs.perflo-api.proofof.tech/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.perflo-api.proofof.tech#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Perflo Financial Agents API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Perflo Financial Agents API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/beneficiaries/list-beneficiary-virtual-accounts.md","siteName":"Perflo Financial Agents API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"system","pages":[{"title":"Get process liveness","deprecated":null,"version":null,"openapi":"/openapi.json get /healthz","href":"/api-reference/system/get-process-liveness"},{"title":"Get process readiness","deprecated":null,"version":null,"openapi":"/openapi.json get /readyz","href":"/api-reference/system/get-process-readiness"},{"title":"Get the OpenAPI document","deprecated":null,"version":null,"openapi":"/openapi.json get /openapi.json","href":"/api-reference/system/get-the-openapi-document"},{"title":"Get public capability configuration","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/public-config","href":"/api-reference/system/get-public-capability-configuration"}]},{"group":"operations","pages":[{"title":"List operations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/operations","href":"/api-reference/operations/list-operations"},{"title":"Get an operation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/operations/{id}","href":"/api-reference/operations/get-an-operation"}]},{"group":"operation-webhooks","pages":[{"title":"List webhook subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhook-subscriptions","href":"/api-reference/operation-webhooks/list-webhook-subscriptions"},{"title":"Create a webhook subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhook-subscriptions","href":"/api-reference/operation-webhooks/create-a-webhook-subscription"},{"title":"Delete a webhook subscription","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhook-subscriptions/{id}","href":"/api-reference/operation-webhooks/delete-a-webhook-subscription"},{"title":"Rotate a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhook-subscriptions/{id}/secret-rotations","href":"/api-reference/operation-webhooks/rotate-a-webhook-signing-secret"}]},{"group":"identity","pages":[{"title":"Get the current user","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/user","href":"/api-reference/identity/get-the-current-user"}]},{"group":"kyc","pages":[{"title":"Get verification status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/kyc","href":"/api-reference/kyc/get-verification-status"}]},{"group":"accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Provision an account","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts","href":"/api-reference/accounts/provision-an-account"},{"title":"Get withdrawal limits","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/withdrawal-limits","href":"/api-reference/accounts/get-withdrawal-limits"},{"title":"Get endorsement status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/endorsement","href":"/api-reference/accounts/get-endorsement-status"}]},{"group":"activity","pages":[{"title":"List activity","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/activity","href":"/api-reference/activity/list-activity"}]},{"group":"reference-data","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets","href":"/api-reference/reference-data/list-assets"},{"title":"Get a fiat display rate","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/prices/fiat/{currency}","href":"/api-reference/reference-data/get-a-fiat-display-rate"}]},{"group":"authorization","pages":[{"title":"Get current authorization","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/authorizations/current","href":"/api-reference/authorization/get-current-authorization"},{"title":"Create a confirmation intent","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/confirmation-intents","href":"/api-reference/authorization/create-a-confirmation-intent"}]},{"group":"services","pages":[{"title":"List services","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/services","href":"/api-reference/services/list-services"},{"title":"Get a service","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/services/{id}","href":"/api-reference/services/get-a-service"},{"title":"Find service capabilities","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/service-capabilities","href":"/api-reference/services/find-service-capabilities"},{"title":"Get the best vendor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/best-vendor","href":"/api-reference/services/get-the-best-vendor"}]},{"group":"cards","pages":[{"title":"List cards","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards","href":"/api-reference/cards/list-cards"},{"title":"Reserve a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards","href":"/api-reference/cards/reserve-a-card"},{"title":"Freeze or unfreeze a card","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/cards/{id}","href":"/api-reference/cards/freeze-or-unfreeze-a-card"},{"title":"List card transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}/transactions","href":"/api-reference/cards/list-card-transactions"},{"title":"Get card balance","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/balance","href":"/api-reference/cards/get-card-balance"}]},{"group":"spending","pages":[{"title":"Get the spending account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/spending-account","href":"/api-reference/spending/get-the-spending-account"},{"title":"Create a spending withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/spending-withdrawals","href":"/api-reference/spending/create-a-spending-withdrawal"},{"title":"Get a spending withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/spending-withdrawals/{id}","href":"/api-reference/spending/get-a-spending-withdrawal"}]},{"group":"purchases","pages":[{"title":"Create a purchase quote","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/purchase-quotes","href":"/api-reference/purchases/create-a-purchase-quote"}]},{"group":"beneficiaries","pages":[{"title":"List beneficiaries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries","href":"/api-reference/beneficiaries/list-beneficiaries"},{"title":"Create a beneficiary","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/beneficiaries","href":"/api-reference/beneficiaries/create-a-beneficiary"},{"title":"List beneficiary countries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/countries","href":"/api-reference/beneficiaries/list-beneficiary-countries"},{"title":"List beneficiary address countries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/address-countries","href":"/api-reference/beneficiaries/list-beneficiary-address-countries"},{"title":"List beneficiary schemas","description":"Lists safe payout form definitions for one country.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/schemas","href":"/api-reference/beneficiaries/list-beneficiary-schemas"},{"title":"List beneficiary virtual accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/virtual-accounts","href":"/api-reference/beneficiaries/list-beneficiary-virtual-accounts"},{"title":"Get a beneficiary virtual account","description":"Returns safe virtual-account economics for one API-owned beneficiary identifier.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/beneficiaries/{id}/virtual-account","href":"/api-reference/beneficiaries/get-a-beneficiary-virtual-account"}]},{"group":"transfer-quotes","pages":[{"title":"Create a transfer estimate","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transfer-quotes","href":"/api-reference/transfer-quotes/create-a-transfer-estimate"}]}]}]},"basePath":"","title":"List beneficiary virtual accounts - Perflo Financial Agents API","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}