{
  "openapi": "3.0.1",
  "info": {
    "title": "DirecFunds Experience API",
    "description": "# Getting Started\n\n## Current payment prerequisites\n\nOnly Pay Outs need a separately created Target Account in the granular workflow. Omit Pay In\n`targetAccountId` for normal managed-source funding; that field resolves a HoldingAccount, not a TargetAccount.\n\nDiscover active rails through `GET /PaymentRails` and `GET /DisbursementRequests/Capabilities`.\nZelle is unavailable in Test and Production. ACH/SDACH inline payout accounts require\n`depositAccountType: \"Checking\"` or `\"Savings\"`. SDACH source accounts also need that classification,\nverified ACH capability and `achDebitAuthorizationAccepted: true`.\n\nWire recipients need `address1`, `city` (maximum 35 characters), `state`, and `postalCode`.\nOn verified rails (Wire, ACH, SDACH, RTP, FedNow), a Person needs a past `dateOfBirth`, full address\nand 10-digit `phone`. A Business needs a 9-digit EIN in `tin`, or full address plus phone.\nWire address requirements still apply when an EIN is supplied. Bundled `$Validate` reports locally\navailable identity-input blockers in `preflight`; it does not perform provider identity verification.\nVerification can still refuse an otherwise valid draft.\n\nSDACH funding holds dependent payouts until provider good-funds confirmation and\n`funding.goodFundsReleaseAt`. The configured Production hold recorded October 9, 2026 is\n120 hours; use the returned release time rather than hard-coding it. `Processing` can mean a funding wait.\nBundled `202` and granular verification `200` can include failed/inconclusive verification with no routing.\nInspect authoritative status and `allowedNextActions` before proceeding.\n\nRead `approvalRequirements.requiresSeparateApprover`; separation also applies under limit,\npermission and Production fallback rules. If supplied, `intendedApproverUserId` must differ from the requester.\nReserved Test routing `100000000` is accepted only at `https://testapi.direcfunds.com/v1`;\nreal instructions require directory validation, which replaces the supplied bank name.\nUse `POST /Sandbox/$Prepare` to obtain the dedicated synthetic bankAccountId and userId.\n\n\n## Overview\n\nThe DirecFunds Experience API provides treasury management with modern good-funds payment solutions.\nDirecFunds lets you manage your company, branches, bank accounts, and users with our out-of-the-box permission models for disbursing funds.\n\nDuring company registration, select the products the business will use. DirecFunds reviews and enables\neach requested product separately; requesting access does not authorize transactions. The\nbusiness-disbursement API examples in this guide require Business disbursements to be enabled and a\nverified company source account. A company using only Due diligence payments can instead use the\nPortal's buyer-funded property-payment workflow without a company source account, after product\napproval and the usual identity, billing, agreement, user, and recipient checks. The Experience API\ndisbursement-request endpoint is for Business disbursements, not the due diligence Portal workflow.\n\n### Account Management\n\n| Object       | Purpose                                                      |\n| ------------ | ------------------------------------------------------------ |\n| Company      | Created during onboarding. High level object for your business. Contains details for your company's disbursement permission model. |\n| Branch       | Internal payment and permission scope. DirecFunds creates one default scope during onboarding even when the company has no physical offices. Add more only when office-level separation is useful. |\n| Bank Account | Trust/source-account information used to fund disbursements. Create it once, assign it to one or more payment scopes, verify it, and use the returned id in later requests. |\n| User         | Represents an employee of the company. Used to create and send disbursements. Can be assigned permissions to disburse from specific bank accounts and payment scopes. |\n| Address      | Represents an address in the United States.                   |\n\n### Disbursement Approval Strategies\n\n| Strategy                | Description                                                  |\n| ----------------------- | ------------------------------------------------------------ |\n| Single Party Approval   | One user may create and send disbursements.                  |\n| Two Party Approval      | One user may request disbursements and another user must approve them. |\n| Single Party Approval with Limit | Global limit for users to send disbursements. A disbursement at or above the limit requires a separate approver; so does one whose requester lacks approve permission. |\n\n### Disbursements and Pay Outs\n\n| Object         | Purpose                                                      |\n| -------------- | ------------------------------------------------------------ |\n| Disbursement   | Mechanism for moving funds through one or more transfers from one source account. |\n| Pay In         | Details for funding from a company source bank account. |\n| Pay Out        | Details for a funds transfer, credited and debited accounts, and recipient. |\n| Target Account | Banking information for a Pay Out destination |\n\n## Base URLs\n\nUse the explicit `/v1` prefix in new integrations. Unversioned calls continue to resolve to v1 for compatibility, but `/v1` makes the intended contract unambiguous.\n\n| Environment | Base URL |\n| ----------- | -------- |\n| Production  | `https://api.direcfunds.com/v1` |\n| Test        | `https://testapi.direcfunds.com/v1` |\n\n## Authentication\n\nThe API uses the OAuth 2.0 client-credentials grant. An administrator enables **Manage API Integration** in the DirecFunds portal to obtain a Client ID and Client Secret. Keep the secret out of source control and rotate it if it is exposed.\n\nStart in Test. Production uses a separate application and authority; never reuse Test credentials,\nthe Test token endpoint, or the Test scope in Production.\n\n| Item | Test | Production |\n| ---- | ---- | ---------- |\n| Discovery document | `https://direcfundstest2.b2clogin.com/direcfundstest2.onmicrosoft.com/B2C_1A_CLIENT_CREDENTIALS/v2.0/.well-known/openid-configuration` | `https://direcfundsprod2.b2clogin.com/direcfundsprod2.onmicrosoft.com/B2C_1A_CLIENT_CREDENTIALS/v2.0/.well-known/openid-configuration` |\n| Token endpoint | `https://direcfundstest2.b2clogin.com/direcfundstest2.onmicrosoft.com/B2C_1A_CLIENT_CREDENTIALS/oauth2/v2.0/token` | `https://direcfundsprod2.b2clogin.com/direcfundsprod2.onmicrosoft.com/B2C_1A_CLIENT_CREDENTIALS/oauth2/v2.0/token` |\n| Scope | `https://direcfundstest2.onmicrosoft.com/public/.default` | Use the Production scope issued with the Production credential pair. |\n\nProduction credentials and their scope are issued when Production access is approved.\n\nRequest a token with an `application/x-www-form-urlencoded` body (not multipart form data):\n\n```bash\ncurl --request POST \\\n  --url 'https://direcfundstest2.b2clogin.com/direcfundstest2.onmicrosoft.com/B2C_1A_CLIENT_CREDENTIALS/oauth2/v2.0/token' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --data-urlencode 'grant_type=client_credentials' \\\n  --data-urlencode 'client_id=<YOUR_CLIENT_ID>' \\\n  --data-urlencode 'client_secret=<YOUR_CLIENT_SECRET>' \\\n  --data-urlencode 'scope=https://direcfundstest2.onmicrosoft.com/public/.default'\n```\n\nResponse Content:\n\n```json\n{\n  \"access_token\": \"<TOKEN>\",\n  \"token_type\": \"Bearer\",\n  \"not_before\": 1765842893,\n  \"expires_in\": 3600,\n  \"expires_on\": 1765846493,\n  \"resource\": \"00000000-0000-0000-0000-000000000000\"\n}\n```\n\nPass the `access_token` on every request as `Authorization: Bearer <token>`. Refresh it before it expires rather than waiting for a 401 response.\n\n## Versioning\n\nThe API is versioned; the current version is v1. Requests may target it via the URL prefix (https://testapi.direcfunds.com/v1/...) or with no version specified (treated as the default, v1). Unversioned requests continue to work unchanged. You may also pin a version with the `api-version` query parameter or the `X-Api-Version` header. A future v2 with breaking changes will run side by side without affecting v1 callers.\n\nBreaking contract changes require compatibility review, partner notice, Test certification, and\ncontrolled rollout. CI compares every generated candidate contract with the PR-base v1 contract and\nblocks removed operations or fields, newly required inputs, narrowed constraints, closed-enum\nchanges, one-time closed-to-extensible status migrations, and callback-contract changes unless an\nexplicit, expiring waiver has been approved.\n\n## Idempotency\n\nState-changing requests support an idempotency key so a network retry cannot create a duplicate operation. This applies to `POST /DisbursementRequests`, the bundled `$SubmitForApproval`, `$VerifyAndSend`, `$Reject`, `$Cancel`, and `$CancelSchedule` actions and recipient-payment `$Cancel`, webhook subscription creation, diagnostics, and redelivery, creating a granular disbursement, pay in, or pay out (including `$CreateWithLegs`), the disbursement `$Request`, `$Verify`, `$Send`, and `$VerifyAndSend` actions, `POST /BankAccount/{id}/$Verify`, `POST /Onboarding/$Provision`, and the branch bank-account and permission-automation `PUT`s. Production requires the header on protected money operations when configured enforcement is enabled; Test follows its own environment setting. Webhook subscription creation, `$Test`, and `$Redeliver` always require it in every environment. Send a key on every supported operation in both Test and Production:\n\n```\nX-Idempotency-Key: <UUID v4>\n```\n\nSend the same key when safely retrying the same request; the key is honored through to the downstream payment services, so a retry after a timeout will not double-submit. In particular, repeating a bank-account `$Verify` with the same key replays the original verification outcome rather than starting (and billing) a new verification. Use a fresh key for each distinct operation.\n\nA rejected keyed request returns a Problem Details body (`type`/`status`/`title`/`detail`/`traceId`):\n\n| Status | When | What to do |\n| ------ | ---- | ---------- |\n| `400` | The key is missing on an always-required operation (webhook create, `$Test`, or `$Redeliver`) or when legacy-operation enforcement is enabled; it was sent more than once; or it is not a valid UUID v4. `title` is `Invalid Idempotency Key`; the `type` slug varies by refusing layer (`BadRequest` or `InvalidIdempotencyKey`), so match on title and status. | Send exactly one well-formed UUID v4 key. |\n| `409` | The original request with this key is still being processed. `type` is `IdempotencyKeyInFlight`. | Retry unchanged (same key, same body) after a short delay. |\n| `422` | The key was already used with a different request body. `type` is `IdempotencyConflict`. | Use a fresh key for a new operation; never edit the body of a retry. |\n\nOn every `POST`, resource ids are server-assigned: an `id` supplied in the request body is ignored.\n\nThe API only retries safe reads and idempotent writes automatically. A `POST` or `PATCH` without an idempotency key is never replayed by the gateway; requests carrying a key may be retried internally on transient downstream failures, with a circuit breaker in front of each internal service (a dependency that keeps failing surfaces as `502`, not a hung call). Read and non-money calls additionally carry a 10-second per-attempt timeout, so one slow attempt is retried rather than waited out. **Money-path attempts are deliberately NOT time-sliced**: a `$Send`/`$Verify` that is legitimately slow is allowed to finish (bounded only by the overall request timeout) instead of being cancelled mid-flight and retried against an operation that is still executing. If you do see `409 Request Still Processing`, the original keyed request is still running — retry shortly with the **same** `X-Idempotency-Key` to collect its outcome; do not switch to a new key.\n\n## Pagination\n\nCollection endpoints accept `limit` and `cursor` query parameters. Existing unpaged v1 calls continue\nto return the full collection for compatibility. New integrations should send `limit` (maximum 500);\nthat opts the request into cursor pagination. Send the same `limit` on every request in a pagination\nwalk. If `limit` is omitted while following a cursor, the server applies its default of 100, so only\na cursor originally issued with that page size remains valid.\n\n```bash\ncurl --get https://testapi.direcfunds.com/v1/Address \\\n--data-urlencode 'limit=100' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nWhen more records are available, the response includes an opaque `X-Next-Cursor` header. Pass that value unchanged as the next request's `cursor`. `X-Page-Limit` reports the applied page size.\n\nA cursor is bound to the endpoint, exact filter, and page limit it was issued for. Replaying a cursor\nwith a different filter or limit, sending a malformed or modified cursor, or sending a cursor issued\nunder an earlier cursor format all return `400 Invalid Cursor`. Treat any cursor `400` as\nnon-retryable: restart the listing from the first page and keep both filter and limit constant for\nthe life of the pagination walk.\n\n## Conditional Requests\n\nSuccessful single-resource responses include an `ETag`. Send it as `If-None-Match` on a later GET to receive `304 Not Modified` when the resource is unchanged. Send it as `If-Match` on PUT and DELETE requests to prevent a stale client from overwriting a newer version; a mismatch returns `412 Precondition Failed`.\n\n## Request IDs and Rate Limits\n\nEvery response includes `X-Request-Id` and `X-Trace-Id`. They are two names for the same correlation id — `X-Trace-Id` is the canonical name, `X-Request-Id` is kept for compatibility. Include the value when contacting support so the request can be found in the audit trail.\n\nThe default integration allowance is 600 requests per minute per integration. Unauthenticated requests share a separate, much tighter anonymous allowance (60 requests per minute), so always authenticate before probing the API. A request over its limit returns `429 Too Many Requests` with a Problem Details body. `RateLimit-Limit` reports the applicable allowance, `RateLimit-Remaining` is `0`, and `Retry-After` / `RateLimit-Reset` report the seconds to wait before retrying.\n\n## Filtering\n\nAll of our listing GET endpoints (E.g. /Branch or /Address) are able to be filtered. The following filter types are available:\n\n| Filter Type      | Description                                            |\n| ---------------- | ------------------------------------------------------ |\n| Match            | Does a string match exactly?                           |\n| Contains         | Does a string contain the filter value?                |\n| LessThan         | Is the numeric less than the filter value?             |\n| LessThanEqual    | Is the numeric less than or equal the filter value?    |\n| Equal            | Is the numeric equal to the filter value?              |\n| NotEqual         | Is the value not equal to the filter value?            |\n| GreaterThan      | Is the numeric greater than the filter value?          |\n| GreaterThanEqual | Is the numeric greater than or equal the filter value? |\n\nPass dynamic-filter JSON in the `filter` query parameter. GET request bodies remain accepted temporarily for compatibility, but new integrations should use query parameters because intermediaries may ignore GET bodies. The general filter format is:\n\n```json\n{\n\t\"<Property_Name>\": [\n        {\n            \"type\": \"<Filter_Type>\",\n            \"value\": \"<Filter_Value>\"\n        }\n    ]\n}\n```\n\nThe property names identify model fields to filter. Each property is an array of API filters, and each filter has a type and a value.\n\nOnly the endpoint's documented response fields are filterable: a filter key must be a property of the resource shape published in the API reference (matched case-insensitively). Bank-account `accountNumber` and `routingNumber` are deliberately excluded because the stored values are secret and only masked values are returned. The gateway validates the whole filter up front and returns `400` with a Problem Details body naming the offending part when the filter is not valid JSON, is not a JSON object of property-name arrays, names a property that is not filterable on that endpoint, or uses a `type` outside the operator table above. A filter `400` is never retryable unchanged — fix the filter first.\n\nFor example, this filter on `GET /Address` finds every address with a state of `OH`:\n\n```json\n{\n\t\"state\": [\n\t\t{\n\t\t\t\"type\": \"Match\",\n\t\t\t\"value\": \"OH\"\n\t\t}\n\t]\n}\n```\n\n```bash\ncurl --get https://testapi.direcfunds.com/v1/Address \\\n--data-urlencode 'filter={\"state\":[{\"type\":\"Match\",\"value\":\"OH\"}]}' \\\n--data-urlencode 'limit=100' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nWhere available, prefer typed equality filters such as `GET /Disbursement?status=Verified` and `GET /PayOut?transferStatus=Completed`.\n\n# Walkthrough\n\n## Check Company\n\nCreated during onboarding, check your company is created with the appropriate data.\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/Company \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nResponse Content:\n\n```json\n{\n\t\"id\": \"00000000-0000-0000-0000-000000000001\",\n\t\"name\": \"My Company LLC\",\n\t\"approvalStrategy\": \"Two Party Approval\",\n\t\"active\": true\n}\n```\n\n## Create Address\n\nAddresses are used for bank accounts and branches.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/Address \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{ \n\t\t\"address1\": \"ACB Company\",  \n\t\t\"address2\": \"Suite 100\",  \n\t\t\"city\": \"Cincinnati\",  \n\t\t\"state\": \"OH\", \n\t\t\"postalCode\": \"45000\"\n\t}'\n```\n\n## Create Phone Number\n\nPhone Numbers are defaulted to the U.S. International phone numbers are not currently supported.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/PhoneNumber \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{ \n\t\t\"number\": \"5134448888\"\n\t}'\n```\n\n## Check Payment Scopes\n\nDirecFunds creates a default internal payment scope with your company. It does not need to represent\na physical office. Add another scope only when you need separate account access or user authority.\nThe API resource remains named `Branch` for compatibility. This example has two payment scopes.\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/Branch \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nResponse Content:\n\n```json\n[   \n\t{\n\t\t\"id\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"name\": \"Main Branch\",\n\t\t\"addressId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"active\": true   \n\t},\n\t{\n\t\t\"id\": \"00000000-0000-0000-0000-000000000002\",\n\t\t\"name\": \"Satellite Branch\",\n\t\t\"addressId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"active\": true   \n\t}\n]\n```\n\n## Add Bank Accounts\n\nA bank account will serve as the source of funds for disbursements. Only the fields below are accepted. `nickName` is optional; supply depositAccountType as Checking or Savings for ACH/SDACH accounts. Verification status is managed by DirecFunds.\n\nThis example uses the reserved `100000000` routing number in **Test only**. It does not call an external bank directory. Replace the routing number and account details with validated bank information in Production, and use an address id belonging to your company. The bank name returned by the API comes from the bank directory.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/BankAccount \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{ \n\t\t\"bankName\": \"DirecFunds UAT Bank\",\n\t\t\"nickName\": \"Operating Escrow\",  \n\t\t\"beneficiary\": \"My Company LLC\",  \n\t\t\"accountNumber\": \"100010004\",  \n\t\t\"routingNumber\": \"100000000\",\n\t\t\"depositAccountType\": \"Checking\",\n\t\t\"addressId\": \"00000000-0000-0000-0000-000000000001\"\n\t}'\n```\n\nA newly created bank account starts in an `Unverified` status and must be assigned to a branch and\nverified before it can fund a disbursement. First read the branch's current account-assignment document:\n\nOrdinary `GET /BankAccount` and `GET /BankAccount/{id}` responses use a partner-safe read projection:\n`accountNumber` and `routingNumber` are returned as `****` plus their last four digits. Retain full\ncredentials securely when creating or updating an account; never treat a GET response as a reusable\nwrite payload. Use the readiness endpoints below for funding go/no-go decisions.\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/Branch/00000000-0000-0000-0000-000000000001/BankAccounts \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nRetain the response `ETag`, then replace the complete assignment. `If-Match` prevents a stale client\nfrom overwriting a newer change; the operation is naturally idempotent and also requires a retry key.\nIf the response to this `PUT` is lost, do not blind-retry: when the first attempt applied, it changed\nthe ETag, so a same-key retry returns `412`. Re-`GET` the assignment document, compare it with what\nyou intended to write, and only re-send (with the fresh ETag) if the change is still missing.\n\n```bash\ncurl --request PUT \\\n--url https://testapi.direcfunds.com/v1/Branch/00000000-0000-0000-0000-000000000001/BankAccounts \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'If-Match: \"<ETAG>\"' \\\n--header 'X-Idempotency-Key: <UUID-V4>' \\\n--data '{ \"bankAccountIds\": [\"00000000-0000-0000-0000-000000000001\"] }'\n```\n\nThen request verification:\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/BankAccount/00000000-0000-0000-0000-000000000001/\\$Verify \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>'\n```\n\nThe response reports `verificationStatus`, `supportsAch`, `supportsWire`, and\n`wireDrawdownReady`. Verification advances the account through `Unverified` -> `Verifying` ->\n`Active` (or `Inconclusive` / `Restricted`, which require follow-up). `Drawdown` means the verified\naccount's separate reverse-wire funding setup is complete. DirecFunds manages these statuses; callers\nnever set them directly.\n\n## Add Users\n\nUsers create and send disbursements. Depending on your company's disbursement approval strategy you may need to set up users which have request permissions and users which have approval permissions.\nThis example creates users within a two party approval strategy. Creating a user through the API registers the person; only the fields shown below are accepted. Branch and bank account permissions are assigned separately in the DirecFunds portal (see the note after this step) — sending a non-empty `branchPermissions` or `bankAccountPermissions` on a User request returns a 400 (omitting the fields or sending empty arrays is accepted).\n\n> Bob works at the Satellite branch and only requires permissions to request disbursements at the Satellite branch from the PNC Escrow Account.\n\n> Alice is a regional manager who requires permissions to approve disbursements at both the Satellite and Main branches from the PNC Escrow Account.\n\nAdd Bob\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/User \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{\n\t\t\"givenName\": \"Bob\",\n\t\t\"surname\": \"Doe\",\n\t\t\"email\": \"bob.doe@mycompany.com\",\n\t\t\"phone\": \"5551234567\"\n\t}'\n```\n\nAdd Alice\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/User \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{\n\t\t\"givenName\": \"Alice\",\n\t\t\"surname\": \"Smith\",\n\t\t\"email\": \"alice.smith@mycompany.com\",\n\t\t\"phone\": \"5553232898\"\n\t}'\n```\n\n### User lifecycle\n\nNew users are active, non-administrator users. For an ordinary profile update, first\n`GET /User/{id}`, retain its `ETag`, and send the complete required profile to `PUT /User/{id}` with\nthat value in `If-Match`. To deactivate a user, send `DELETE /User/{id}` with the current `If-Match`;\nthis is a soft deactivation, not permanent erasure. Deactivated users are omitted from `GET /User`\nand `GET /User/{id}` returns `404`, so retain the user id and profile in your own authorized system\nif reactivation may be needed.\n\nTo reactivate, send `PUT /User/{retainedId}` with the required profile fields and `\"active\": true`.\nThe reactivation request does not require `If-Match` because a deactivated user has no readable\npublic representation from which to obtain an ETag. Omit `active` on creation and ordinary updates;\n`\"active\": false` is rejected. Use `DELETE` to deactivate.\n\n## Assign Permissions in the Portal\n\nBranch and bank account permissions are managed by an administrator. By default, assign them in the DirecFunds portal. An administrator may explicitly enable **Allow Permission Automation** for an API integration; only then can that integration use the dedicated `User/{id}/Permissions` endpoint. Permission fields on ordinary User create and update requests remain read-only. A disbursement's `$Request` is rejected if the requester lacks request permission, and `$Verify` is rejected if the approver lacks approve permission, on the branch and source account.\n\n### Automate permissions (opt-in)\n\nFirst `GET /User/{userId}/Permissions` and retain its `ETag`. Then `PUT /User/{userId}/Permissions` with the complete desired `branches` collection, `If-Match` set to that ETag, and a new `X-Idempotency-Key`. The operation atomically replaces the user's branch and source-account permissions. A stale ETag returns `412`; reusing an idempotency key with different data returns `422`.\n\n## Check Onboarding Readiness\n\nUse one company-scoped readiness check before showing a live-disbursement action:\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/Onboarding/Readiness \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nThe response combines company activation, KYB/KYC, required agreements, active branches, masked\nsource-account verification and funding capabilities, active users, and payment authority. Treat\n`disbursementsEnabled` as the go/no-go value. When it is `false`, branch on the stable `findings[].code`\nand show the accompanying message. The endpoint deliberately does not expose full account numbers,\nidentity data, signed documents, or provider evidence.\n\n### Render a setup wizard: GET /Onboarding/Checklist\n\n`GET /Onboarding/Checklist` returns the same state as ordered steps you can render directly:\neach step carries a `status` (`Complete`/`ActionRequired`), whether it is `actionableByPartner`\n(company activation, KYB/KYC, and agreements are DirecFunds-side), the `action` (method + href)\nthat completes it, and the blocking `findings` codes. Step status is derived from the readiness\nfindings, so the two documents never disagree.\n\n### Diagnose a specific user or account\n\n- `GET /User/{userId}/Readiness` answers \"why can't this user request or approve?\": effective\n  `canRequestDisbursements`/`canApproveDisbursements`, per-branch authority, and which granted\n  trust accounts are funding-ready.\n- `GET /BankAccount/{bankAccountId}/Readiness` answers \"why can't this account fund?\": verification\n  status, branch assignment, Same Day ACH debit and reverse-wire readiness, retained bank capability\n  metadata, and the users authorized on it. `achReady` means the account is ready for managed\n  `SamedayAch` debit; it does not enable standard `Ach` funding.\n\nBoth return a tenant-scoped 404 for ids outside your company.\n\n### Provision in one call: POST /Onboarding/$Provision\n\n`POST /Onboarding/$Provision` performs the partner-actionable setup steps in one request: branch\n(with address and phone number), trust account (with address), branch assignment, users, and\npayment authority. It is **convergent, not transactional**: existing resources are matched by\nnatural key (branch by name, account by routing + account number, user by email) and reused,\ngrants are merged and never revoked, and each step reports its own outcome (`Created`, `Exists`,\n`Updated`, `Unchanged`, `Planned` (dry run), `Failed`, `Skipped`). If a step fails, replaying the same request safely\ncompletes the remaining work. A matching inactive user is reactivated; a matching disabled bank\naccount is reported as a failed `EnsureBankAccount` step and is never presented as ready or reused.\nSet `\"dryRun\": true` to preview the plan without writing. Two\ndeliberate exclusions: bank verification is never triggered by the bundle (call the billable\n`$Verify` explicitly), and the payment-authority step requires permission automation to be enabled\nfor your integration — without it that single step reports a 403 problem while the rest of the\nbundle still applies.\n\n## Time to Disburse!\n\nFor new integrations, the primary money-movement object is a **disbursement request**. Send one\nfunding instruction, all `recipientPayments`, approval context, and your stable client reference to\n`POST /DisbursementRequests` with one `X-Idempotency-Key`. The funding instruction\nidentifies the source account and requested funding rail; DirecFunds calculates the pay-in amount\nfrom the recipient payment amounts. A request contains 1 to 100 recipient payments. Optional\n`expectedTotal` is only a mismatch guard.\n\n`branchId` is optional on both `POST /DisbursementRequests/$Validate` and\n`POST /DisbursementRequests`. When omitted, DirecFunds resolves it only if exactly one active branch\nis authorized for the authenticated integration, requester, and source account. The resolved id is\nstored and returned for auditability. Zero eligible scopes returns `400 NO_ELIGIBLE_PAYMENT_BRANCH`;\nmultiple eligible scopes returns `400 PAYMENT_BRANCH_SELECTION_REQUIRED`, in which case send the\nchosen `branchId` or narrow the integration mapping. An explicit `branchId` is still checked against\nthe same permissions and cannot bypass them.\n\nIf DirecFunds provisioned custom disbursement fields for your company, include them as\n`extendedInputs`: each item contains the supplied `templateId` and a `value` of at most 2,048\ncharacters. Template IDs are provided during onboarding; omit `extendedInputs` when none were\nprovisioned. The server rejects unknown or out-of-scope templates and snapshots the server-owned\nname, display label, type, and tenant scope with the request, so later template changes cannot alter\nthe accepted batch.\n\nDirecFunds does not model a title-platform Order and the request has no `orderId`. Map one Order\ndisbursement to one independent request with 1 to 100 recipient payments. A multi-Order selection\nfans out as separate calls with per-request results; there is no atomic bulk rollback. One Order may\nproduce multiple requests over time, but every request needs a distinct company-unique\n`clientReference` and recipient payments cannot be appended to an existing request.\n\nFinish and validate the editable draft in your own system, atomically claim it there, and then create\nthe immutable bundle. DirecFunds does not expose a partner ledger-lock API or post-create bundle\nediting. The local claim and the stable `clientReference`/idempotency key prevent two workers from\ncreating the same closing.\n\n**Validation tightenings** (behavior changes for integrations that previously relied on lenient\nhandling; each now returns `400` with a Problem Details body naming the field):\n\n- Amounts accept at most **2 decimal places**. A 3-decimal amount (e.g. `10.005`) used to be\n  silently rounded on insert, permanently unbalancing the disbursement; it is now rejected.\n- The wire memo (`transactionDetails.memoLine`) character set is tightened: the characters\n  `[ \\ ] ^ _` and `` ` `` are rejected (they are not transmissible in the wire message text).\n- A recipient `stateId`, when provided, must be a **2-letter** state code, and `postalCode` is\n  limited to **16 characters**.\n- On `$CreateWithLegs`, a pay-out leg with `transactionPurpose: \"Other\"` must include\n  `otherPurpose` describing the payment (256 characters or fewer), matching the flat\n  `POST /PayOut` contract.\n\nManaged company/trust source-account funding supports `Wire`, using the account's pre-authorized\nreverse-wire drawdown, and `SamedayAch` debit from a verified ACH-capable account. A Same Day ACH\nfunding instruction must include `achDebitAuthorizationAccepted: true`; DirecFunds retains the\nauthorization evidence with the pay in. Standard `Ach` funding is rejected with `400`. Both ACH\nrails remain available for recipient pay outs.\n\nDirecFunds validates the complete graph and creates the disbursement, pay-in, immutable account\nsnapshots, and pay-outs in one transaction. The response returns the stable request id, per-payment\nstatuses and attempts, current closing status, allowed actions, and links to the unchanged granular\nresources.\n\nUse `POST /DisbursementRequests/$Validate` to preflight. Its `approvalRequirements` object tells you\nthe configured strategy, whether this exact request requires a separate approver, whether its\nrequester may self-approve, and why. Stable `reasonCode` values are `TWO_PARTY_STRATEGY`,\n`AMOUNT_AT_OR_ABOVE_THRESHOLD`, `REQUESTER_LACKS_APPROVE_PERMISSION`, `APPROVAL_LIMIT_NOT_CONFIGURED`,\n`PRODUCTION_APPROVAL_POLICY_FALLBACK`, and `SINGLE_PARTY`. Treat any other value as requiring a\nseparate approver.\nThe private monetary threshold is not returned and must not be hard-coded by clients.\n\nRead the optional `preflight` assessment separately from `valid`. Existing draft validation is\nunchanged: `valid: true` can accompany `preflight.status: \"InputRequired\"` when recipient identity\nevidence is incomplete. This is useful for saving a draft, but the evidence must be completed before\nverification. If an older backend omits `preflight`, no readiness conclusion can be drawn.\n\n| Preflight status | Meaning | Next step |\n| --- | --- | --- |\n| `Blocked` | Draft validation has errors. | Resolve the blocking findings and validate again. |\n| `InputRequired` | Draft is valid, but known recipient identity input is incomplete. | Complete the inline or saved recipient identified by each finding, then validate again. |\n| `VerificationRequired` | Draft and locally assessed identity input passed. | Review company readiness, approval requirements, verification price, and required consent before authorized provider verification. |\n\n`preflight.findings` provides a stable `code`, public JSON `path`, optional `paymentReference`,\n`category`, `resolutionOwner`, `nextAction`, and `blocksVerification`. Original `issues` remain\navailable with their existing draft-validation meaning. Identity findings reuse the same evidence\nrules as payment execution; an evidence-presence pass is not a successful identity check.\n\nFor example, a person with an address and phone but no date of birth receives a finding with\n`code: \"RECIPIENT_DATE_OF_BIRTH_REQUIRED\"` and\n`path: \"recipientPayments[0].recipient.dateOfBirth\"`. Complete fields are not repeated as missing.\nBusiness findings retain the EIN **or** complete-address-and-phone alternative. Saved-recipient\nfindings point to `destination.savedRecipientId` and direct the administrator to update that saved\nrecord; adding inline identity values does not override the saved snapshot.\n\n`preflight.checks` explicitly distinguishes `Passed`, `Blocked`, `Required`, `NotPerformed`,\n`NotAssessed`, and `NotApplicable`. An alias-only payment reports bank-rail identity evidence as\n`NotApplicable`, rather than claiming an evidence check passed. Approval remains required.\nProvider verification is not performed by validation;\ncompany readiness, verification pricing, funding release, and delivery timing are not assessed by\nthis endpoint. Follow `Onboarding/Readiness`, current pricing/consent, and the created request's\nfunding and delivery evidence for those decisions. Unknown statuses or check codes require review;\nnone authorizes money movement.\n\n`GET /DisbursementRequests/{id}` and normalized create/action responses also return the current\neffective `approvalRequirements`. DirecFunds safely recalculates it from stored request facts plus\nthe current approval strategy and permissions, so refresh the request before presenting a decision.\nUse `/Events` and `/Reconciliation` for audit and balancing,\n`POST /DisbursementRequests/{id}/$VerifyAndSend` to approve and begin eligible execution, or\n`POST /DisbursementRequests/{id}/$Reject` for an approver to record a distinct rejection. Reject\nrequires an authorized `approverUserId`, `reviewConfirmed: true`, a meaningful `reason`, and a fresh\n`X-Idempotency-Key`; it is refused after any funding or recipient leg is dispatched. An exact retry\nwith the original key replays the result without appending another decision.\n`/Events` and `/Reconciliation` are read-only: they report execution evidence and totals but never\nsubmit, retry, or advance a payment.\n\n`$VerifyAndSend` requires an authorized `approverUserId`. Its `reviewConfirmed` flag records review\nof the amount, funding source, recipients, destination accounts, and delivery methods. Omission is\ninterpreted as `true` only for compatibility with integrations that predate the flag; new clients\nshould send `true` explicitly after review. Sending `false` returns `400` and moves no money.\n\nSet `approvalContext.submitForApproval` to `false` to stage a request in `Initialized`, then call\n`POST /DisbursementRequests/{id}/$SubmitForApproval`. For a future `scheduledFor` (up to 365 days),\n`$VerifyAndSend` verifies and holds the request in `Scheduled`. DirecFunds automatically releases it\nfor routing at or after the due time; no second partner call is required. `scheduledFor` is the\nrequested processing time, not a guaranteed settlement time.\n`$CancelSchedule` clears the timestamp and returns it to `PendingApproval`; request-level `$Cancel`\nabandons the entire undispatched request. `$Reject` is a reviewed approval decision and changes the\nrequest to `Rejected`; `$Cancel` is abandonment and changes it to `Canceled`.\n\nA `201 Created` or `202 Accepted` response acknowledges the API resource or action; it is not proof\nof routing, provider submission, payment, or settlement. In particular, a successful bundled\n`$VerifyAndSend` response can contain `request.status` `Scheduled`, `Processing` (including the\ninternal `PendingInfo` funding wait), or `NeedsAttention`; branch on that returned state and continue\nwith authoritative reads and signed webhooks. Verification `Failed` is a conclusive negative, while\n`Inconclusive` means no conclusive result and must not be labeled confirmed fraud. Provider `Failed`\nand provider `Rejected` are distinct transfer outcomes, and neither is the same as request-level\n`Rejected`. A return or clawback discovered after apparent settlement is a later lifecycle and\nreconciliation fact; preserve the original history and refresh authoritative state.\n\n### Advanced: granular resource assembly\n\nDisbursements group one or more pay outs. Their total is drawn from a single source account and sent to the corresponding target accounts.\n\nThis example creates a disbursement with one Pay In and one Pay Out. Bob is the requester; the approver is designated later, at the `$Verify` step, and cannot be set when the disbursement is created.\n\n#### Disbursement\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/Disbursement \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>' \\\n--data \\\n\t'{\n\t    \"branchId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"requesterUserId\": \"00000000-0000-0000-0000-000000000001\"\n\t}'\n```\n\n#### Pay In\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/PayIn \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>' \\\n--data \\\n\t'{\n\t\t\"disbursementId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"sourceAccountReferenceId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"paymentRail\": \"Wire\",\n\t\t\"amount\": 1.00\n\t}'\n```\n\n`Wire` pay ins use the source account's pre-authorized reverse-wire (drawdown) setup. `SamedayAch`\npay ins use a verified ACH-capable source account and must include\n`\"achDebitAuthorizationAccepted\": true`. These are the supported managed source-account funding\nmethods on the flat Pay In, `$CreateWithLegs`, and bundled request paths. Standard `Ach` funding is\nunsupported; `Ach` and `SamedayAch` remain available for pay outs.\n\nA pay in keeps a copy of its source account's bank details, and a Same Day ACH debit is filed against\nthat copy. The copy's account number, routing number, beneficiary, account type, and SWIFT/BIC cannot\nbe changed afterwards: `PUT /TargetAccount/{id}` returns `400` for them. To fund from different bank\ndetails, update the managed bank account, then delete and recreate the pay in.\n\n#### Pay Out Target Account\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/TargetAccount \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--data \\\n\t'{\n\t\t\"bankName\": \"U.S. Bank\",\n\t\t\"accountNumber\": \"100200200\",\n\t\t\"routingNumber\": \"100000000\",\n\t\t\"depositAccountType\": \"Checking\",\n\t\t\"accountBeneficiary\": \"Beneficiary\",\n\t\t\"bankAddress1\": \"500 Walnut St\",\n\t\t\"bankCity\": \"Cincinnati\",\n\t\t\"bankState\": \"OH\",\n\t\t\"bankPostalCode\": \"45000\"\n\t}'\n```\n\n#### Pay Out\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/PayOut \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>' \\\n--data \\\n\t'{\n\t\t\"disbursementId\": \"00000000-0000-0000-0000-000000000001\",\n\t\t\"paymentRail\": \"Wire\",\n\t\t\"amount\": 1.00,\n\t\t\"transactionPurpose\": \"LoanPayoff\",\n\t\t\"targetAccountId\": \"00000000-0000-0000-0000-000000000002\",\n\t\t\"recipient\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"dateOfBirth\": \"1992-10-10T00:00:00Z\",\n\t\t\t\"address1\": \"50 Centennial Ave\",\n\t\t\t\"address2\": \"Apt C\",\n\t\t\t\"address3\": \"\",\n\t\t\t\"address4\": \"\",\n\t\t\t\"city\": \"Cincinnati\",\n\t\t\t\"state\": \"OH\",\n\t\t\t\"postalCode\": \"45000\",\n\t\t\t\"phone\": \"5134556770\",\n\t\t\t\"email\": \"john.doe@gmail.com\",\n\t\t\t\"tin\": \"123456789\",\n\t\t\t\"recipientType\": \"Person\"\n\t\t},\n\t\t\"transactionDetails\": {\n\t\t\t\"memoLine\": \"Wire Memo\"\n\t\t}\n\t}'\n```\n\n#### Request (submit for approval)\n\nA freshly created disbursement is `Initialized` and cannot be verified yet. The requester submits it for approval with the Request action, which moves it to `Pending Approval`. Use the Disbursement's Id in the route.\n\n> Skipping this step leaves the disbursement `Initialized`, and `$Verify` returns `400 - Disbursement cannot be in status [10]`.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/Disbursement/00000000-0000-0000-0000-000000000001/\\$Request \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>'\n```\n\nBefore it can be sent, a disbursement and its pay outs must be verified. In a two-party approval strategy, use the Verify action and then the Send action. See `/Disbursement` in the API reference for the bound actions.\n\n> Alice is set as the approver on the Verify request. Use the Disbursement's Id in the route to verify the disbursement.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/Disbursement/00000000-0000-0000-0000-000000000001/\\$Verify \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>' \\\n--data \\\n\t'{\n\t\t\"approverUserId\": \"00000000-0000-0000-0000-000000000002\",\n\t\t\"reviewConfirmed\": true\n\t}'\n```\n\nResponse Content:\n\n```json\n{\n\t\"status\": \"Verified\",\n\t\"message\": \"Disbursement has been verified successfully and is ready to send\"\n}\n```\n\nA successful verification confirms the required permissions and pay outs are valid. Use the Disbursement's Id in the route to send the disbursement.\n\n```bash\ncurl --request POST \\\n--url https://testapi.direcfunds.com/v1/Disbursement/00000000-0000-0000-0000-000000000001/\\$Send \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>' \\\n--header 'X-Idempotency-Key: <UUID-V4>'\n```\n\n#### Check Statuses\n\nUse `GET /Disbursement/{id}/Detailed` for the current aggregate plus every pay-in and pay-out leg,\nincluding each leg's `paymentRail`, `transferStatus`, and `verificationStatus`. Use\n`GET /Disbursement/{id}/Events` for the append-only transition history. The event response returns a\n`nextEventId`; persist it and send it as `afterEventId` on the next poll, even when `hasMore` is false.\nThis avoids rereading old transitions while still finding new ones on the next poll.\n\nCompact status reads are also available when a poller needs only one status value:\n\n- `GET /Disbursement/{id}/Status` returns the disbursement `status` string.\n- `GET /PayOut/{id}/Status` returns the pay out `transferStatus` string.\n- `GET /PayOut/Disbursement/{id}` returns all pay outs for one disbursement and is equivalent to\n  `GET /PayOut?disbursementId={id}`.\n\nThese routes read the same authoritative resources as the full representations; they do not maintain\nseparate status state. Both compact status reads return an `ETag` and support `If-None-Match`.\n\n##### Check disbursement\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/Disbursement/00000000-0000-0000-0000-000000000001 \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nThe response body includes the current aggregate status, e.g. `\"status\": \"Processing\"`.\n\n##### Check pay out\n\n```bash\ncurl --request GET \\\n--url https://testapi.direcfunds.com/v1/PayOut/00000000-0000-0000-0000-000000000001 \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <TOKEN>'\n```\n\nThe response body includes `\"transferStatus\": \"Completed\"`. For a mixed-rail disbursement, prefer\nthe Detailed and Events endpoints above so every leg can be correlated by its id and payment rail.\n\n#### Partner workflow endpoints\n\n- `GET /Integration` discovers the authenticated company, environment, granted permissions, feature\n  availability, effective idempotency/concurrency/paging/rate-limit policies, and useful API links.\n  New event-driven integrations require `features.webhooks: true`; do not begin lifecycle testing\n  until it is enabled. When `features.webhooks` is `false`, webhook administration endpoints return\n  `404 Webhook Capability Unavailable`; use payment-status polling and authoritative reads instead.\n- `GET /Onboarding/Readiness` reports whether company compliance, agreements, branches, source-account\n  verification/funding, users, and payment authority are ready. It is the setup go/no-go check; it does\n  not replace the per-disbursement `GET /Disbursement/{id}/Readiness` action check.\n- `GET` and `PUT /Branch/{branchId}/BankAccounts` read and replace a branch's complete source-account\n  assignment with ETag concurrency protection. `POST /BankAccount/{id}/$Verify` starts or reuses the\n  company-scoped verification workflow and reports bank-reported ACH and wire capabilities. Those\n  metadata fields do not override the funding directions advertised by the capability endpoints.\n- `GET /PaymentRails` is the authoritative Test capability list, including supported directions,\n  amount ceilings, finality, expected settlement speed, and required fields.\n- `GET /DisbursementRequests/Capabilities` reports request-bundle limits, supported funding and pay-out\n  rails, validation support, scheduling, saved-recipient support, and partial-failure recovery.\n- `GET /DisbursementRequests/Summary` returns operational totals and recipient status counts for a\n  required half-open UTC range: `from` is inclusive, `to` is exclusive, and the range may span at\n  most 366 days.\n- `GET /DisbursementRequests/Search` lists requests filtered by `from`, `to`, and `status`, with\n  `limit`/`cursor` pagination. Use it for operational lookups instead of paging the whole collection.\n- `GET /DisbursementRequests/Events?after={checkpoint}` is the company-wide bundle event feed across\n  every request, the same ordered ledger the per-request `/{id}/Events` exposes for one request.\n  Like the per-request feed it is for controlled catch-up after an identified gap, not a continuous\n  polling service — signed webhooks are the lifecycle driver.\n- `POST /DisbursementRequests/{id}/RecipientPayments/{paymentReference}/$Cancel` cancels one recipient\n  payment only while the request is still an editable draft: before approval and dispatch, with the\n  payment unsent and at least one other payment remaining. The funding amount shrinks to the remaining\n  payments. To drop the last payment, cancel the whole request instead. After the draft stage it\n  returns `409` for every payment, including failed or rejected ones; contact DirecFunds support with the\n  request and recipient references. A `Pending` status alone does not prove the bank has not received\n  an instruction, so do not reissue a payment until its outcome and any collected funding have been\n  reconciled. Call it only when the payment's `allowedNextActions` includes `Cancel`. Reserved\n  `$Retry` and `$ReplaceDestination` endpoints remain\n  capability-disabled and return `409`; per-attempt provider idempotency and terminal-outcome proof\n  are not yet sufficient to make a resend safe.\n- `POST /DisbursementRequests/{id}/$SubmitForApproval`, `$Reject`, `$CancelSchedule`, and request-level\n  `$Cancel` control staged approval, reviewed rejection, scheduled holds, and whole-request cancellation.\n- `POST /Disbursement/$CreateWithLegs` remains available for advanced integrations that already manage\n  target accounts separately; its managed source-account pay-in legs accept `Wire` or authorized\n  `SamedayAch`. New\n  integrations should use `POST /DisbursementRequests` so target accounts and approval submission\n  participate in the same aggregate command.\n- `GET /Disbursement/{id}/Readiness` reports whether Request, Verify, and Send are eligible, with stable\n  blocker codes and the problem leg ids, without changing the disbursement.\n- `GET /Reconciliation/Transactions` provides a company-scoped, cursor-paged view across pay ins and\n  pay outs with external/provider references, rail, status timestamps, and settlement timestamps.\n- `GET /DisbursementRequests/Capabilities`, `/Summary`, `/{id}/Events`, and\n  `/{id}/Reconciliation` expose the bundle capability, operations, event, and closing-level\n  reconciliation views. Webhook subscriptions are managed under\n  `/DisbursementRequests/WebhookSubscriptions`.\n\n#### Signed webhook subscriptions\n\nWebhook subscriptions currently cover only bundled resources created through\n`POST /DisbursementRequests`. Granular `Disbursement`, `PayIn`, `PayOut`, and `$CreateWithLegs`\nresources do not produce subscription events. Confirm this scope from\n`GET /DisbursementRequests/Capabilities` → `supportedWebhookResourceTypes`; expanding webhook\ncoverage to granular resources is a separate capability.\n\nWhen `GET /Integration` returns `features.webhooks: true`, manage subscriptions with\n`POST` and `GET /DisbursementRequests/WebhookSubscriptions`, plus `PUT` and `DELETE\n/DisbursementRequests/WebhookSubscriptions/{subscriptionId}`. Create requires only a\npublic HTTPS `callbackUrl` (no credentials, no fragment, and it must resolve to a public internet\naddress). `signingSecret` is optional: **omit it and DirecFunds generates one and returns it in that\ncreate response only**, or supply your own of 32 to 512 characters. Either way the secret is never\nreturned by a later read, except that an exact keyed retry of the create replays the original\none-time secret. Rotate it in place with `PUT`.\n\nWhen `features.webhooks` is `false`, the same administration routes return `404 Webhook Capability\nUnavailable` and should not be used for certification.\n\n`eventTypes` accepts one to 25 values, each 64 characters or fewer. New integrations should send\n`[\"*\"]` so lifecycle additions do not require a subscription update; `\"*\"` must be sent by itself and\ncannot be combined with named types. Named types must come from the subscribable catalog:\n`disbursementrequest.updated`, `payin.completed`, `payin.failed`, `payin.rejected`, `payin.canceled`,\n`payout.completed`, `payout.failed`, `payout.rejected`, and `payout.canceled`. `webhook.ping` is\ndelivered by `$Test` but is not subscribable. An invalid callback URL, secret, or event filter returns\n`400`.\n\nSend a fresh UUID v4 `X-Idempotency-Key` for subscription creation, `$Test`, and `$Redeliver`, and\nreuse the same key and request for an uncertain-result retry. The retry returns the original outcome\nwithout repeating the side effect.\n\nDelivery is at least once. `X-DirecFunds-Signature` is `t=<unixSeconds>,v1=<signature>`: split it on\n`,`, take the timestamp from the `t=` element, compute lowercase hex HMAC-SHA256 with the signing\nsecret over `{timestamp}.{rawRequestBody}`, and compare it in constant time with the `v1=`\nvalue. Reject stale timestamps and de-duplicate using\n`X-DirecFunds-Event-Id`. Each Events feed record's `eventId` equals the `X-DirecFunds-Event-Id` of the webhook delivery for the same change, so a catch-up record can be reconciled directly with a delivery. The record's numeric `id` is the feed cursor, not the webhook `sequence`. Use `X-DirecFunds-Subscription-Id` to select the signing secret and rotate it\nin place with `PUT`. The thin body contains `eventId`, `type`, `occurredAt`, monotonic `sequence`,\n`resource` (`type`, `id`, and `status` when the event contains an authoritative status for that\nresource), and `links.self`. Treat the notification as a wake-up hint:\ncoalesce by `resource.id`, discard a sequence older than one already handled, then GET `links.self`\nand the request reconciliation view for authoritative state.\nInspect attempts with `GET /DisbursementRequests/WebhookSubscriptions/{subscriptionId}/Deliveries`\nand redrive a dead-lettered attempt with `POST .../Deliveries/{deliveryId}/$Redeliver`. The delivery\nhistory returns the same GUID `eventId` as the webhook plus its numeric `sequence`. Use the Events\nendpoint only for controlled catch-up or investigation, not as a continuous polling service. Before\nprocessing live events, call `POST /DisbursementRequests/WebhookSubscriptions/{subscriptionId}/$Test`\nto send a signed `webhook.ping` through the production transport and confirm connectivity without\nstoring the receiver's response body or adding a delivery-history row.\n\nEvery non-success HTTP response, including `400` and `410`, consumes the same ten-attempt retry budget with exponential backoff (and a bounded `Retry-After` when supplied). A single endpoint response never disables a subscription. After the tenth failed attempt the delivery becomes `DeadLettered`; inspect it and use `$Redeliver` after correcting the receiver. A delayed older delivery does not block newer notifications for the same subscription, so always use `sequence` to discard stale state.\n\n# Reference\n\n## Payment Rails\n\nA pay in draws money **into** the disbursement from your source account; a pay out sends money **out** to a recipient. The two directions support different rails:\n\n| Rail | Pay In | Pay Out | Notes |\n| ---- | :----: | :-----: | ----- |\n| `Wire` | ✅ | ✅ | Pay ins use a pre-authorized reverse wire (drawdown). Same-day when submitted before the wire cutoff. Select the rail explicitly. |\n| `Ach` | — | ✅ | Standard ACH payout (typically 1–2 business days). Standard ACH managed funding is not supported. |\n| `SamedayAch` | ✅ | ✅ | Same Day ACH debit funding requires a verified ACH-capable source account and `achDebitAuthorizationAccepted: true`; pay ins and pay outs are subject to amount, cutoff, business-day, and bank-acceptance rules. |\n| `InstantPayment` | — | ✅ | Real-time payments (RTP). Account-addressed and irrevocable; a recipient address and a memo are required. |\n| `Zelle` | — | Check availability | Pay-out only when enabled. Currently disabled in production. |\n| `FedNow` | — | ✅ | Pay-out only. Instant and irrevocable; a recipient address and a memo are required. |\n| `Other` | — | — | **Read-only.** A record whose internal rail is not part of the partner contract reads back as `Other`; it can never be supplied on a create. |\n\n### Zelle destination\n\nZelle is a pay-out-only rail with a $5,000 per-payment maximum when enabled. It is currently disabled in production. A new alias-addressed recipient payment\nuses `paymentRail: \"Zelle\"` and does not include bank-account fields:\n\n```json\n{\n  \"paymentReference\": \"seller-proceeds-002\",\n  \"paymentRail\": \"Zelle\",\n  \"amount\": 250.00,\n  \"transactionPurpose\": \"SellerProceeds\",\n  \"destination\": {\n    \"type\": \"Zelle\",\n    \"email\": \"recipient@example.test\"\n  },\n  \"recipient\": {\n    \"name\": \"Test Recipient\",\n    \"recipientType\": \"Person\",\n    \"email\": \"recipient@example.test\"\n  },\n  \"transactionDetails\": {}\n}\n```\n\nThe alias destination must contain an email address, a 10-digit phone number, or both. Do not add\n`bankAccount` or `savedRecipientId` to that destination. To pay an existing saved recipient by Zelle,\nuse `type: \"SavedRecipient\"` with only `savedRecipientId`. Every request must identify exactly one\ndestination kind.\n\nA managed source-account pay in supplied with any rail other than `Wire` or `SamedayAch` is rejected\nwith `400`; `SamedayAch` also requires `achDebitAuthorizationAccepted: true`.\nRead `GET /PaymentRails` at integration startup instead of hard-coding this table; the endpoint is the\nruntime contract for environment availability, direction, limits, and required fields. The current production configuration enables every supported rail except Zelle.\n\n## Transaction Purpose\n\nEvery pay out carries a `transactionPurpose`. The accepted values are:\n\n`LoanPayoff`, `SellerProceeds`, `RealtorCommission`, `FundsToClose`, `EarnestMoney`, `ClosingRelatedFees`, `Retainer`, `TitleAgencyCommission`, `Other`.\n\nUse `Other` when none of the specific values describes the payment. When `transactionPurpose` is `Other`, `otherPurpose` is required and must describe the payment in 256 characters or fewer. For a specific purpose, `otherPurpose` remains an optional note.\n\n`recipientType` is `Person` or `Business`. Do not send a `dateOfBirth` for a `Business` recipient.\n\n## Disbursement & Transfer Status Reference\n\nThere are two status families, and they are **not** interchangeable. A bundled\n`POST /DisbursementRequests` integration branches on the request and recipient-payment statuses; the\nadvanced granular-assembly flow branches on the disbursement, transfer, and verification statuses.\nA request-level `Rejected` (an approver's decision) and a leg-level `Rejected` (a rail outcome) are\ndifferent facts that happen to share a word.\n\nCurrent granular status is available on each resource, through the compact\n`GET /Disbursement/{id}/Status` and `GET /PayOut/{id}/Status` aliases, and in\n`GET /Disbursement/{id}/Detailed`. Poll `GET /Disbursement/{id}/Events?afterEventId={checkpoint}` for\nordered transitions across the aggregate and every rail leg; for bundles, poll\n`GET /DisbursementRequests/{id}/Events?after={checkpoint}`. Every lifecycle status field is a\nread-only, extensible string. The OpenAPI `x-extensible-enum` values are the currently documented\nvalues, not a closed set.\n\n`paymentRail` on a Pay Out is the requested rail. The optional read-only\n`actualPaymentNetwork` on `GET /PayOut/{id}` is the bank-confirmed network when known; an instant\npayment requested as FedNow can be reported by the bank as `TCH_RTP`. Do not infer delivery or\nnetwork from the requested rail alone. Check the authoritative transfer status and bank evidence.\n\nPreserve an unknown value verbatim, take no money-moving or recovery action based on it, refresh the\nauthoritative request and reconciliation state, retain sanitized telemetry, and route it for operational\nreview. Do not coerce an unknown value to success, failure, or `Canceled`.\n\n### Disbursement request `status`\n\nThe bundle status returned by `POST /DisbursementRequests`, `GET /DisbursementRequests/{id}`, the\nbundled actions, `Search`, and `Summary`. This is the vocabulary to branch on for a\n`POST /DisbursementRequests` integration; the granular tables below apply to the advanced\nresource-assembly flow.\n\n| Wire value | Meaning | Terminal? |\n| ---------- | ------- | :-------: |\n| `Initialized` | Staged with `approvalContext.submitForApproval: false`; call `$SubmitForApproval`. | No |\n| `PendingApproval` | Awaiting an approver. Call `$VerifyAndSend` to approve, or `$Reject`. | No |\n| `Scheduled` | Verified and held for `scheduledFor`; DirecFunds automatically releases it at or after the due time without a second partner call. | No |\n| `Processing` | Released; funding and recipient legs are executing. Includes the internal `PendingInfo` funding wait. | No |\n| `Completed` | Every recipient payment settled. | **Yes** |\n| `PartiallyCompleted` | The request finished with a mix of settled and unsuccessful recipient payments. Read each payment's own status before any recovery; the request as a whole will not progress further on its own. | **Yes** |\n| `NeedsAttention` | Execution stalled and the request needs operational review. Do not infer success or failure — refresh authoritative state and reconciliation. | No |\n| `Rejected` | An approver recorded a reviewed rejection via `$Reject`; no money moved. | **Yes** |\n| `Canceled` | Abandoned via request-level `$Cancel` before dispatch. | **Yes** |\n\n### Recipient payment `status`\n\nThe per-recipient status inside a bundled request and on\n`GET /DisbursementRequests/{id}/RecipientPayments/{paymentReference}`.\n\n| Wire value | Meaning | Terminal? |\n| ---------- | ------- | :-------: |\n| `Pending` | Accepted into the request; not yet dispatched. Eligible for `$Cancel`. | No |\n| `Submitted` | Handed to the payment rail. | No |\n| `Processing` | In flight. | No |\n| `PendingAccountActivation` | Waiting on the source account to finish activation. | No |\n| `Completed` | Settled. | **Yes** |\n| `Failed` | The payment failed. | **Yes** |\n| `Rejected` | The payment was rejected by the rail or provider. Distinct from request-level `Rejected`. | **Yes** |\n| `Canceled` | Canceled before dispatch. Never authorizes an automatic resend. | **Yes** |\n| `NeedsAttention` | The payment needs operational review; no automatic recovery is safe. | No |\n\nA terminal unsuccessful recipient payment does **not** authorize a new attempt from your side.\n`$Retry` and `$ReplaceDestination` remain capability-disabled and return `409`; see the recovery notes\nin Rate Limits, Throttling & Retries.\n\n### Disbursement `status`\n\nGranular resource-assembly flow (`POST /Disbursement`, `$CreateWithLegs`).\n\n| Wire value | Meaning | Terminal? |\n| ---------- | ------- | :-------: |\n| `Initialized` | Created; not yet submitted for approval. Add pay ins/pay outs, then call `$Request`. | No |\n| `Pending` | Submitted for approval — the \"pending approval\" state shown in the walkthrough. Call `$Verify`. | No |\n| `Verified` | Verified and ready to send. Call `$Send`. | No |\n| `RequiresInconclusiveOverride` | Verification is held for review. An account-verification override is available only for an eligible rail and outcome after sanctions screening is independently clear. | No |\n| `PendingInfo` | Awaiting additional information (e.g. a compliance follow-up). | No |\n| `Routing` | Accepted for processing and being routed to the payment rails. | No |\n| `Processing` | Funds are moving. | No |\n| `Completed` | All legs settled. | **Yes** |\n| `Rejected` | Rejected during approval/verification; no money moved. | **Yes** |\n| `Failed` | Processing failed; inspect the individual pay outs. | **Yes** |\n| `Canceled` | Terminal non-success: canceled within the allowed boundary before dispatch; no leg remains eligible to move. | **Yes** |\n\n### Pay Out `transferStatus`\n\n| Wire value | Meaning | Terminal? |\n| ---------- | ------- | :-------: |\n| `Processing` | Accepted and in flight. | No |\n| `Submitted` | Handed to the payment rail. | No |\n| `Inconclusive` | The rail returned an inconclusive result (e.g. account verification could not be completed). | No |\n| `PendingAccountActivation` | Waiting on the source account to finish activation. | No |\n| `Completed` | Settled. | **Yes** |\n| `Failed` | The transfer failed. | **Yes** |\n| `Rejected` | The transfer was rejected. | **Yes** |\n| `Canceled` | Terminal cancellation for that transfer. Do not resend or retry automatically. | **Yes** |\n\n`Canceled` never authorizes an automatic resend or retry. Display the cancellation reason, timestamp,\nand actor when they are available, and require a separately returned allowed action before offering\nany follow-up.\n\n### Pay Out `verificationStatus`\n\nThe account-verification (AVS) result for the pay out leg: `Unverified`, `Verified`, `Inconclusive`, `Failed`, `NotRequired`, or `ManuallyVerified` (an administrator recorded out-of-band verification evidence). Treat any unlisted value as not verified.\n\n### Pay In progress\n\nA pay in's current progress is available in `GET /Disbursement/{id}/Detailed`; its transfer and\nverification transitions are also returned by `GET /Disbursement/{id}/Events`. The read-only\n`completedAt` timestamp on `GET /PayIn/{id}` remains `null` until the pay-in leg has funded.\n\n## Error & Refusal Reference\n\nErrors are RFC 7807 Problem Details served as `application/problem+json`, except the money-movement `422` refusal contract described below, which keeps its `{ \"errorCode\": ..., \"message\": ... }` shape. The `traceId` inside a Problem Details body always equals the response's `X-Trace-Id` header — one id identifies the call for Support. Read the HTTP status first, then the machine-readable discriminator described below.\n\nFor a `400`, inspect `validationFailures[].errorMessages` on a preflight refusal. An automatic payload or model-binding refusal can instead use the standard `errors` map keyed by field path and have only a generic `title`; use the field path to correct the request.\n\nErrors also include additive `errorCode` and `resolution` guidance. Existing specific error codes,\nHTTP statuses, media types, field errors, and policy-refusal fields remain intact. Generic codes such\nas `INVALID_REQUEST`, `STATE_CONFLICT`, and `UPSTREAM_UNAVAILABLE` identify the error family; use\nthe existing specific problem `type` or policy `errorCode` for more precise handling.\n`resolution` contains `category`, `owner`, `retryMode`, and `nextAction`. Legacy money-movement\nrefusals also receive `traceId`; their `errorCode`, `message`, and cutoff metadata are preserved.\n\n| Retry mode | Required handling |\n| --- | --- |\n| `DoNotRetryUnchanged` | Correct the input, permissions, or policy blocker first. |\n| `SameIdempotencyKey` | The original operation is in flight. Wait, then repeat the identical body and key. |\n| `RefreshState` | Read authoritative state, ETag, and allowed actions before an intentional retry. |\n| `Reauthenticate` | Obtain a valid token for the intended environment. |\n| `RetryAfter` | Honor `Retry-After`; preserve the original body and key on supported writes. |\n| `CheckStatus` | A write may have succeeded. Recover authoritative state before retrying; never change the key to work around uncertainty. Safe reads may use backoff. |\n\nOlder responses can omit guidance. Treat an unknown retry mode as requiring review, never as\npermission to repeat money movement. The guidance does not replace idempotency, approval, or the\ncurrent resource's `allowedNextActions`.\n\nOnly the recognized DirecFunds problem type or specific error code and matching status identify an\nin-flight operation. A similarly named type on another host, a generic conflict, or a server error\ndoes not authorize automatic replay. `BILLING_PAYMENT_METHOD_REQUIRED` directs the company\nadministrator to repair billing unless its `detail` says to try again later; `REVIEW_CONFIRMATION_REQUIRED` directs the approver to perform and\nconfirm the review. A `500` uses `SYSTEM_ERROR`; upstream `502` uses `UPSTREAM_UNAVAILABLE`.\n\n| Status | When | What to do |\n| ------ | ---- | ---------- |\n| `400` | Invalid payload or an unmet lifecycle precondition (including no eligible payment branch or an ambiguous omitted `branchId`), amounts don't match, `$Verify` before `$Request`, requester supplied as approver, an enforcement-required missing key, a duplicated or invalid `X-Idempotency-Key`, a malformed or non-filterable collection filter, or an invalid/expired pagination cursor. | Fix the request; do not retry unchanged. |\n| `401` | Missing, expired, or invalid bearer token. | Obtain a new token. |\n| `403` | The integration lacks the required scope, or permission automation is disabled. | Check scopes / enable the capability in the portal. |\n| `404` | The resource does not exist in your company. | Verify the id. |\n| `409` | A send action cannot continue, or the original request with this idempotency key is still being processed — see the `type` in the body (below). | Resolve the named condition, then retry. |\n| `412` | Stale `ETag` on a permission or branch-account replacement. | Re-`GET` the document and retry with the fresh ETag. |\n| `422` | A compliance or payment-policy refusal — see `errorCode` (below) — or an idempotency-key reuse conflict (a Problem Details body with `type` `IdempotencyConflict`). No money moved. | Branch on `errorCode`; for key reuse, branch on the Problem Details `type`. |\n| `428` | A required `If-Match` header was omitted from a branch-account replacement. | `GET` the assignment document, retain its ETag, and retry. |\n| `429` | The request exceeded the rate limit. | Wait the `Retry-After` seconds, then retry. |\n| `502` | An internal DirecFunds dependency failed or timed out; the body is a ProblemDetails \"upstream service error\". Internal error details are never relayed. | Retry with backoff; if it persists, send Support the `X-Trace-Id`. |\n| `5xx` (other) | Unexpected server error. | Retry with backoff; if it persists, send Support the `X-Trace-Id`. |\n\n### `409 Conflict` problem types (send and bundled request actions)\n\nThe Problem Details `type` names the blocking condition; nothing moved and the disbursement is unchanged.\n\n| `type` | Meaning |\n| ------ | ------- |\n| `UnverifiedPayOuts` | A pay out is no longer in a verified state; re-verify before sending. |\n| `PayInAwaitingConsumerFunding` | A pay in still awaits consumer funding and has not settled. |\n| `IdempotencyKeyInFlight` | Any keyed operation: the original request with this `X-Idempotency-Key` is still being processed. Retry unchanged after a short delay. |\n| `Preflight` | A bundled request action (`$SubmitForApproval`, `$VerifyAndSend`, `$Cancel`, `$CancelSchedule`, or recipient-payment `$Cancel`) is not allowed in the request's current state; `validationFailures` explains why. Refresh the request and act only on its `allowedNextActions`. |\n\n### `422` money-movement `errorCode` (`$Verify`, `$Send`, `$VerifyAndSend`)\n\nThe 422 body is `{ \"errorCode\": \"...\", \"message\": \"...\" }`. `errorCode` is stable and safe to branch on; `message` is human-readable and may change. Some refusals add context fields (e.g. a Same Day ACH cutoff includes the next available window) that you may read opportunistically but should not depend on.\n\nOne 422 is *not* an `errorCode` refusal: reusing an `X-Idempotency-Key` with a different request body returns a standard Problem Details body with `type` `IdempotencyConflict` (see the Idempotency section).\n\n| `errorCode` | Meaning |\n| ----------- | ------- |\n| `KYB_KYC_NOT_PASSED` | The company's KYB/KYC verification is not confirmed. |\n| `SAME_DAY_ACH_AFTER_CUTOFF` | Submitted after the Same Day ACH window. |\n| `SAME_DAY_ACH_AMOUNT_LIMIT` | Above the per-transaction Same Day ACH limit. |\n| `SAME_DAY_ACH_PROVIDER_CONFIGURATION` | Same Day ACH is not configured for the provider. |\n\n### `422` `BillingPaymentMethodRequired` (`$Verify`, `$VerifyAndSend`)\n\nWhen billing payment-method enforcement is enabled and the company's saved billing payment method cannot be charged (none saved, the card expired, the method was removed or blocked, or it is not a card or US bank account, such as a Stripe Link wallet), approval is refused before anything is verified or billed. The same refusal is returned when DirecFunds cannot confirm billing readiness at that moment; its `detail` then ends with \"Try again later; no new billable work was started.\" The body is a standard Problem Details with `type` `BillingPaymentMethodRequired`, `errorCode` `BILLING_PAYMENT_METHOD_REQUIRED`, and a `detail` that names the problem. If the `detail` says to try again later, retry later with a new `X-Idempotency-Key`. Otherwise ask the company to update its payment method on the Billing page of the DirecFunds portal, then repeat the call with a new `X-Idempotency-Key`; approval reads the billing status live, so the next attempt sees the change. Payments that were already approved are not affected.\n\n## Two-Party Approval Rules\n\nUnder the **Two Party Approval** strategy the requester and the approver must be **different users**. The requester is set when the disbursement is created (`requesterUserId`); the approver is named on `$Verify` (`approverUserId`) and cannot be set earlier. `$Verify` and `$VerifyAndSend` also accept a `reviewConfirmed` flag recording that the approver reviewed the amount, funding source, recipient, account, and delivery method. Omitting it defaults to `true` (the deliberate verify call naming an approver is the confirmation), so existing integrations are unaffected; explicitly sending `reviewConfirmed: false` is rejected with `400`. Supplying the requester as the approver is likewise rejected with `400`, and no money moves. Both users need the relevant permission on the branch and source account — the requester needs request permission, the approver needs approve permission.\n\nFor bundled requests, use the API-computed `approvalRequirements` returned by `$Validate` and by\nnormalized request/action reads. The same canonical evaluator is enforced when approving or\nrejecting, including Single Party requests whose amount or requester permissions still require a\nseparate approver. Refresh immediately before the decision because the normalized value reflects\ncurrent approval policy and permissions. Do not infer or persist a monetary threshold.\n\n## Rate Limits, Throttling & Retries\n\n- **Idempotent retries.** Disbursement-request, disbursement, pay-in, pay-out, and atomic `$CreateWithLegs` creation, the bundled `$SubmitForApproval`, `$VerifyAndSend`, `$Reject`, `$Cancel`, `$CancelSchedule`, and recipient-payment `$Cancel` actions, the `$Request`, `$Verify`, `$Send`, and `$VerifyAndSend` actions, bank-account `$Verify`, onboarding `$Provision`, branch bank-account and opt-in permission-automation `PUT`s, plus webhook subscription creation, `$Test`, and `$Redeliver` support an `X-Idempotency-Key` (UUID v4). Webhook create, `$Test`, and `$Redeliver` always require it; Production requires it on protected operations when configured enforcement is enabled; Test follows its own environment setting. Send it in both environments. Malformed or duplicated supplied keys always return `400` (titled `Invalid Idempotency Key`). Reusing the same key for the same supported operation replays the recorded outcome without repeating the side effect; a rejected request may have shorter, redacted diagnostics, so retain its first response. Reusing a key with a *different* body returns `422` (`IdempotencyConflict`); a duplicate arriving while the original is still processing returns `409` (`IdempotencyKeyInFlight`) — retry it unchanged after a short delay. Use a fresh key for each distinct operation.\n- **Recipient-payment recovery.** `$Cancel` supports the same keyed replay rules. `$Retry` and `$ReplaceDestination` remain fail-closed with `409`; do not interpret a provider failure as proof that a new payment attempt is safe.\n- **Rate-limit retries.** Every operation can return `429 Too Many Requests`. Wait the number of seconds in the required `Retry-After` response header before retrying; keep the original idempotency key and body when retrying an idempotent write.\n- **Held verification.** A provider throttle can produce an `Inconclusive` pay out. Check the authoritative disbursement and payout statuses before taking another action. An exact retry with the same `X-Idempotency-Key` replays the recorded outcome without a fresh provider inquiry. A distinct verification attempt is available only for an eligible transient technical outcome within the attempt limit and may incur another provider fee. Missing scores, ambiguous evidence, and substantive negative results are held for correction or review.\n- **Sanctions and overrides.** An account-verification override never clears sanctions screening. `Indeterminate`, `PotentialMatch`, `Blocked`, missing, and unknown sanctions decisions cannot be sent or overridden. A potential match requires independent Compliance review; an indeterminate result requires the underlying data or provider issue to be investigated before a fresh approval cycle. A documented administrator override may be available for an eligible account result only after sanctions is `Clear` or `ClearedByReview` and the destination has been independently confirmed.\n- **Backoff.** For an uncertain `502`/`5xx` response, repeat the exact request with the original idempotency key and body after backoff (start ~1s, cap ~30s) to retrieve its outcome. Do not use a new key merely to repeat a held verification, and do not retry a `400`, `404`, or `422` unchanged.\n- **Tokens.** Refresh the OAuth token before it expires (1 hour) rather than waiting for a `401`.\n\n## Go-Live Checklist\n\nBefore a company can send live money through your integration, confirm all of the following. Several are arranged with DirecFunds out-of-band and are not settable through the API:\n\n1. **Production credentials issued.** Do not reuse Test credentials, the Test token endpoint, or the Test scope in Production.\n2. **Company KYB/KYC passed.** Otherwise money-movement actions refuse with `422 KYB_KYC_NOT_PASSED`.\n   The company must also keep a chargeable card or US bank account on the Billing page of the DirecFunds\n   portal; where billing payment-method enforcement is enabled, approvals otherwise refuse with\n   `422 BILLING_PAYMENT_METHOD_REQUIRED`.\n3. **Source bank account assigned and verified.** Assign it to an active branch, then call\n   `POST /BankAccount/{id}/$Verify`; it must reach `Drawdown` for reverse-wire funding.\n4. **Funding authorization completed for each source account.** Reverse-wire pay ins require drawdown authorization and the provider repeat-code mapping. Same Day ACH debit pay ins require a verified ACH-capable account and `achDebitAuthorizationAccepted: true`; standard ACH funding is unsupported.\n5. **User permissions assigned.** Each requester has request permission and each approver has approve permission on the relevant branch and source account — set in the portal, or via the permission-automation endpoint if it is enabled for your integration.\n6. **Approval strategy confirmed** on the company (`GET /Company`) — e.g. Two Party Approval requires distinct requester and approver users.\n7. **Trace-id logging in place.** Capture the `X-Trace-Id` response header on every call so you can reconcile with the AuditLog and give Support an exact id.\n8. **Readiness is green.** `GET /Onboarding/Readiness` returns `disbursementsEnabled: true`; do not infer\n   readiness from successful resource creation alone.\n\n## Testing in the Sandbox\n\nDo all development against Test (`https://testapi.direcfunds.com/v1`). The Test environment moves no real money and is isolated from Production.\n\n- Exercise immediate, staged (`submitForApproval: false` then `$SubmitForApproval`), and scheduled lifecycles. Confirm that an approved Scheduled request is automatically released at or after `scheduledFor` without a second partner call, and test `$Reject`, `$CancelSchedule`, and request-level `$Cancel` as distinct outcomes. Drive progress from signed webhooks and authoritative request reads; use `GET /DisbursementRequests/{id}/Events?after={checkpoint}` only to rehearse controlled catch-up after an identified gap. Also test the advanced granular flow when your integration depends on it.\n- Call `GET /Sandbox/Scenarios`, then drive any pay-in or pay-out leg with `POST /Sandbox/PayIn/{id}/$Simulate` or `POST /Sandbox/PayOut/{id}/$Simulate` and a body such as `{ \"scenario\": \"Completed\" }`. These Test-only operations update normal status fields and event history without calling a bank, moving money, billing, or sending alerts; they return `404` outside Test.\n- Exercise the **refusal** paths too, not just the happy path — a robust integration handles `422` (`KYB_KYC_NOT_PASSED`, the Same Day ACH codes) and `409` (`UnverifiedPayOuts`, `PayInAwaitingConsumerFunding`) without moving money. DirecFunds provides test data and account values during onboarding that deterministically drive each verification and settlement outcome (Completed / Failed / Inconclusive); request these for your Test company rather than using live account numbers.\n- Idempotency: replay a write with the same `X-Idempotency-Key` and confirm you get the original result; replay with a changed body and confirm `422`.\n\n## Trace ID & Support Correlation\n\nEvery response carries an `X-Trace-Id` header — a single id that also appears as `traceId` inside Problem Details error bodies, in the AuditLog, and (for compatibility) as `X-Request-Id`. Log it on every call. Authenticated requests are recorded in the integration audit trail. Unauthenticated 401/429 responses contribute counters rather than stored per-request audit records; anonymous route noise and the public `/Redirect` surface are excluded. When you contact Support about a specific request, quote its `X-Trace-Id`; when your integration has `Audit.Read`, `GET /AuditLog/{traceId}` returns that call's metadata (method, path, status, duration) without exposing any payment payload.\n\n\n## Recorded payment delivery timing\n\n`GET /DisbursementRequests/{id}/DeliveryAssessment?requiredBy=2026-10-15T17:00:00Z`\nreturns a read-only company-scoped assessment. Use an explicit UTC offset. It never schedules,\napproves, or sends a payment. `earliestReleaseAt` is a recorded lower bound, not an arrival\nestimate. `Unconfirmed` is not an on-time promise; funding holds still apply to fast payouts.\nAn older backend without this projection returns 503.\n\nReconciliation fields distinguish payment lifecycle evidence from independently matched records:\n`reconciliationScope=PaymentLifecycle`, `bankStatementMatching=NotAssessed`, and\n`customerAccountingMatching=NotAssessed`. The existing `state=Reconciled` vocabulary is retained\nfor compatibility; it does not establish bank-statement or customer-accounting matching.\n",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://testapi.direcfunds.com/v1",
      "description": "Test Environment"
    },
    {
      "url": "https://api.direcfunds.com/v1",
      "description": "Production Environment"
    }
  ],
  "paths": {
    "/Address": {
      "get": {
        "tags": [
          "Address"
        ],
        "summary": "Get Addresses",
        "description": "Gets addresses owned by the authenticated company. Addresses belonging to another company are never returned.",
        "operationId": "Address_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Address"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Address"
        ],
        "summary": "Create Address",
        "description": "Creates an address owned by the authenticated company.",
        "operationId": "Address_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Address"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Address"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Address"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Address/{id}": {
      "get": {
        "tags": [
          "Address"
        ],
        "summary": "Get Address By Id",
        "description": "Gets an address owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "Address_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Address"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Address"
        ],
        "summary": "Update Address",
        "description": "Updates an address owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "Address_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Address"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Address"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Address"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Address"
        ],
        "summary": "Delete Address",
        "description": "Deletes an address owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "Address_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/AuditLog": {
      "get": {
        "tags": [
          "Audit Log"
        ],
        "summary": "Get Audit Log",
        "description": "Returns the calling integration's audit log - the metadata of every request it has made to the Experience API (correlation id, timestamp, HTTP method, route template, resulting status code, and server-side latency), newest first. Scoped to the caller's company. Optionally bound the results with the inclusive UTC 'from' and 'to' timestamps; 'limit' caps how many entries are returned (default 100, maximum 500). Request/response bodies and raw query strings are not retained. Every authenticated request is recorded, including rejected ones (403/429); the only exclusions are requests with no validated identity - unauthenticated requests to routes that do not exist (scanner noise) and unauthenticated 401/429 rejections, neither of which could be attributed to your integration - and the public /Redirect short-link surface.",
        "operationId": "AuditLog_GetAll",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time",
              "default": null
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time",
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": null
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuditLogEntryPublicDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/AuditLog/{traceId}": {
      "get": {
        "tags": [
          "Audit Log"
        ],
        "summary": "Get Audit Log Entry By Trace Id",
        "description": "Returns a single audit log entry by its correlation (trace) id, scoped to the caller's company. An unknown id - including a trace id that belongs to another company - returns 404 with a ProblemDetails body.",
        "operationId": "AuditLog_GetByTraceId",
        "parameters": [
          {
            "name": "traceId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditLogEntryPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/BankAccount": {
      "get": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Get Bank Accounts",
        "description": "Gets the authenticated company's bank accounts. accountNumber and routingNumber are masked to their last four characters; use Readiness for the go/no-go funding decision.",
        "operationId": "BankAccount_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccounts"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Create Bank Account",
        "description": "Creates a bank account. addressId must identify an address owned by the authenticated company; a foreign or unknown address returns 404.",
        "operationId": "BankAccount_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BankAccount"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/BankAccount"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/BankAccount/{id}": {
      "get": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Get Bank Account By Id",
        "description": "Gets one bank account owned by the authenticated company. accountNumber and routingNumber are masked to their last four characters; use /BankAccount/{id}/Readiness for the go/no-go funding decision.",
        "operationId": "BankAccount_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Update Bank Account",
        "description": "Updates a bank account owned by the authenticated company. addressId must identify an address owned by that company; a foreign or unknown resource returns 404.",
        "operationId": "BankAccount_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BankAccount"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/BankAccount"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Delete Bank Account",
        "description": "Deletes a bank account",
        "operationId": "BankAccount_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/BankAccount/{id}/$Verify": {
      "post": {
        "tags": [
          "Bank Account"
        ],
        "summary": "Verify Source Bank Account",
        "description": "Starts company-scoped verification for the source account and reports its verification status plus bank-reported ACH and wire capabilities. A verified ACH-capable account can fund by Same Day ACH debit; reverse wire additionally requires drawdown readiness. Standard ACH funding is not supported. An exact idempotent retry replays the original result instead of starting or billing another verification.",
        "operationId": "BankAccount_Verify",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccountVerificationPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/BankAccount/{id}/Readiness": {
      "get": {
        "tags": [
          "Onboarding"
        ],
        "summary": "Get Bank Account Funding Readiness",
        "description": "Reports a single trust account's funding readiness: verification status, branch assignment, Same Day ACH debit and reverse-wire readiness, the active users authorized to fund from it, and finding codes for whatever still blocks it. Standard ACH funding is not supported. Display names are masked; full account numbers are never returned.",
        "operationId": "BankAccountReadiness_GetReadiness",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BankAccountReadinessPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Branch/{branchId}/BankAccounts": {
      "get": {
        "tags": [
          "Branch Bank Accounts"
        ],
        "summary": "Get Branch Bank Account Assignments",
        "description": "Returns the branch's complete company-scoped source-account assignment document and its ETag. Use that ETag as If-Match when replacing the assignment.",
        "operationId": "BranchBankAccount_Get",
        "parameters": [
          {
            "name": "branchId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BranchBankAccountDocumentPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Branch Bank Accounts"
        ],
        "summary": "Replace Branch Bank Account Assignments",
        "description": "Replaces the branch's complete source-account assignment. Send the current ETag as If-Match so a stale client cannot overwrite a newer change; foreign or unknown company resources return 404.",
        "operationId": "BranchBankAccount_Replace",
        "parameters": [
          {
            "name": "branchId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplaceBranchBankAccountsPublicRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ReplaceBranchBankAccountsPublicRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BranchBankAccountDocumentPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Branch": {
      "get": {
        "tags": [
          "Branch"
        ],
        "summary": "Get Branches",
        "description": "Gets all branches",
        "operationId": "Branch_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Branches"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Branch"
        ],
        "summary": "Create Branch",
        "description": "Creates a branch. addressId and optional phoneNumberId must identify resources owned by the authenticated company; a foreign or unknown reference returns 404.",
        "operationId": "Branch_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Branch"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Branch/{id}": {
      "get": {
        "tags": [
          "Branch"
        ],
        "summary": "Get Branch By Id",
        "description": "Gets a branch",
        "operationId": "Branch_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Branch"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Branch"
        ],
        "summary": "Update Branch",
        "description": "Updates a branch owned by the authenticated company. addressId and optional phoneNumberId must belong to that company; a foreign or unknown resource returns 404.",
        "operationId": "Branch_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Branch"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Branch"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Branch"
        ],
        "summary": "Delete Branch",
        "description": "Deletes a branch",
        "operationId": "Branch_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Company": {
      "get": {
        "tags": [
          "Company"
        ],
        "summary": "Get Company Information",
        "description": "Gets company information",
        "operationId": "Company_GetAll",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Company"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Get Disbursements",
        "description": "Gets all disbursements",
        "operationId": "Disbursement_GetAll",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only disbursements with this public status name."
          },
          {
            "name": "externalReference",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only disbursements with this exact partner-supplied external reference."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Disbursements"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Create Disbursement",
        "description": "Creates a disbursement",
        "operationId": "Disbursement_Post",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Disbursement"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Disbursement"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Disbursement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Get Disbursement By Id",
        "description": "Gets a disbursement",
        "operationId": "Disbursement_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Disbursement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Update Disbursement",
        "description": "Updates a disbursement",
        "operationId": "Disbursement_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Disbursement"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Disbursement"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Disbursement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Delete Disbursement",
        "description": "Deletes a disbursement",
        "operationId": "Disbursement_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/Status": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Get Disbursement Status",
        "description": "Returns only the current read-only disbursement status. This is a compact alias for reading the status field from GET /Disbursement/{id}; an unknown id returns 404.",
        "operationId": "Disbursement_GetStatus",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "string",
                  "description": "Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
                  "x-extensible-enum": [
                    "Pending",
                    "Routing",
                    "RequiresInconclusiveOverride",
                    "Verified",
                    "Rejected",
                    "Processing",
                    "Completed",
                    "Failed",
                    "PendingInfo",
                    "Initialized",
                    "Canceled"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/Detailed": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Get Disbursement With Rail Statuses",
        "description": "Gets a disbursement together with the per-rail status of each of its pay in and pay out legs. Unlike GET /Disbursement/{id}, which returns only the aggregate disbursement status, each leg here carries its own paymentRail, transferStatus and verificationStatus so you can see where every rail stands within the disbursement. An unknown id (or one owned by another company) returns 404.",
        "operationId": "Disbursement_GetDetailedById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailedDisbursementPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/Events": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Get Disbursement Payment Status History",
        "description": "Gets the ordered, append-only status transition history for the disbursement and each pay-in/pay-out leg on every payment rail. Use nextEventId as afterEventId to continue polling without rereading earlier events. This endpoint remains the polling source of truth and webhook-recovery path.",
        "operationId": "Disbursement_GetPaymentStatusEvents",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "afterEventId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentStatusEventPagePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/Readiness": {
      "get": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Check Disbursement Readiness",
        "description": "Checks the disbursement without changing it and reports whether Request, Verify, and Send are currently eligible, including routing-infrastructure readiness, stable blocker codes, amount balance, problem leg ids, and the recommended next action.",
        "operationId": "Disbursement_GetReadiness",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementReadinessPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/$CreateWithLegs": {
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Create a Complete Disbursement Atomically",
        "description": "Creates the disbursement header and all pay-in/pay-out legs in one database transaction. Managed source-account pay-in legs support Wire (reverse wire) and SamedayAch debit with achDebitAuthorizationAccepted=true; standard Ach funding is unsupported. All supported payout rails remain available. If any leg or preflight fails, none of the resources are committed. The response is the detailed aggregate with server-assigned ids and per-rail statuses.",
        "operationId": "Disbursement_CreateWithLegs",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDisbursementWithLegsPublicRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDisbursementWithLegsPublicRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailedDisbursementPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/$Request": {
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Request a Disbursement",
        "description": "Submits an Initialized disbursement for approval, moving it from Initialized to Pending Approval so it can be verified and sent. The disbursement must currently be in Initialized status and its requester must hold request permission on the branch (granted in the DirecFunds portal). Returns 400 with a ProblemDetails body if these preconditions are not met. Retrying with the same X-Idempotency-Key replays the original outcome instead of re-arming the approval workflow.",
        "operationId": "Disbursement_Request",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/$Verify": {
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Verify Disbursement",
        "description": "Verifies a disbursement and its pay outs, designating the approver named in the request body. All of the following preconditions must hold or the call returns 400 with a ProblemDetails body and no money moves: the disbursement is in Pending Approval status (call $Request first); the approver holds approval permission on the branch (granted in the DirecFunds portal); when two-party approval is required, the approver is not the requester; the disbursement has at least one pay in and at least one pay out; and the total pay in amount equals the total pay out amount. The optional reviewConfirmed flag defaults to true when omitted; explicitly sending reviewConfirmed=false is refused with 400 and nothing is verified. If the company's KYB/KYC verification has not passed, the call returns 422 with a machine-readable errorCode of KYB_KYC_NOT_PASSED and nothing is verified. When billing payment-method enforcement is enabled and the company has no chargeable card or US bank account on file for DirecFunds billing, or billing readiness cannot be confirmed, the call returns 422 with a ProblemDetails body (errorCode BILLING_PAYMENT_METHOD_REQUIRED) and nothing is verified. An unknown disbursement id returns 404.",
        "operationId": "Disbursement_Verify",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/$Send": {
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Send a Disbursement",
        "description": "Sends a verified disbursement for processing. The disbursement must be in Verified status (call $Verify first), must still have at least one pay in and at least one pay out, and its pay in and pay out totals must still match; otherwise the call returns 400 with a ProblemDetails body. Two further refusals leave the disbursement unchanged with no money moved: 409 with a ProblemDetails body when a pay out is no longer Verified (problem type UnverifiedPayOuts) or a pay in still awaits consumer funding (problem type PayInAwaitingConsumerFunding); and 422 with a machine-readable errorCode for a compliance or Same Day ACH policy refusal (KYB_KYC_NOT_PASSED, SAME_DAY_ACH_AFTER_CUTOFF, SAME_DAY_ACH_AMOUNT_LIMIT, SAME_DAY_ACH_PROVIDER_CONFIGURATION). An unknown disbursement id returns 404.",
        "operationId": "Disbursement_Send",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Disbursement/{id}/$VerifyAndSend": {
      "post": {
        "tags": [
          "Disbursement"
        ],
        "summary": "Verifies and Sends a Disbursement",
        "description": "Verifies a disbursement and its pay outs and, if verification succeeds, sends it for processing in a single call (the equivalent of $Verify followed by $Send). The same preconditions as $Verify apply: the disbursement is in Pending Approval status (call $Request first); the approver holds approval permission on the branch (granted in the DirecFunds portal); when two-party approval is required, the approver is not the requester; there is at least one pay in and at least one pay out; and the pay in and pay out totals match. The optional reviewConfirmed flag defaults to true when omitted; explicitly sending reviewConfirmed=false is refused with 400 and no money moves. If any precondition fails the call returns 400 with a ProblemDetails body and no money moves. Because it also sends, it can return the same refusals as $Send with nothing moved: 409 with a ProblemDetails body (UnverifiedPayOuts, PayInAwaitingConsumerFunding) and 422 with a machine-readable errorCode (KYB_KYC_NOT_PASSED, SAME_DAY_ACH_AFTER_CUTOFF, SAME_DAY_ACH_AMOUNT_LIMIT, SAME_DAY_ACH_PROVIDER_CONFIGURATION). When billing payment-method enforcement is enabled and the company has no chargeable card or US bank account on file for DirecFunds billing, or billing readiness cannot be confirmed, it returns 422 with a ProblemDetails body (errorCode BILLING_PAYMENT_METHOD_REQUIRED) before anything is verified. An unknown disbursement id returns 404.",
        "operationId": "Disbursement_VerifyAndSend",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/$Validate": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Validate a disbursement request without creating it",
        "description": "Validates the complete funding and recipient-payment graph without persisting it. valid reports draft validity, not permission to verify or send. The optional preflight assessment separately reports recipient identity-input blockers, approval requirements, and checks that remain unperformed or unassessed, with field/payment references, resolution owners, and next actions. No paid identity verification is performed and no arrival or funding-availability guarantee is made. A syntactically valid request returns 200 even when valid is false; malformed input, authentication failures, and unsupported payment-policy choices use the documented Problem Details responses.",
        "operationId": "DisbursementRequests_Validate",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestPublicCommand"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestValidationPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestValidationPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestValidationPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Create a disbursement request",
        "description": "Creates one independent disbursement request containing 1 to 100 recipient payments. DirecFunds has no orderId and no multi-request bulk operation: map each Order disbursement to its own call and use a company-unique clientReference (1 to 128 characters, starting with a letter or number). One Order may create multiple requests over time, but an existing request cannot be appended to. The disbursement, funding leg, recipient accounts, and payments in this request commit atomically; separate calls do not roll back together. Managed source-account funding supports Wire (reverse wire) and SamedayAch debit; SamedayAch requires achDebitAuthorizationAccepted=true, while standard Ach funding is unsupported. All supported payout rails remain available. The customer chooses every rail and DirecFunds never substitutes one. submitForApproval=false stages the request in Initialized. A future scheduledFor is approved once and automatically released for routing by DirecFunds at or after the due time.",
        "operationId": "DisbursementRequests_Post",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Find a disbursement request by client reference",
        "description": "Returns the company-scoped bundled request with the exact clientReference. An unknown reference returns 404.",
        "operationId": "DisbursementRequests_GetByClientReference",
        "parameters": [
          {
            "name": "clientReference",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Get a disbursement request",
        "description": "Returns the authenticated company's normalized request bundle, including its lifecycle status, funding instruction, recipient payments, approval requirements, and currently allowed actions. An unknown or foreign request returns 404.",
        "operationId": "DisbursementRequests_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/Search": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Find disbursement requests by date range and status",
        "description": "Lists your company's bundled requests inside the half-open UTC range [from, to), newest first. Supply both from and to; an omitted value fails range validation with 400. This is the endpoint for 'which closings are in flight?', 'which needed attention yesterday?', and for recovering a request id you no longer hold - GET /DisbursementRequests only resolves an exact clientReference you already know. The range may span at most 366 days; status is optional, limit defaults to 25 (maximum 100), and cursor is opaque. Rows are summaries; follow each self link for the full bundle. IMPORTANT: a short or empty page does NOT mean there are no more results - only a null nextCursor does. Keep following nextCursor until it comes back null.",
        "operationId": "DisbursementRequests_Search",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestPagePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/Events": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Read the company-wide event ledger from a watermark",
        "description": "Returns every bundled-request event for your company in id order, oldest first, from the `after` watermark. Use this to catch up after your webhook receiver has been unavailable: persist the last id you accepted, then replay forward from it - you do not need to know which requests changed. Ids are monotonic and stable, so the same watermark always resumes in the same place. Each event's eventId equals the X-DirecFunds-Event-Id header of the webhook delivery for the same change, so the deduplication key you already store applies unchanged. Page with limit (default 100, maximum 250) and keep following nextCursor until it is null.",
        "operationId": "DisbursementRequests_GetCompanyEvents",
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestEventPagePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/RecipientPayments/{paymentReference}": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Read one recipient payment",
        "description": "Returns a single recipient payment with its status, provider reference, failure detail, attempt history and allowed next actions. Use this to poll one payment instead of re-reading the whole request, which returns every sibling payment and its attempt history. An unknown request or paymentReference returns 404.",
        "operationId": "DisbursementRequests_GetRecipientPayment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "paymentReference",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
              "type": "string"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestRecipientPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/Events": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Get the append-only event history",
        "description": "Returns ordered bundle and recipient-payment events after the supplied cursor. Use nextCursor as the next after value; an unknown bundled request returns 404.",
        "operationId": "DisbursementRequests_GetEvents",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestEventPagePublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestEventPagePublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestEventPagePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/Reconciliation": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Get closing-level reconciliation totals and exceptions",
        "description": "Returns calculated, completed, outstanding, and failed totals plus payment-level exceptions for one bundled request. An unknown bundled request returns 404.",
        "operationId": "DisbursementRequests_GetReconciliation",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestReconciliationPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestReconciliationPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestReconciliationPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/Capabilities": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Get current bundle rail and feature capabilities",
        "description": "Returns the company-scoped funding and payout rails, limits, and optional bundled-request features that are currently available. Read this operation instead of hard-coding rail availability.",
        "operationId": "DisbursementRequests_GetCapabilities",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestCapabilitiesPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestCapabilitiesPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestCapabilitiesPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/Summary": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Get a bundle operational summary",
        "description": "Returns company-scoped bundled-request and recipient-payment totals for the half-open UTC range [from, to), where from is inclusive and to is exclusive. Supply both parameters; an omitted value, a reversed range, or a range longer than 366 days returns 400.",
        "operationId": "DisbursementRequests_GetSummary",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestOperationalSummaryPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestOperationalSummaryPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestOperationalSummaryPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/RecipientPayments/{paymentReference}/$Retry": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Reserved recipient retry action",
        "description": "Reserved for a future provider-safe recovery workflow. This action is not currently available and always returns 409. Consult GET /DisbursementRequests/Capabilities and allowedNextActions; neither advertises Retry while recovery is disabled.",
        "operationId": "DisbursementRequests_RetryPayment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "paymentReference",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
              "type": "string"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/RecipientPayments/{paymentReference}/$ReplaceDestination": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Reserved destination replacement action",
        "description": "Reserved for a future provider-safe recovery workflow. This action is not currently available and always returns 409. Consult GET /DisbursementRequests/Capabilities and allowedNextActions; neither advertises ReplaceDestination while recovery is disabled.",
        "operationId": "DisbursementRequests_ReplacePayment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "paymentReference",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
              "type": "string"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentReplacementPublicCommand"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentReplacementPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentReplacementPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/RecipientPayments/{paymentReference}/$Cancel": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Cancel only one eligible recipient payment",
        "description": "Cancels one recipient payment without canceling its siblings, only while the request is still an editable draft: before approval and dispatch, with the payment unsent and at least one other payment remaining. The funding amount shrinks to match. To drop the last payment, cancel the whole request. After the draft stage every payment returns 409; contact DirecFunds support, and do not reissue the payment until its outcome and funding are reconciled. Call it only when the payment's allowedNextActions includes Cancel. Supply a UUID v4 X-Idempotency-Key; unknown payments return 404, invalid lifecycle state returns 409, and idempotency misuse returns 422.",
        "operationId": "DisbursementRequests_CancelPayment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "paymentReference",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
              "type": "string"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/$VerifyAndSend": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Verify and send a disbursement request",
        "description": "Approves one bundled request and begins only the execution currently eligible. approverUserId is required and must identify an authorized approver who satisfies the request's current approval policy and permissions. reviewConfirmed records review of the amount, funding source, recipients, destination accounts, and delivery methods; omission is interpreted as true only for backward compatibility, while an explicit false is refused with 400 and no money moves. For an immediate request, the action verifies the independent payment batch and begins eligible processing. For a future scheduledFor, this call verifies and holds it in Scheduled; DirecFunds automatically releases it for eligible processing at or after scheduledFor, so no second partner call is required. A 202 response acknowledges the action, not routing, provider submission, payment, or settlement. Inspect response.request: it may be Scheduled, Processing (including an internal PendingInfo wait), or NeedsAttention. When billing payment-method enforcement is enabled, a company with no chargeable card or US bank account on file for DirecFunds billing, or whose billing readiness cannot be confirmed, is refused with 422 and a ProblemDetails body (errorCode BILLING_PAYMENT_METHOD_REQUIRED) before anything is verified. Invalid states, approval failures, and dispatch races return 409 without duplicating money movement.",
        "operationId": "DisbursementRequests_VerifyAndSend",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TwoPartyVerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Action accepted. Inspect response.request: its status may be Scheduled, Processing (including an internal PendingInfo wait), or NeedsAttention. This response does not prove routing, provider submission, payment, or settlement.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. The body is malformed, approverUserId is missing, reviewConfirmed is false, or the idempotency key is invalid or required but absent.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized. The bearer token is missing, expired, or invalid.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden. The authenticated integration lacks permission to send disbursements.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. The request does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The request is ineligible, an approval/preflight or dispatch race failed, or the same idempotency key is still in flight. Refresh state; an in-flight retry must keep the same key and body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. application/problem+json is an idempotency conflict; application/json is either Problem Details or a money-movement policy refusal with errorCode and message. No money moved.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ProblemDetailsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/MoneyMovementRefusalResponse"
                    }
                  ]
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. Unexpected failures use a sanitized Problem Details body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "502": {
            "description": "Bad Gateway. A downstream failure or timeout is sanitized to an upstream-service Problem Details body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests. Wait for the required Retry-After delay, then retry this same call with the same idempotency key and unchanged body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/$Cancel": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Cancel an entire disbursement request before dispatch",
        "description": "Cancels the whole request and every leg, including the funding leg, and moves it to terminal Canceled. actorUserId must be the original requester with current branch request permission, or a user with branch approval permission. This is allowed only before dispatch; once any leg is in flight, settled, or has an inconclusive provider outcome, the compare-and-swap guard returns 409 and payment-level recovery applies. No money moves. An already-canceled retry succeeds unchanged. Supply a UUID v4 X-Idempotency-Key.",
        "operationId": "DisbursementRequests_CancelRequest",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/$Reject": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Reject a bundled disbursement request after review",
        "description": "Records an authorized approver's rejection while every funding and recipient leg remains Pending. This is distinct from cancellation: reviewConfirmed must be true, the trimmed reason must contain 10 to 512 characters, and the request becomes Rejected with an append-only decision event. Supply a UUID v4 X-Idempotency-Key; exact uncertain-result retries replay the original normalized response.",
        "operationId": "DisbursementRequests_RejectRequest",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestDecisionPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementRequestDecisionPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/$CancelSchedule": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Cancel a scheduled dispatch",
        "description": "Calls off a scheduled dispatch, clears scheduledFor, and returns the request to PendingApproval. actorUserId must be the original requester with current branch request permission, or a user with branch approval permission. Only an undispatched Scheduled request is eligible; a concurrent due-time release wins atomically and makes this return 409. To abandon the request entirely use $Cancel. Supply a UUID v4 X-Idempotency-Key.",
        "operationId": "DisbursementRequests_CancelSchedule",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementPaymentRecoveryPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/$SubmitForApproval": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Submit an initialized disbursement request for approval",
        "description": "Moves an independent payment batch created with approvalContext.submitForApproval=false from Initialized to PendingApproval and notifies approvers, after which $VerifyAndSend becomes available. Initialized requests and PendingApproval retry re-entry are accepted; any later status returns 409.",
        "operationId": "DisbursementRequests_SubmitForApproval",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementRequestActionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/WebhookSubscriptions": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Create a signed bundle-event webhook subscription",
        "description": "Creates an HTTPS webhook subscription for bundled-request lifecycle events. Use eventTypes [\"*\"] for the webhook-first integration. Omit signingSecret to receive a generated secret in this response only, or supply 32 to 512 characters. Invalid callback URLs, secrets, or event filters return 400. Supply a UUID v4 X-Idempotency-Key. Retrying the same request with the same key returns the original subscription and one-time signing secret without creating a duplicate.",
        "operationId": "DisbursementRequests_CreateWebhookSubscription",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Required UUID v4. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicCommand"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        },
        "callbacks": {
          "partnerEvent": {
            "{$request.body#/callbackUrl}": {
              "post": {
                "summary": "Receive a signed DirecFunds payment event",
                "description": "DirecFunds sends this request at least once. Verify the HMAC over the raw body before parsing, reject stale timestamps, deduplicate eventId, and return any 2xx response only after the event has been durably accepted.",
                "parameters": [
                  {
                    "name": "X-DirecFunds-Signature",
                    "in": "header",
                    "description": "t=<unix-seconds>,v1=<lowercase-hex HMAC-SHA256 over {timestamp}.{rawBody}>",
                    "required": true,
                    "schema": {
                      "type": "string"
                    }
                  },
                  {
                    "name": "X-DirecFunds-Timestamp",
                    "in": "header",
                    "description": "Unix timestamp used in the signature and replay-window validation.",
                    "required": true,
                    "schema": {
                      "pattern": "^[0-9]{10,}$",
                      "type": "string"
                    }
                  },
                  {
                    "name": "X-DirecFunds-Event-Id",
                    "in": "header",
                    "description": "GUID matching eventId in the body.",
                    "required": true,
                    "schema": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  {
                    "name": "X-DirecFunds-Subscription-Id",
                    "in": "header",
                    "description": "GUID identifying the subscription.",
                    "required": true,
                    "schema": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                ],
                "requestBody": {
                  "description": "Thin event notification; re-read links.self for authoritative state.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/PartnerWebhookEventPayload"
                      }
                    }
                  },
                  "required": true
                },
                "responses": {
                  "2XX": {
                    "description": "Event durably accepted. Non-2xx responses are retried or dead-lettered."
                  }
                },
                "security": [
                  {}
                ]
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "List bundle-event webhook subscriptions",
        "description": "Lists active and disabled bundled-request webhook subscriptions for the authenticated company. Signing secrets are never returned.",
        "operationId": "DisbursementRequests_GetWebhookSubscriptions",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/WebhookSubscriptions/{subscriptionId}/$Test": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Send a signed diagnostic event to a webhook subscription",
        "description": "Immediately sends a webhook.ping event through the same SSRF-protected HTTP client, HMAC signature, and DirecFunds headers used for production deliveries. The result reports only connectivity and the HTTP status; it does not expose the response body or create a delivery-history record. Supply a UUID v4 X-Idempotency-Key; an exact retry returns the original diagnostic result without sending another ping.",
        "operationId": "DisbursementRequests_TestWebhookSubscription",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Required UUID v4. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookTestResultPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/WebhookSubscriptions/{subscriptionId}": {
      "put": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Update a webhook subscription, including rotating its signing secret",
        "description": "Updates a subscription in place. Every field is optional and an omitted field is left unchanged - in particular, OMITTING signingSecret keeps the current secret, so changing only the callback URL cannot accidentally invalidate every signature. Supplying signingSecret rotates immediately: deliveries sent after this response are signed with the new secret, and each delivery carries X-DirecFunds-Subscription-Id so your receiver can select the right key. This replaces the older create-second-subscription then delete-old dance, which duplicated every event for the length of the overlap. A disabled subscription cannot be updated (400); create a new one instead. An unknown subscription returns 404.",
        "operationId": "DisbursementRequests_UpdateWebhookSubscription",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementWebhookSubscriptionUpdatePublicCommand"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DisbursementWebhookSubscriptionUpdatePublicCommand"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookSubscriptionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Disable a bundle-event webhook subscription",
        "description": "Disables a company-scoped webhook subscription. The operation is irreversible through the API; create a new subscription to resume delivery. An unknown subscription returns 404.",
        "operationId": "DisbursementRequests_DisableWebhookSubscription",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/WebhookSubscriptions/{subscriptionId}/Deliveries": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "List delivery attempts for a webhook subscription",
        "description": "Returns the delivery history for one of your subscriptions, newest first, with the status, attempt count, next scheduled attempt and last error for each. Delivery is at-least-once with ten attempts and exponential backoff capped at one hour; after the final failure a delivery becomes DeadLettered and DirecFunds stops retrying it. Filter with status=DeadLettered to find everything awaiting recovery, then use $Redeliver on each. Page with limit (default 50, maximum 200) and cursor, passing the nextCursor from the previous page. An unknown subscription returns 404.",
        "operationId": "DisbursementRequests_GetWebhookDeliveries",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": null
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookDeliveryPagePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/WebhookSubscriptions/{subscriptionId}/Deliveries/{deliveryId}/$Redeliver": {
      "post": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Redeliver a dead-lettered webhook delivery",
        "description": "Queues a dead-lettered delivery for another attempt with a fresh retry budget. This is the self-service recovery path when your receiver was unavailable long enough for DirecFunds to exhaust its automatic retries. Only a DeadLettered delivery can be redelivered: a Pending or Processing one is already queued and redriving it would race the delivery worker, and a Delivered one has already been accepted - both return 409. The redelivered event carries the same X-DirecFunds-Event-Id, so a receiver that did commit it must treat the repeat as a duplicate and return 2xx. Supply a UUID v4 X-Idempotency-Key; an exact retry returns the original accepted delivery without queuing it twice.",
        "operationId": "DisbursementRequests_RedeliverWebhookDelivery",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "deliveryId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Required UUID v4. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisbursementWebhookDeliveryPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found. Signed disbursement webhooks are not enabled for this integration, or the requested webhook resource does not exist in the authenticated company.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Integration": {
      "get": {
        "tags": [
          "Integration"
        ],
        "summary": "Get Current Integration Profile",
        "description": "Returns the authenticated integration's company context, effective permissions, environment, feature availability, and discovery links. It never returns credentials or secrets.",
        "operationId": "Integration_GetCurrent",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationProfilePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Onboarding/Readiness": {
      "get": {
        "tags": [
          "Onboarding"
        ],
        "summary": "Get Company Onboarding Readiness",
        "description": "Returns the authenticated company's compliance, agreement, branch, source-account, funding, user, and payment-authority readiness without exposing sensitive verification evidence or full bank-account numbers.",
        "operationId": "Onboarding_GetReadiness",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingReadinessPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Onboarding/Checklist": {
      "get": {
        "tags": [
          "Onboarding"
        ],
        "summary": "Get Company Onboarding Checklist",
        "description": "Returns the onboarding pipeline as ordered steps. Each step reports whether it is complete, whether the partner can act on it, the endpoint that completes it, and the readiness finding codes currently blocking it - suitable for rendering directly as a setup wizard.",
        "operationId": "Onboarding_GetChecklist",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingChecklistPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Onboarding/$Provision": {
      "post": {
        "tags": [
          "Onboarding"
        ],
        "summary": "Provision Onboarding Resources",
        "description": "Convergently provisions the partner-actionable onboarding steps in one call: branch (with address and phone number), trust account (with address), branch assignment, users, and payment authority. Existing resources are matched by natural key (branch by name, account by routing and account number, user by email) and reused; grants are merged, never revoked. The bundle is NOT transactional: each step reports its own outcome, dependents of a failed step report Skipped, and replaying the same request safely completes the remaining work. Set dryRun to preview the plan without writing. Bank verification is deliberately excluded - trigger the billable $Verify explicitly. The payment-authority step requires permission automation to be enabled for the integration.",
        "operationId": "Onboarding_Provision",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OnboardingProvisionPublicRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OnboardingProvisionPublicRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingProvisionPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PayIn": {
      "get": {
        "tags": [
          "Pay In"
        ],
        "summary": "Get PayIns",
        "description": "Gets all pay ins",
        "operationId": "PayIn_GetAll",
        "parameters": [
          {
            "name": "transferStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay ins with this public transfer status name."
          },
          {
            "name": "verificationStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay ins with this public verification status name."
          },
          {
            "name": "disbursementId",
            "in": "query",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid",
              "default": null
            },
            "description": "Return only pay ins belonging to this disbursement."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PayInPublicDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Pay In"
        ],
        "summary": "Create PayIn",
        "description": "Creates a managed source-account pay in using Wire (reverse wire) or SamedayAch with achDebitAuthorizationAccepted=true. Standard Ach is not supported for managed funding; Ach and SamedayAch remain available for pay outs.",
        "operationId": "PayIn_Post",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PayIn/{id}": {
      "get": {
        "tags": [
          "Pay In"
        ],
        "summary": "Get PayIn By Id",
        "description": "Gets a pay in by it's id",
        "operationId": "PayIn_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Pay In"
        ],
        "summary": "Update PayIn",
        "description": "Updates a pay in",
        "operationId": "PayIn_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PayInPublicDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayInPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Pay In"
        ],
        "summary": "Delete PayIn",
        "description": "Delete a pay in",
        "operationId": "PayIn_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PaymentRails": {
      "get": {
        "tags": [
          "Payment Rails"
        ],
        "summary": "Get Payment Rail Capabilities",
        "description": "Returns the partner contract for every payment rail: supported direction, Test availability, amount ceiling, expected settlement speed, finality, and rail-specific required fields.",
        "operationId": "PaymentRails_GetAll",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentRailCapabilityPublicDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/PayOut": {
      "get": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Get PayOuts",
        "description": "Gets all pay outs",
        "operationId": "PayOut_GetAll",
        "parameters": [
          {
            "name": "transferStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this public transfer status name."
          },
          {
            "name": "verificationStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this public verification status name."
          },
          {
            "name": "disbursementId",
            "in": "query",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid",
              "default": null
            },
            "description": "Return only pay outs belonging to this disbursement."
          },
          {
            "name": "externalReference",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this exact partner-supplied external reference."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayOuts"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Create PayOut",
        "description": "Adds a pay out the the specified disbursement",
        "operationId": "PayOut_Post",
        "parameters": [
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayOut"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PayOut"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayOut"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content. The idempotency key was already used with a different request body.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PayOut/{id}": {
      "get": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Get PayOut By Id",
        "description": "Gets a pay out",
        "operationId": "PayOut_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayOut"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Update PayOut",
        "description": "Updates a pay out",
        "operationId": "PayOut_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayOut"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PayOut"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayOut"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Direct PayOut deletion is blocked",
        "description": "Current services refuse direct deletion with HTTP 405 to preserve funding totals and audit history. Use the disbursement aggregate removal or cancellation operation.",
        "operationId": "PayOut_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "405": {
            "description": "Method Not Allowed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PayOut/Disbursement/{id}": {
      "get": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Get Pay Outs For Disbursement",
        "description": "Returns every pay out belonging to the specified disbursement. This convenience route is equivalent to GET /PayOut?disbursementId={id} and supports the same transferStatus, verificationStatus, and externalReference filters; the disbursement id in the route is authoritative and a disbursementId query parameter is ignored. No matches return an empty list.",
        "operationId": "PayOut_GetAllForDisbursement",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "transferStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this public transfer status name."
          },
          {
            "name": "verificationStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this public verification status name."
          },
          {
            "name": "disbursementId",
            "in": "query",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid",
              "default": null
            },
            "description": "Return only pay outs belonging to this disbursement."
          },
          {
            "name": "externalReference",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Return only pay outs with this exact partner-supplied external reference."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayOuts"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PayOut/{id}/Status": {
      "get": {
        "tags": [
          "Pay Out"
        ],
        "summary": "Get Pay Out Status",
        "description": "Returns only the current read-only transferStatus for a pay out. This is a compact alias for reading transferStatus from GET /PayOut/{id}; an unknown id returns 404.",
        "operationId": "PayOut_GetStatus",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferStatus2"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/PhoneNumber": {
      "get": {
        "tags": [
          "Phone Number"
        ],
        "summary": "Get Phone Numbers",
        "description": "Gets phone numbers owned by the authenticated company. Phone numbers belonging to another company are never returned.",
        "operationId": "PhoneNumber_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PhoneNumberPublicDto2"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Phone Number"
        ],
        "summary": "Create Phone Number",
        "description": "Creates a phone number owned by the authenticated company.",
        "operationId": "PhoneNumber_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PhoneNumberPublicDto2"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PhoneNumberPublicDto2"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneNumberPublicDto2"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/PhoneNumber/{id}": {
      "get": {
        "tags": [
          "Phone Number"
        ],
        "summary": "Get Phone Number By Id",
        "description": "Gets a phone number owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "PhoneNumber_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneNumberPublicDto2"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Phone Number"
        ],
        "summary": "Update Phone Number",
        "description": "Updates a phone number owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "PhoneNumber_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PhoneNumberPublicDto2"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PhoneNumberPublicDto2"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneNumberPublicDto2"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Phone Number"
        ],
        "summary": "Delete Phone Number",
        "description": "Deletes a phone number owned by the authenticated company. A foreign or unknown id returns 404.",
        "operationId": "PhoneNumber_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Reconciliation/Transactions": {
      "get": {
        "tags": [
          "Reconciliation"
        ],
        "summary": "Get Reconciliation Transactions",
        "description": "Returns a company-scoped reconciliation view across pay ins and pay outs, including rail, current status, provider reference, partner external reference, status update time, settlement time, and a stable cursor. Use nextCursor until hasMore is false.",
        "operationId": "Reconciliation_GetTransactions",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time",
              "default": null
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time",
              "default": null
            }
          },
          {
            "name": "paymentRail",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "transferStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null,
              "x-extensible-enum": [
                "Canceled",
                "Completed",
                "Failed",
                "Inconclusive",
                "PendingAccountActivation",
                "Processing",
                "Rejected",
                "Submitted"
              ]
            }
          },
          {
            "name": "externalReference",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReconciliationTransactionPagePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Sandbox/Scenarios": {
      "get": {
        "tags": [
          "Test Sandbox"
        ],
        "summary": "Get Deterministic Test Scenarios",
        "description": "Lists deterministic provider-free payment outcomes available in Test. Sandbox endpoints do not move money, call a payment provider, create billing, or send alerts.",
        "operationId": "Sandbox_GetScenarios",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SandboxScenarioPublicDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/Sandbox/$Prepare": {
      "post": {
        "tags": [
          "Test Sandbox"
        ],
        "summary": "Prepare the Partner Test Sandbox",
        "description": "Test only. Idempotently prepares the authenticated company's existing branch, user permissions, onboarding flags, and a dedicated synthetic source account for deterministic provider-free lifecycle testing. It reuses a company-owned address, never creates customer identity, and is unavailable in Production.",
        "operationId": "Sandbox_Prepare",
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxPreparationPublicDto"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Sandbox/PayIn/{id}/$Simulate": {
      "post": {
        "tags": [
          "Test Sandbox"
        ],
        "summary": "Simulate a Pay In Status",
        "description": "Test only. Applies a deterministic transfer outcome to one pay-in leg and returns the refreshed detailed disbursement. The transition is also visible in /Disbursement/{id}/Events.",
        "operationId": "Sandbox_SimulatePayIn",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SandboxSimulationPublicRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SandboxSimulationPublicRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailedDisbursementPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/Sandbox/PayOut/{id}/$Simulate": {
      "post": {
        "tags": [
          "Test Sandbox"
        ],
        "summary": "Simulate a Pay Out Status",
        "description": "Test only. Applies a deterministic transfer outcome to one pay-out leg on any supported rail and returns the refreshed detailed disbursement. The transition is also visible in /Disbursement/{id}/Events.",
        "operationId": "Sandbox_SimulatePayOut",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SandboxSimulationPublicRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SandboxSimulationPublicRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailedDisbursementPublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/SandboxSimulationErrorPublicDto"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/TargetAccount": {
      "get": {
        "tags": [
          "Target Account"
        ],
        "summary": "Get TargetAccounts",
        "description": "Gets the authenticated company's target accounts. Account and routing numbers are masked to their last four characters and cannot be used as collection filters.",
        "operationId": "TargetAccount_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TargetAccount"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TargetAccount"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TargetAccount"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Target Account"
        ],
        "summary": "Create Target Account",
        "description": "Creates a target account",
        "operationId": "TargetAccount_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/TargetAccount/{id}": {
      "get": {
        "tags": [
          "Target Account"
        ],
        "summary": "Get TargetAccount By Id",
        "description": "Gets a target account owned by the authenticated company. Account and routing numbers are masked to their last four characters.",
        "operationId": "TargetAccount_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Target Account"
        ],
        "summary": "Update Target Account",
        "description": "Updates a target account. When the account is the funding source copy of a pay in, its account number, routing number, beneficiary, account type, and SWIFT/BIC cannot change and return 400; update the managed bank account, then delete and recreate the pay in.",
        "operationId": "TargetAccount_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TargetAccount"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TargetAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Target Account"
        ],
        "summary": "Delete Target Account",
        "description": "Delete a target account",
        "operationId": "TargetAccount_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/User": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "Get Users",
        "description": "Gets all active users. Deactivated users are omitted.",
        "operationId": "User_GetAll",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 500,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": null
            },
            "description": "Maximum number of records to return. Supplying limit opts in to cursor pagination; the maximum is 500."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Opaque cursor returned in the X-Next-Cursor response header."
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string",
              "default": null
            },
            "description": "Optional legacy dynamic-filter JSON, limited to 64 KiB, 64 properties, 128 conditions, and 512 values in total. Account and routing numbers cannot be filtered. Prefer the resource-specific query parameters when available."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque cursor for the next page. Absent when there are no more records.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Page-Limit": {
                "description": "Page size applied to this response.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Users"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "User"
        ],
        "summary": "Create User",
        "description": "Creates an active, non-administrator user. Payment authority is managed separately.",
        "operationId": "User_Post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/User"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/User"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/User"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/User/{id}": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "Get User By Id",
        "description": "Gets an active user. A deactivated user returns 404 until reactivated.",
        "operationId": "User_GetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/User"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "User"
        ],
        "summary": "Update User",
        "description": "Updates a user. Set active=true to reactivate a previously deactivated user; use DELETE to deactivate.",
        "operationId": "User_Put",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/User"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/User"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/User"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "User"
        ],
        "summary": "Delete User",
        "description": "Deactivates a user. The user is then omitted from listings and returns 404 by id. Reactivate it with PUT active=true using the retained user id and required profile fields.",
        "operationId": "User_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {}
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/User/{userId}/Permissions": {
      "get": {
        "tags": [
          "User Permissions"
        ],
        "summary": "Get User Permissions",
        "description": "Returns the user's complete payment-authority document separately from the ordinary User profile, together with an ETag for concurrency-safe replacement. The capability must be enabled for the calling integration.",
        "operationId": "UserPermission_Get",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPermissionDocumentDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "User Permissions"
        ],
        "summary": "Replace User Permissions",
        "description": "Replaces the user's complete branch and bank-account permission document. Send the current ETag as If-Match and do not use ordinary User profile writes to change payment authority.",
        "operationId": "UserPermission_Replace",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "schema": {
              "maxLength": 512,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{64}\"(, ?(W/)?\"[0-9a-f]{64}\")*)$",
              "type": "string"
            }
          },
          {
            "name": "X-Idempotency-Key",
            "in": "header",
            "description": "Optional UUID v4 while idempotency enforcement is disabled (the legacy-integration default); required only when enforcement is explicitly enabled for the target environment. Retrying the same operation with the same key replays the original outcome. A malformed key always returns 400; a missing key returns 400 only when enforcement is enabled; reusing a key while the original request is still processing returns 409; reusing a key with a different request body returns 422. These rejections are Problem Details bodies.",
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplaceUserPermissionDocumentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ReplaceUserPermissionDocumentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPermissionDocumentDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict. The original request with this idempotency key is still being processed.",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/User/{userId}/Readiness": {
      "get": {
        "tags": [
          "Onboarding"
        ],
        "summary": "Get User Payment-Authority Readiness",
        "description": "Reports whether the user can request or approve disbursements end-to-end: branch memberships, per-branch requester/approver authority, granted trust accounts and which of them are funding-ready, plus finding codes for whichever grant is missing.",
        "operationId": "UserReadiness_GetReadiness",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserReadinessPublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          }
        }
      }
    },
    "/DisbursementRequests/{id}/DeliveryAssessment": {
      "get": {
        "tags": [
          "Disbursement Requests"
        ],
        "summary": "Assess recorded delivery timing against an optional deadline",
        "description": "Read-only, company-scoped assessment. requiredBy is an ISO 8601 instant with a UTC offset; it is not saved and does not schedule, approve, resend, or move funds. AtRisk reports a known obstacle, while Unconfirmed is not an on-time promise. earliestReleaseAt is a lower bound from recorded holds/scheduling, not an arrival estimate. Completed timestamps describe recorded recipient outcomes, not independent bank/accounting matching.",
        "operationId": "DisbursementRequests_GetDeliveryAssessment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "requiredBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "description": "Optional conditional GET: a quoted opaque entity tag, a list of tags (optionally weak), or a standalone *. Matching tags return 304; nonmatching tags return the representation. Malformed syntax returns 400. No application-specific 512-character limit applies; transport header limits still apply.",
            "schema": {
              "type": "string",
              "pattern": "^(?:[ \\t]*\\*[ \\t]*|[ \\t,]*(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"(?:[ \\t]*,[ \\t]*(?:(?:W/)?\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\")?)*[ \\t]*)(?![\\s\\S])"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "ETag": {
                "description": "Current representation tag for If-Match and If-None-Match requests.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentDeliveryAssessment"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentDeliveryAssessment"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentDeliveryAssessment"
                }
              }
            }
          },
          "304": {
            "description": "Not Modified",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the caller's current rate-limit window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window; zero on a throttled response.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the caller's current rate-limit window resets.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetailsResponse"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "headers": {
              "X-Request-Id": {
                "description": "Correlation identifier for support and audit-log lookup.",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PartnerWebhookEventPayload": {
        "required": [
          "eventId",
          "type",
          "occurredAt",
          "sequence",
          "resource",
          "links"
        ],
        "type": "object",
        "properties": {
          "eventId": {
            "type": "string",
            "description": "Unique event identifier; matches X-DirecFunds-Event-Id.",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "Case-sensitive emitted event slug.",
            "x-extensible-enum": [
              "disbursementrequest.updated",
              "payin.canceled",
              "payin.completed",
              "payin.failed",
              "payin.rejected",
              "payout.canceled",
              "payout.completed",
              "payout.failed",
              "payout.rejected",
              "webhook.ping"
            ]
          },
          "occurredAt": {
            "type": "string",
            "description": "UTC time of the underlying state transition.",
            "format": "date-time"
          },
          "sequence": {
            "minimum": 0,
            "type": "integer",
            "description": "Monotonic per-resource sequence used to reject stale delivery.",
            "format": "int64"
          },
          "resource": {
            "$ref": "#/components/schemas/PartnerWebhookResource"
          },
          "links": {
            "$ref": "#/components/schemas/PartnerWebhookLinks"
          }
        },
        "description": "Signed, at-least-once callback body. Treat it as a wake-up signal, deduplicate on eventId, reject stale sequence values, and re-read links.self."
      },
      "PartnerWebhookResource": {
        "required": [
          "type",
          "id"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Exact partner-facing resource types emitted today; preserve unknown future values.",
            "x-extensible-enum": [
              "Disbursement",
              "PayIn",
              "PayOut",
              "WebhookSubscription"
            ]
          },
          "id": {
            "type": "string",
            "description": "Resource identifier.",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "description": "Optional routing hint only; omitted when the journal event does not prove an aggregate status. Authoritative state comes from links.self.",
            "nullable": true
          }
        }
      },
      "PartnerWebhookLinks": {
        "required": [
          "self"
        ],
        "type": "object",
        "properties": {
          "self": {
            "type": "string",
            "description": "Relative Experience API resource path to re-read.",
            "format": "uri-reference"
          }
        }
      },
      "BankAccountDisbursementDestination": {
        "required": [
          "type",
          "bankAccount"
        ],
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "BankAccount"
            ],
            "type": "string"
          },
          "bankAccount": {
            "$ref": "#/components/schemas/TargetAccount"
          }
        },
        "additionalProperties": false
      },
      "SavedRecipientDisbursementDestination": {
        "required": [
          "type",
          "savedRecipientId"
        ],
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "SavedRecipient"
            ],
            "type": "string"
          },
          "savedRecipientId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "additionalProperties": false
      },
      "ZelleDisbursementDestination": {
        "required": [
          "type"
        ],
        "type": "object",
        "anyOf": [
          {
            "required": [
              "email"
            ]
          },
          {
            "required": [
              "phone"
            ]
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Zelle"
            ],
            "type": "string"
          },
          "email": {
            "maxLength": 128,
            "type": "string",
            "format": "email"
          },
          "phone": {
            "pattern": "^[0-9]{10}$",
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "Address": {
        "required": [
          "address1",
          "city",
          "state",
          "postalCode"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "address1": {
            "type": "string"
          },
          "address2": {
            "type": "string",
            "nullable": true
          },
          "address3": {
            "type": "string",
            "nullable": true
          },
          "address4": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Two character state code. OH, CA, NY, etc..."
          },
          "postalCode": {
            "type": "string",
            "description": "5 character postal code with support for 4 character extension in the format 12345 or 12345-1234"
          }
        }
      },
      "Address2": {
        "required": [
          "address1",
          "city",
          "state",
          "postalCode"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "address1": {
            "type": "string"
          },
          "address2": {
            "type": "string",
            "nullable": true
          },
          "address3": {
            "type": "string",
            "nullable": true
          },
          "address4": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Two character state code. OH, CA, NY, etc..."
          },
          "postalCode": {
            "type": "string",
            "description": "5 character postal code with support for 4 character extension in the format 12345 or 12345-1234"
          }
        },
        "description": "A new address to create when the branch must be created. Mutually exclusive with addressId.",
        "nullable": true
      },
      "Address3": {
        "required": [
          "address1",
          "city",
          "state",
          "postalCode"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "address1": {
            "type": "string"
          },
          "address2": {
            "type": "string",
            "nullable": true
          },
          "address3": {
            "type": "string",
            "nullable": true
          },
          "address4": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Two character state code. OH, CA, NY, etc..."
          },
          "postalCode": {
            "type": "string",
            "description": "5 character postal code with support for 4 character extension in the format 12345 or 12345-1234"
          }
        },
        "description": "A new address to create when the account must be created. Mutually exclusive with addressId.",
        "nullable": true
      },
      "AuditLogEntryPublicDto": {
        "type": "object",
        "properties": {
          "traceId": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "timestamp": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "readOnly": true
          },
          "method": {
            "type": "string",
            "description": "Readonly",
            "readOnly": true
          },
          "statusCode": {
            "type": "integer",
            "description": "Readonly",
            "format": "int32",
            "readOnly": true
          },
          "path": {
            "type": "string",
            "description": "Readonly",
            "readOnly": true
          },
          "query": {
            "type": "string",
            "description": "Readonly",
            "readOnly": true
          },
          "durationMs": {
            "type": "integer",
            "description": "Readonly",
            "format": "int64",
            "readOnly": true
          }
        }
      },
      "BankAccount": {
        "required": [
          "bankName",
          "beneficiary",
          "accountNumber",
          "routingNumber",
          "addressId"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "bankName": {
            "type": "string"
          },
          "nickName": {
            "type": "string",
            "description": "A friendly label for the account, e.g. \"Operating Escrow\". Optional.",
            "nullable": true
          },
          "beneficiary": {
            "type": "string",
            "description": "Name of on file with the account"
          },
          "accountNumber": {
            "type": "string",
            "description": "Write: full 1-17 digit account number. GET responses are masked as **** plus the last four digits."
          },
          "routingNumber": {
            "type": "string",
            "description": "Write: full 9 digit routing number. GET responses are masked as **** plus the last four digits."
          },
          "addressId": {
            "type": "string",
            "format": "uuid"
          },
          "depositAccountType": {
            "$ref": "#/components/schemas/NullableOfDepositAccountTypes"
          },
          "addressRef": {
            "type": "string",
            "format": "uri-reference",
            "nullable": true
          }
        }
      },
      "BankAccountReadinessPublicDto": {
        "type": "object",
        "properties": {
          "bankAccountId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "displayName": {
            "type": "string",
            "readOnly": true
          },
          "verificationStatus": {
            "type": "string",
            "readOnly": true
          },
          "supportsAch": {
            "type": "boolean",
            "description": "Bank-reported ACH capability metadata used to determine Same Day ACH debit readiness. Standard ACH funding is not supported.",
            "readOnly": true
          },
          "supportsWire": {
            "type": "boolean",
            "description": "Bank-reported wire capability metadata.",
            "readOnly": true
          },
          "achReady": {
            "type": "boolean",
            "description": "True when this verified, branch-assigned account can fund managed disbursements by Same Day ACH debit.",
            "readOnly": true
          },
          "wireReady": {
            "type": "boolean",
            "readOnly": true
          },
          "fundingReady": {
            "type": "boolean",
            "readOnly": true
          },
          "branchIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "authorizedUserIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingReadinessFindingPublicDto"
            },
            "readOnly": true
          }
        }
      },
      "BankAccounts": {
        "title": "bankAccounts",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/BankAccount"
        },
        "description": "Response"
      },
      "BankAccountVerificationPublicDto": {
        "type": "object",
        "properties": {
          "bankAccountId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "verificationStatus": {
            "type": "string",
            "readOnly": true
          },
          "supportsAch": {
            "type": "boolean",
            "description": "Bank-reported ACH capability metadata used to determine Same Day ACH debit readiness. Standard ACH funding is not supported.",
            "readOnly": true
          },
          "supportsWire": {
            "type": "boolean",
            "description": "Bank-reported wire capability metadata.",
            "readOnly": true
          },
          "wireDrawdownReady": {
            "type": "boolean",
            "description": "True when this account can fund managed disbursements through reverse wire.",
            "readOnly": true
          }
        }
      },
      "Branch": {
        "required": [
          "name",
          "addressId"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "name": {
            "type": "string"
          },
          "phoneNumberId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "addressId": {
            "type": "string",
            "format": "uuid"
          },
          "active": {
            "type": "boolean",
            "nullable": true
          },
          "addressRef": {
            "type": "string",
            "format": "uri-reference",
            "nullable": true
          },
          "phoneNumberRef": {
            "type": "string",
            "format": "uri-reference",
            "nullable": true
          }
        }
      },
      "BranchBankAccountDocumentPublicDto": {
        "type": "object",
        "properties": {
          "branchId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "bankAccountIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "etag": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "Branches": {
        "title": "branches",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Branch"
        },
        "description": "Response"
      },
      "Company": {
        "required": [
          "name",
          "approvalStrategy"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "approvalStrategy": {
            "minLength": 1,
            "type": "string"
          },
          "active": {
            "type": "boolean",
            "nullable": true
          }
        }
      },
      "CreateDisbursementWithLegsPublicRequest": {
        "required": [
          "disbursement",
          "payIns",
          "payOuts"
        ],
        "type": "object",
        "properties": {
          "disbursement": {
            "$ref": "#/components/schemas/Disbursement"
          },
          "payIns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreatePayInPublicDto"
            }
          },
          "payOuts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreatePayOutPublicDto"
            }
          }
        }
      },
      "CreatePayInPublicDto": {
        "required": [
          "sourceAccountReferenceId",
          "paymentRail",
          "amount"
        ],
        "type": "object",
        "properties": {
          "sourceAccountReferenceId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "achDebitAuthorizationAccepted": {
            "type": "boolean",
            "description": "Required and must be true for a Same Day ACH debit from a managed source account. Omit for reverse wire. Standard ACH funding is not supported.",
            "nullable": true
          }
        }
      },
      "CreatePayOutPublicDto": {
        "required": [
          "paymentRail",
          "amount",
          "transactionPurpose",
          "targetAccountId",
          "recipient"
        ],
        "type": "object",
        "properties": {
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "transactionPurpose": {
            "$ref": "#/components/schemas/TransactionPurpose"
          },
          "otherPurpose": {
            "type": "string",
            "nullable": true
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid"
          },
          "recipient": {
            "$ref": "#/components/schemas/Recipient"
          },
          "transactionDetails": {
            "$ref": "#/components/schemas/TransactionDetailsPublicDto"
          },
          "externalReference": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "DetailedDisbursementPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "branchId": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "requesterUserId": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "approverUserId": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "completedAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementStatus"
          },
          "externalReference": {
            "type": "string",
            "description": "Readonly",
            "nullable": true,
            "readOnly": true
          },
          "payIns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementLegStatusPublicDto"
            },
            "description": "Readonly",
            "readOnly": true
          },
          "payOuts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementLegStatusPublicDto"
            },
            "description": "Readonly",
            "readOnly": true
          },
          "draftVersion": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "Current request revision. Return this value as expectedDraftVersion when approving the reviewed request.",
            "format": "int64",
            "readOnly": true
          }
        }
      },
      "Disbursement": {
        "required": [
          "branchId",
          "requesterUserId"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "branchId": {
            "type": "string",
            "format": "uuid"
          },
          "requesterUserId": {
            "type": "string",
            "format": "uuid"
          },
          "approverUserId": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "completedAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementStatus"
          },
          "externalReference": {
            "type": "string",
            "description": "Optional partner-supplied reference (e.g. a closing file or order number). Stored and echoed back on reads, and filterable so records can be looked up by your own id.",
            "nullable": true
          },
          "draftVersion": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "Current request revision. Return this value as expectedDraftVersion when approving the reviewed request.",
            "format": "int64",
            "readOnly": true
          }
        }
      },
      "DisbursementActionReadinessPublicDto": {
        "type": "object",
        "properties": {
          "eligible": {
            "type": "boolean",
            "readOnly": true
          },
          "blockerCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          }
        },
        "readOnly": true
      },
      "DisbursementApprovalContextPublicDto": {
        "required": [
          "requesterUserId"
        ],
        "type": "object",
        "properties": {
          "requesterUserId": {
            "type": "string",
            "format": "uuid"
          },
          "intendedApproverUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "submitForApproval": {
            "type": "boolean",
            "description": "True (default) creates the request in PendingApproval. False stages it in Initialized until POST /DisbursementRequests/{id}/$SubmitForApproval is called."
          }
        }
      },
      "DisbursementApprovalRequirementsPublicDto": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "description": "Effective approval mode for this exact request: DistinctApprover or SelfApprovalAllowed."
          },
          "requiresDistinctApprover": {
            "type": "boolean",
            "description": "True when approval must come from an authorized user distinct from the requester."
          },
          "strategy": {
            "type": "string",
            "description": "The effective DirecFunds approval strategy for this exact request."
          },
          "requiresSeparateApprover": {
            "type": "boolean",
            "description": "True when this exact request must be approved by a user other than the requester."
          },
          "requesterCanSelfApprove": {
            "type": "boolean",
            "description": "True only when the requester may approve this exact request under the current authoritative policy."
          },
          "reasonCode": {
            "type": "string",
            "description": "Stable policy branch. Current values are TWO_PARTY_STRATEGY, AMOUNT_AT_OR_ABOVE_THRESHOLD, REQUESTER_LACKS_APPROVE_PERMISSION, and SINGLE_PARTY. The private monetary threshold is not exposed."
          }
        },
        "nullable": true
      },
      "DisbursementApprovalRequirementsPublicDto2": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "description": "Effective approval mode for this exact request: DistinctApprover or SelfApprovalAllowed."
          },
          "requiresDistinctApprover": {
            "type": "boolean",
            "description": "True when approval must come from an authorized user distinct from the requester."
          },
          "strategy": {
            "type": "string",
            "description": "The effective DirecFunds approval strategy for this exact request."
          },
          "requiresSeparateApprover": {
            "type": "boolean",
            "description": "True when this exact request must be approved by a user other than the requester."
          },
          "requesterCanSelfApprove": {
            "type": "boolean",
            "description": "True only when the requester may approve this exact request under the current authoritative policy."
          },
          "reasonCode": {
            "type": "string",
            "description": "Stable policy branch. Current values are TWO_PARTY_STRATEGY, AMOUNT_AT_OR_ABOVE_THRESHOLD, REQUESTER_LACKS_APPROVE_PERMISSION, and SINGLE_PARTY. The private monetary threshold is not exposed."
          }
        }
      },
      "DisbursementFundingInstructionPublicDto": {
        "required": [
          "sourceAccountReferenceId",
          "paymentRail"
        ],
        "type": "object",
        "properties": {
          "sourceAccountReferenceId": {
            "type": "string",
            "format": "uuid"
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "achDebitAuthorizationAccepted": {
            "type": "boolean",
            "description": "Required and must be true for a Same Day ACH debit from a managed source account. Omit for reverse wire. Standard ACH funding is not supported.",
            "nullable": true
          }
        }
      },
      "DisbursementLegStatusPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail"
          },
          "amount": {
            "type": "number",
            "description": "Readonly",
            "format": "double",
            "nullable": true,
            "readOnly": true
          },
          "transferStatus": {
            "$ref": "#/components/schemas/TransferStatus"
          },
          "verificationStatus": {
            "$ref": "#/components/schemas/VerificationStatus"
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "settledAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementNeedsAttentionPublicDto": {
        "type": "object",
        "properties": {
          "owner": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "reasonCode": {
            "type": "string"
          },
          "message": {
            "type": "string",
            "description": "Partner-safe explanation that does not contain provider payloads or bank details."
          },
          "resolutionPath": {
            "type": "string",
            "description": "Relative Experience API path to the authoritative reconciliation or event view."
          }
        },
        "nullable": true
      },
      "DisbursementPaymentAttemptPublicDto": {
        "type": "object",
        "properties": {
          "attemptNumber": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementRecipientPaymentPublicStatus2"
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "providerReference": {
            "type": "string",
            "nullable": true
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastUpdatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "failure": {
            "$ref": "#/components/schemas/DisbursementPaymentFailurePublicDto2"
          }
        }
      },
      "DisbursementPaymentDestinationPublicDto": {
        "required": [
          "type"
        ],
        "type": "object",
        "oneOf": [
          {
            "$ref": "#/components/schemas/BankAccountDisbursementDestination"
          },
          {
            "$ref": "#/components/schemas/SavedRecipientDisbursementDestination"
          },
          {
            "$ref": "#/components/schemas/ZelleDisbursementDestination"
          }
        ],
        "properties": {
          "type": {
            "$ref": "#/components/schemas/DisbursementPaymentDestinationType"
          },
          "bankAccount": {
            "$ref": "#/components/schemas/TargetAccount"
          },
          "savedRecipientId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          }
        },
        "description": "Exactly one typed destination. The discriminator value and supplied details must agree.",
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "BankAccount": "#/components/schemas/BankAccountDisbursementDestination",
            "SavedRecipient": "#/components/schemas/SavedRecipientDisbursementDestination",
            "Zelle": "#/components/schemas/ZelleDisbursementDestination"
          }
        }
      },
      "DisbursementPaymentDestinationType": {
        "enum": [
          "BankAccount",
          "SavedRecipient",
          "Zelle"
        ]
      },
      "DisbursementPaymentFailurePublicDto": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "description": "Stable, partner-safe failure category. Provider text and sensitive bank details are never exposed."
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "retryable": {
            "type": "boolean"
          },
          "owner": {
            "type": "string"
          },
          "resolutionPath": {
            "type": "string",
            "description": "Relative Experience API path to the authoritative reconciliation or event view."
          }
        },
        "description": "Readonly",
        "nullable": true,
        "readOnly": true
      },
      "DisbursementPaymentFailurePublicDto2": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "description": "Stable, partner-safe failure category. Provider text and sensitive bank details are never exposed."
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "retryable": {
            "type": "boolean"
          },
          "owner": {
            "type": "string"
          },
          "resolutionPath": {
            "type": "string",
            "description": "Relative Experience API path to the authoritative reconciliation or event view."
          }
        },
        "nullable": true
      },
      "DisbursementPaymentRecoveryPublicCommand": {
        "required": [
          "actorUserId"
        ],
        "type": "object",
        "properties": {
          "actorUserId": {
            "type": "string",
            "format": "uuid"
          },
          "reason": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "DisbursementPaymentReplacementPublicCommand": {
        "required": [
          "paymentRail",
          "destination",
          "actorUserId"
        ],
        "type": "object",
        "properties": {
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "destination": {
            "$ref": "#/components/schemas/DisbursementPaymentDestinationPublicDto"
          },
          "recipient": {
            "$ref": "#/components/schemas/Recipient2"
          },
          "actorUserId": {
            "type": "string",
            "format": "uuid"
          },
          "reason": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "DisbursementRailCapabilityPublicDto": {
        "type": "object",
        "properties": {
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "active": {
            "type": "boolean"
          },
          "destinationType": {
            "type": "string"
          },
          "requiresNetworkEligibility": {
            "type": "boolean"
          },
          "supportsRetry": {
            "type": "boolean"
          }
        }
      },
      "DisbursementReadinessFindingPublicDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "readOnly": true
          },
          "severity": {
            "type": "string",
            "readOnly": true
          },
          "message": {
            "type": "string",
            "readOnly": true
          },
          "resourceType": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "resourceId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementReadinessPublicDto": {
        "type": "object",
        "properties": {
          "disbursementId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "payInTotal": {
            "type": "number",
            "format": "decimal",
            "readOnly": true
          },
          "payOutTotal": {
            "type": "number",
            "format": "decimal",
            "readOnly": true
          },
          "balanced": {
            "type": "boolean",
            "readOnly": true
          },
          "request": {
            "$ref": "#/components/schemas/DisbursementActionReadinessPublicDto"
          },
          "verify": {
            "$ref": "#/components/schemas/DisbursementActionReadinessPublicDto"
          },
          "send": {
            "$ref": "#/components/schemas/DisbursementActionReadinessPublicDto"
          },
          "nextAction": {
            "type": "string",
            "readOnly": true
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementReadinessFindingPublicDto"
            },
            "readOnly": true
          },
          "routingInfrastructureReady": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "DisbursementRecipientInstructionPublicDto": {
        "required": [
          "paymentReference",
          "paymentRail",
          "amount",
          "destination",
          "transactionPurpose"
        ],
        "type": "object",
        "properties": {
          "paymentReference": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
            "type": "string"
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "destination": {
            "$ref": "#/components/schemas/DisbursementPaymentDestinationPublicDto"
          },
          "recipient": {
            "$ref": "#/components/schemas/Recipient2"
          },
          "transactionPurpose": {
            "$ref": "#/components/schemas/TransactionPurpose"
          },
          "otherPurpose": {
            "type": "string",
            "nullable": true
          },
          "transactionDetails": {
            "$ref": "#/components/schemas/TransactionDetailsPublicDto"
          }
        }
      },
      "DisbursementRecipientPaymentPublicStatus": {
        "type": "string",
        "description": "Readonly Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "readOnly": true,
        "x-extensible-enum": [
          "Pending",
          "Submitted",
          "Processing",
          "Completed",
          "Failed",
          "Rejected",
          "Canceled",
          "PendingAccountActivation",
          "NeedsAttention"
        ]
      },
      "DisbursementRecipientPaymentPublicStatus2": {
        "type": "string",
        "description": "Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "x-extensible-enum": [
          "Pending",
          "Submitted",
          "Processing",
          "Completed",
          "Failed",
          "Rejected",
          "Canceled",
          "PendingAccountActivation",
          "NeedsAttention"
        ]
      },
      "DisbursementReconciliationExceptionPublicDto": {
        "type": "object",
        "properties": {
          "paymentReference": {
            "type": "string"
          },
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementRecipientPaymentPublicStatus2"
          },
          "owner": {
            "type": "string"
          },
          "recommendedAction": {
            "type": "string"
          }
        }
      },
      "DisbursementRequestActionPublicDto": {
        "type": "object",
        "properties": {
          "accepted": {
            "type": "boolean",
            "description": "True when DirecFunds accepted the API action. It does not prove provider submission, payment, or settlement."
          },
          "message": {
            "type": "string"
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "request": {
            "$ref": "#/components/schemas/DisbursementRequestPublicDto"
          }
        }
      },
      "DisbursementRequestApprovalPublicDto": {
        "type": "object",
        "properties": {
          "requesterUserId": {
            "type": "string",
            "format": "uuid"
          },
          "intendedApproverUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        }
      },
      "DisbursementRequestCapabilitiesPublicDto": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "maximumRecipientPayments": {
            "type": "integer",
            "format": "int32"
          },
          "maximumScheduleDays": {
            "type": "integer",
            "format": "int32"
          },
          "fundingRails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRailCapabilityPublicDto"
            }
          },
          "payoutRails": {
            "type": "array",
            "items": {}
          },
          "supportsValidation": {
            "type": "boolean"
          },
          "supportsSavedRecipients": {
            "type": "boolean"
          },
          "supportsScheduling": {
            "type": "boolean"
          },
          "supportsAutomaticScheduledDispatch": {
            "type": "boolean"
          },
          "supportsPartialFailureRecovery": {
            "type": "boolean",
            "description": "Currently false. Retry and destination replacement are reserved until provider-safe recovery controls are enabled."
          },
          "billingReady": {
            "type": "boolean"
          },
          "billingUnavailableReason": {
            "type": "string",
            "nullable": true
          },
          "supportedWebhookEventTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Exact case-sensitive event slugs accepted by eventTypes. webhook.ping is diagnostic and is reported separately."
          },
          "supportedWebhookResourceTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Exact resource.type values emitted by subscribed production events."
          },
          "webhookTestEventType": {
            "type": "string"
          },
          "webhookTestResourceType": {
            "type": "string"
          }
        }
      },
      "DisbursementRequestDecisionPublicCommand": {
        "required": [
          "approverUserId",
          "reviewConfirmed",
          "reason"
        ],
        "type": "object",
        "properties": {
          "approverUserId": {
            "type": "string",
            "format": "uuid"
          },
          "reviewConfirmed": {
            "type": "boolean",
            "description": "Must be explicitly true to confirm that the approver reviewed this exact bundled request.",
            "default": false
          },
          "reason": {
            "maxLength": 512,
            "minLength": 10,
            "type": "string",
            "description": "A meaningful review reason. Leading and trailing whitespace is ignored."
          }
        }
      },
      "DisbursementRequestEventPagePublicDto": {
        "type": "object",
        "properties": {
          "disbursementRequestId": {
            "type": "string",
            "format": "uuid"
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestEventPublicDto"
            }
          },
          "nextCursor": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          },
          "webhookEnvelopeVersion": {
            "type": "string"
          }
        }
      },
      "VerificationInputField": {
        "enum": [
          "LegalName",
          "RecipientType",
          "Phone",
          "DateOfBirth",
          "Address",
          "BusinessEinOrPhoneAndAddress"
        ]
      },
      "DisbursementRequestEventPublicDto": {
        "type": "object",
        "properties": {
          "requiredInputFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VerificationInputField"
            },
            "description": "Recipient field names that need correction before verification can start. Contains no recipient values; an empty list is not verification clearance.",
            "readOnly": true
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "eventId": {
            "type": "string",
            "description": "Stable GUID that equals the X-DirecFunds-Event-Id header of the webhook delivery for the same change.",
            "format": "uuid",
            "readOnly": true
          },
          "disbursementRequestId": {
            "type": "string",
            "description": "The request this event belongs to. Required when consuming the company-wide Events feed.",
            "format": "uuid"
          },
          "eventType": {
            "type": "string"
          },
          "eventKind": {
            "type": "string"
          },
          "subjectType": {
            "type": "string"
          },
          "subjectId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "actorId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "actorRole": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "previousState": {
            "type": "string",
            "nullable": true
          },
          "currentState": {
            "type": "string",
            "nullable": true
          },
          "providerEventId": {
            "type": "string",
            "nullable": true
          },
          "paymentRail": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "providerOutcomeCode": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "providerOutcomeDescription": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "providerOutcomeCategory": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "reconciliationState": {
            "type": "string",
            "nullable": true
          },
          "exceptionOwner": {
            "type": "string",
            "nullable": true
          },
          "nextAllowedAction": {
            "type": "string",
            "nullable": true
          },
          "recoveryPath": {
            "type": "string",
            "nullable": true
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "DisbursementRequestExtendedInputPublicDto": {
        "required": [
          "templateId"
        ],
        "type": "object",
        "properties": {
          "templateId": {
            "type": "integer",
            "format": "int32"
          },
          "value": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "DisbursementRequestFundingPublicDto": {
        "type": "object",
        "properties": {
          "payInId": {
            "type": "string",
            "format": "uuid"
          },
          "sourceAccountReferenceId": {
            "type": "string",
            "format": "uuid"
          },
          "sourceTargetAccountId": {
            "type": "string",
            "format": "uuid"
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "transferStatus": {
            "type": "string",
            "description": "Readonly funding-leg transfer status. Treat unknown future values as NeedsAttention.",
            "nullable": true,
            "readOnly": true
          },
          "verificationStatus": {
            "type": "string",
            "description": "Readonly funding-leg verification status. Treat unknown future values as NeedsAttention.",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "type": "string",
            "description": "Readonly normalized funding-leg lifecycle status. Treat unknown future values as NeedsAttention.",
            "readOnly": true
          },
          "providerReference": {
            "type": "string",
            "description": "Readonly provider reference when one is available.",
            "nullable": true,
            "readOnly": true
          },
          "settledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "calculatedBy": {
            "type": "string"
          },
          "snapshotCapturedAt": {
            "type": "string",
            "format": "date-time"
          },
          "goodFundsReleaseAt": {
            "type": "string",
            "description": "Readonly earliest UTC instant when held ACH funding may release dependent payouts.",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementRequestLinksPublicDto": {
        "type": "object",
        "properties": {
          "self": {
            "type": "string"
          },
          "disbursement": {
            "type": "string"
          },
          "payIn": {
            "type": "string"
          },
          "payOuts": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "events": {
            "type": "string",
            "description": "Authoritative append-only request event history."
          },
          "reconciliation": {
            "type": "string",
            "description": "Read-only funding and recipient settlement summary."
          }
        }
      },
      "DisbursementRequestListItemPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "clientReference": {
            "type": "string"
          },
          "branchId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementRequestPublicStatus2"
          },
          "currency": {
            "type": "string"
          },
          "fundingAmount": {
            "type": "number",
            "description": "The funding leg's amount, which is the authoritative total for the closing.",
            "format": "decimal"
          },
          "recipientPaymentCount": {
            "type": "integer",
            "format": "int32"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "scheduledFor": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "self": {
            "type": "string",
            "description": "Path to the full request. Follow it for recipient payments, allowed actions and links."
          }
        }
      },
      "DisbursementRequestOperationalSummaryPublicDto": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          },
          "totalRequests": {
            "type": "integer",
            "format": "int32"
          },
          "totalAmount": {
            "type": "number",
            "format": "decimal"
          },
          "completedRequests": {
            "type": "integer",
            "format": "int32"
          },
          "partiallyCompletedRequests": {
            "type": "integer",
            "format": "int32"
          },
          "needsAttentionRequests": {
            "type": "integer",
            "format": "int32"
          },
          "scheduledRequests": {
            "type": "integer",
            "format": "int32"
          },
          "recipientPaymentsByStatus": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          }
        }
      },
      "DisbursementRequestPagePublicDto": {
        "type": "object",
        "properties": {
          "requests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestListItemPublicDto"
            }
          },
          "nextCursor": {
            "type": "string",
            "description": "Pass back as `cursor` to continue. IMPORTANT: a short page does NOT mean the end - only a null nextCursor does. Two of the filters are applied after reading, so a page can come back partly or entirely empty and still have more results behind it.",
            "nullable": true
          }
        }
      },
      "DisbursementRequestPublicCommand": {
        "required": [
          "clientReference",
          "fundingInstruction",
          "recipientPayments",
          "approvalContext"
        ],
        "type": "object",
        "properties": {
          "clientReference": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
            "type": "string",
            "description": "Partner-defined reference for this independent DirecFunds request. Must be 1 to 128 characters, start with a letter or number, use only letters, numbers, period, underscore, or hyphen, and be unique within the authenticated company. An Order may create multiple requests, but each request needs a distinct clientReference."
          },
          "branchId": {
            "type": "string",
            "description": "Optional when the requester, funding account, and API integration resolve to exactly one authorized active branch. The resolved branchId is retained in the response and audit record.",
            "format": "uuid",
            "nullable": true
          },
          "fundingInstruction": {
            "$ref": "#/components/schemas/DisbursementFundingInstructionPublicDto"
          },
          "recipientPayments": {
            "maxItems": 100,
            "minItems": 1,
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRecipientInstructionPublicDto"
            }
          },
          "expectedTotal": {
            "type": "number",
            "format": "decimal",
            "nullable": true
          },
          "currency": {
            "type": "string"
          },
          "mortgageType": {
            "$ref": "#/components/schemas/NullableOfMortgageType"
          },
          "mortgageTypeOtherDescription": {
            "maxLength": 128,
            "minLength": 0,
            "type": "string",
            "nullable": true
          },
          "scheduledFor": {
            "type": "string",
            "description": "Optional UTC dispatch time, later than now and no more than 365 days ahead. $VerifyAndSend approves the request once; DirecFunds then automatically releases it for routing at or after this time. This is a processing time, not a guaranteed settlement time.",
            "format": "date-time",
            "nullable": true
          },
          "extendedInputs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestExtendedInputPublicDto"
            }
          },
          "approvalContext": {
            "$ref": "#/components/schemas/DisbursementApprovalContextPublicDto"
          }
        }
      },
      "DisbursementRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "clientReference": {
            "type": "string"
          },
          "disbursementId": {
            "type": "string",
            "format": "uuid"
          },
          "branchId": {
            "type": "string",
            "format": "uuid"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementRequestPublicStatus"
          },
          "scheduledFor": {
            "type": "string",
            "description": "The requested UTC dispatch time, when scheduling is used. It is cleared by $CancelSchedule.",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "currency": {
            "type": "string"
          },
          "mortgageType": {
            "$ref": "#/components/schemas/NullableOfMortgageType2"
          },
          "mortgageTypeOtherDescription": {
            "type": "string",
            "nullable": true
          },
          "approvalContext": {
            "$ref": "#/components/schemas/DisbursementRequestApprovalPublicDto"
          },
          "approvalRequirements": {
            "$ref": "#/components/schemas/DisbursementApprovalRequirementsPublicDto2"
          },
          "funding": {
            "$ref": "#/components/schemas/DisbursementRequestFundingPublicDto"
          },
          "recipientPayments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestRecipientPublicDto"
            }
          },
          "attention": {
            "$ref": "#/components/schemas/DisbursementNeedsAttentionPublicDto"
          },
          "allowedNextActions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The actions this request currently permits, driven by its status. One of: SubmitForApproval (Initialized) - POST /DisbursementRequests/{id}/$SubmitForApproval; VerifyAndSend (PendingApproval) - POST /DisbursementRequests/{id}/$VerifyAndSend; Reject (pristine pre-dispatch approval states) - POST /DisbursementRequests/{id}/$Reject; CancelSchedule (Scheduled) - POST /DisbursementRequests/{id}/$CancelSchedule; ReviewFailedPayments (PartiallyCompleted or NeedsAttention) - inspect each recipient payment's own allowedNextActions and act on those. POST /DisbursementRequests/{id}/$Cancel additionally abandons the whole request from any pre-dispatch status. Terminal statuses (Completed, Rejected, Canceled) return an empty list. Treat an unrecognised value as 'no action available to this client version' rather than an error: the list is deliberately open so that adding an action does not break existing integrations."
          },
          "links": {
            "$ref": "#/components/schemas/DisbursementRequestLinksPublicDto"
          },
          "deliveryAssessment": {
            "oneOf": [
              {
                "enum": [
                  null
                ],
                "nullable": true
              },
              {
                "$ref": "#/components/schemas/PaymentDeliveryAssessment"
              }
            ]
          },
          "draftVersion": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "Current instruction version. Review these details and supply this value as expectedDraftVersion when approving. Reload and review again after a 409 version conflict.",
            "format": "int64"
          }
        }
      },
      "DisbursementRequestPublicStatus": {
        "type": "string",
        "description": "Current aggregate lifecycle status. Scheduled means the request is approved and held for automatic release by DirecFunds at or after scheduledFor. Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "x-extensible-enum": [
          "Initialized",
          "PendingApproval",
          "Scheduled",
          "Processing",
          "Completed",
          "PartiallyCompleted",
          "NeedsAttention",
          "Rejected",
          "Canceled"
        ]
      },
      "DisbursementRequestPublicStatus2": {
        "type": "string",
        "description": "Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "x-extensible-enum": [
          "Initialized",
          "PendingApproval",
          "Scheduled",
          "Processing",
          "Completed",
          "PartiallyCompleted",
          "NeedsAttention",
          "Rejected",
          "Canceled"
        ]
      },
      "DisbursementRequestRecipientPublicDto": {
        "type": "object",
        "properties": {
          "paymentReference": {
            "type": "string"
          },
          "recipientName": {
            "type": "string"
          },
          "payOutId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "transferStatus": {
            "$ref": "#/components/schemas/TransferStatus"
          },
          "verificationStatus": {
            "$ref": "#/components/schemas/VerificationStatus"
          },
          "status": {
            "$ref": "#/components/schemas/DisbursementRecipientPaymentPublicStatus"
          },
          "providerReference": {
            "type": "string",
            "description": "Readonly",
            "nullable": true,
            "readOnly": true
          },
          "failure": {
            "$ref": "#/components/schemas/DisbursementPaymentFailurePublicDto"
          },
          "allowedNextActions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Readonly. The recovery actions this individual payment currently permits, driven by its transfer status. One of: Retry - POST .../RecipientPayments/{paymentReference}/$Retry; ReplaceDestination - POST .../RecipientPayments/{paymentReference}/$ReplaceDestination; Cancel - POST .../RecipientPayments/{paymentReference}/$Cancel. A submitted or completed payment returns an empty list and is immutable. Invoke ONLY an action listed here for THIS payment; treat an unrecognised value as no action available to this client version.",
            "readOnly": true
          },
          "attempts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementPaymentAttemptPublicDto"
            },
            "description": "Readonly",
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "readOnly": true
          },
          "settledAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementRequestReconciliationPublicDto": {
        "type": "object",
        "properties": {
          "disbursementRequestId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "description": "Legacy v1 payment-lifecycle roll-up. Reconciled means recipient legs completed; it is not proof of bank-statement or customer-accounting matching. Consult reconciliationScope and matching fields."
          },
          "calculatedFundingAmount": {
            "type": "number",
            "format": "decimal"
          },
          "completedAmount": {
            "type": "number",
            "format": "decimal"
          },
          "outstandingAmount": {
            "type": "number",
            "format": "decimal"
          },
          "failedAmount": {
            "type": "number",
            "format": "decimal"
          },
          "completedPaymentCount": {
            "type": "integer",
            "format": "int32"
          },
          "failedPaymentCount": {
            "type": "integer",
            "format": "int32"
          },
          "pendingPaymentCount": {
            "type": "integer",
            "format": "int32"
          },
          "exceptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementReconciliationExceptionPublicDto"
            }
          },
          "asOf": {
            "type": "string",
            "format": "date-time"
          },
          "reconciliationScope": {
            "type": "string",
            "readOnly": true
          },
          "bankStatementMatching": {
            "type": "string",
            "readOnly": true
          },
          "customerAccountingMatching": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "DisbursementRequestValidationIssuePublicDto": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          }
        }
      },
      "DisbursementRequestValidationPublicDto": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean"
          },
          "calculatedFundingAmount": {
            "type": "number",
            "format": "decimal"
          },
          "currency": {
            "type": "string"
          },
          "recipientPaymentCount": {
            "type": "integer",
            "format": "int32"
          },
          "approvalRequirements": {
            "$ref": "#/components/schemas/DisbursementApprovalRequirementsPublicDto"
          },
          "issues": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestValidationIssuePublicDto"
            }
          },
          "validatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "preflight": {
            "oneOf": [
              {
                "enum": [
                  null
                ],
                "nullable": true
              },
              {
                "$ref": "#/components/schemas/DisbursementRequestPreflightPublicDto"
              }
            ]
          }
        }
      },
      "Disbursements": {
        "title": "disbursements",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Disbursement"
        },
        "description": "Response"
      },
      "DisbursementStatus": {
        "type": "string",
        "description": "Readonly Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "nullable": true,
        "readOnly": true,
        "x-extensible-enum": [
          "Pending",
          "Routing",
          "RequiresInconclusiveOverride",
          "Verified",
          "Rejected",
          "Processing",
          "Completed",
          "Failed",
          "PendingInfo",
          "Initialized",
          "Canceled"
        ]
      },
      "DisbursementWebhookDeliveryPagePublicDto": {
        "type": "object",
        "properties": {
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "deliveries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementWebhookDeliveryPublicDto"
            }
          },
          "nextCursor": {
            "type": "integer",
            "description": "Pass as `cursor` to fetch the next page. Null on the last page.",
            "format": "int64",
            "nullable": true
          }
        }
      },
      "DisbursementWebhookDeliveryPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Readonly. The delivery id, used to redeliver this attempt and as the paging cursor.",
            "format": "int64",
            "readOnly": true
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "eventId": {
            "type": "string",
            "description": "Readonly. Matches the X-DirecFunds-Event-Id header on the delivery, so a receiver can reconcile what it did or did not accept.",
            "format": "uuid",
            "readOnly": true
          },
          "sequence": {
            "type": "integer",
            "description": "Readonly. Monotonic transaction-event sequence from the webhook body. Use it to discard stale out-of-order notifications.",
            "format": "int64",
            "readOnly": true
          },
          "eventType": {
            "type": "string",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "description": "Readonly. One of Pending, Processing, Delivered, DeadLettered. DeadLettered means every attempt was exhausted and DirecFunds will not retry on its own - use $Redeliver.",
            "readOnly": true
          },
          "attempts": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "nextAttemptAt": {
            "type": "string",
            "description": "Readonly. When the next automatic attempt is due. Null for a delivery that is no longer being retried.",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "lastError": {
            "type": "string",
            "description": "Readonly. Why the most recent attempt failed - typically the HTTP status your endpoint returned.",
            "nullable": true,
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "deliveredAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementWebhookSubscriptionPublicCommand": {
        "required": [
          "callbackUrl"
        ],
        "type": "object",
        "properties": {
          "callbackUrl": {
            "type": "string",
            "description": "Absolute public HTTPS callback URL. Localhost, credentials, fragments, private or otherwise non-public destinations, and values longer than 2,048 characters are rejected.",
            "x-direcfunds-validation": {
              "httpsOnly": true,
              "maxLength": 2048
            }
          },
          "signingSecret": {
            "type": "string",
            "description": "Optional caller-managed HMAC secret of 32 to 512 characters. Omit it to receive a generated secret in the create response only.",
            "nullable": true,
            "x-direcfunds-validation": {
              "minLength": 32,
              "maxLength": 512
            }
          },
          "eventTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "One to 25 exact, case-sensitive subscribable event types, or the single wildcard * by itself. Each value is limited to 64 characters. webhook.ping is diagnostic and cannot be subscribed to. See x-direcfunds-accepted-values for the current catalog.",
            "default": [
              "*"
            ],
            "x-direcfunds-validation": {
              "minItems": 1,
              "maxItems": 25,
              "itemMinLength": 1,
              "itemMaxLength": 64
            },
            "x-direcfunds-accepted-values": [
              "*",
              "disbursementrequest.updated",
              "payin.canceled",
              "payin.completed",
              "payin.failed",
              "payin.rejected",
              "payout.canceled",
              "payout.completed",
              "payout.failed",
              "payout.rejected"
            ]
          }
        }
      },
      "DisbursementWebhookSubscriptionPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "callbackUrl": {
            "type": "string"
          },
          "eventTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "active": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "signatureAlgorithm": {
            "type": "string"
          },
          "signingSecret": {
            "type": "string",
            "description": "Returned only when DirecFunds generated the secret, by the successful create response or its exact idempotent replay. A caller-supplied secret is never echoed back, and later reads and updates never return the signing secret.",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "DisbursementWebhookSubscriptionUpdatePublicCommand": {
        "type": "object",
        "properties": {
          "callbackUrl": {
            "type": "string",
            "description": "Absolute public HTTPS callback URL. Localhost, credentials, fragments, private or otherwise non-public destinations, and values longer than 2,048 characters are rejected.",
            "nullable": true,
            "x-direcfunds-validation": {
              "httpsOnly": true,
              "maxLength": 2048
            }
          },
          "signingSecret": {
            "type": "string",
            "description": "Optional replacement HMAC secret of 32 to 512 characters. Omit it to keep the current secret unchanged.",
            "nullable": true,
            "x-direcfunds-validation": {
              "minLength": 32,
              "maxLength": 512
            }
          },
          "eventTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "One to 25 exact, case-sensitive subscribable event types, or the single wildcard * by itself. Each value is limited to 64 characters. webhook.ping is diagnostic and cannot be subscribed to. See x-direcfunds-accepted-values for the current catalog.",
            "nullable": true,
            "x-direcfunds-validation": {
              "minItems": 1,
              "maxItems": 25,
              "itemMinLength": 1,
              "itemMaxLength": 64
            },
            "x-direcfunds-accepted-values": [
              "*",
              "disbursementrequest.updated",
              "payin.canceled",
              "payin.completed",
              "payin.failed",
              "payin.rejected",
              "payout.canceled",
              "payout.completed",
              "payout.failed",
              "payout.rejected"
            ]
          }
        }
      },
      "DisbursementWebhookTestResultPublicDto": {
        "type": "object",
        "properties": {
          "eventId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "delivered": {
            "type": "boolean",
            "readOnly": true
          },
          "statusCode": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "readOnly": true
          },
          "attemptedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "message": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "IntegrationFeaturePublicDto": {
        "type": "object",
        "properties": {
          "paymentStatusPolling": {
            "type": "boolean",
            "readOnly": true
          },
          "auditLog": {
            "type": "boolean",
            "readOnly": true
          },
          "atomicDisbursementCreate": {
            "type": "boolean",
            "readOnly": true
          },
          "reconciliation": {
            "type": "boolean",
            "readOnly": true
          },
          "onboardingReadiness": {
            "type": "boolean",
            "readOnly": true
          },
          "bankAccountVerification": {
            "type": "boolean",
            "readOnly": true
          },
          "branchBankAccountManagement": {
            "type": "boolean",
            "readOnly": true
          },
          "testSandbox": {
            "type": "boolean",
            "readOnly": true
          },
          "webhooks": {
            "type": "boolean",
            "readOnly": true
          }
        },
        "readOnly": true
      },
      "IntegrationPolicyPublicDto": {
        "type": "object",
        "properties": {
          "idempotencyKeyRequired": {
            "type": "boolean",
            "readOnly": true
          },
          "ifMatchRequired": {
            "type": "boolean",
            "readOnly": true
          },
          "defaultPageLimit": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "maximumPageLimit": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "rateLimitEnabled": {
            "type": "boolean",
            "readOnly": true
          },
          "rateLimitRequests": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "rateLimitWindowSeconds": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "readOnly": true
      },
      "IntegrationProfilePublicDto": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "environment": {
            "type": "string",
            "readOnly": true
          },
          "apiVersion": {
            "type": "string",
            "readOnly": true
          },
          "serverTime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "grantedPermissions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "features": {
            "$ref": "#/components/schemas/IntegrationFeaturePublicDto"
          },
          "policies": {
            "$ref": "#/components/schemas/IntegrationPolicyPublicDto"
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "readOnly": true
          }
        }
      },
      "MoneyMovementRefusalResponse": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "Stable machine-readable refusal code, e.g. KYB_KYC_NOT_PASSED or SAME_DAY_ACH_AFTER_CUTOFF."
          },
          "message": {
            "type": "string",
            "description": "Human-readable explanation of the refusal."
          },
          "resolution": {
            "oneOf": [
              {
                "enum": [
                  null
                ],
                "nullable": true
              },
              {
                "$ref": "#/components/schemas/ApiErrorResolution"
              }
            ]
          },
          "traceId": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "NullableOfDepositAccountTypes": {
        "enum": [
          "Checking",
          "Savings",
          null
        ],
        "description": "Optional account classification. An account must be classified as Checking or Savings before it can fund an ACH payment.",
        "nullable": true
      },
      "NullableOfDepositAccountTypes2": {
        "enum": [
          "Checking",
          "Savings",
          null
        ],
        "description": "Optional account classification. Must be Checking or Savings before the account can fund an ACH payment.",
        "nullable": true
      },
      "NullableOfMortgageType": {
        "enum": [
          "Conventional",
          "FHA",
          "VA",
          "USDARuralDevelopment",
          "Other",
          null
        ],
        "description": "Optional MISMO-aligned mortgage classification for transaction analytics: Conventional, FHA, VA, USDARuralDevelopment, or Other.",
        "nullable": true
      },
      "NullableOfMortgageType2": {
        "enum": [
          "Conventional",
          "FHA",
          "VA",
          "USDARuralDevelopment",
          "Other",
          null
        ],
        "nullable": true
      },
      "NullableOfPaymentRail": {
        "enum": [
          "Wire",
          "Ach",
          "SamedayAch",
          "InstantPayment",
          "Zelle",
          "FedNow",
          "Other",
          null
        ],
        "nullable": true,
        "readOnly": true
      },
      "NullableOfTargetAccountDepositTypes": {
        "enum": [
          "Checking",
          "Savings",
          null
        ],
        "nullable": true
      },
      "OnboardingBankAccountReadinessPublicDto": {
        "type": "object",
        "properties": {
          "bankAccountId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "displayName": {
            "type": "string",
            "readOnly": true
          },
          "verificationStatus": {
            "type": "string",
            "readOnly": true
          },
          "branchIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "achReady": {
            "type": "boolean",
            "description": "True when this verified, branch-assigned account can fund managed disbursements by Same Day ACH debit.",
            "readOnly": true
          },
          "wireReady": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "OnboardingChecklistActionPublicDto": {
        "type": "object",
        "properties": {
          "method": {
            "type": "string",
            "readOnly": true
          },
          "href": {
            "type": "string",
            "readOnly": true
          }
        },
        "nullable": true,
        "readOnly": true
      },
      "OnboardingChecklistPublicDto": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "disbursementsEnabled": {
            "type": "boolean",
            "readOnly": true
          },
          "steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingChecklistStepPublicDto"
            },
            "readOnly": true
          }
        }
      },
      "OnboardingChecklistStepPublicDto": {
        "type": "object",
        "properties": {
          "step": {
            "type": "string",
            "readOnly": true
          },
          "title": {
            "type": "string",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "actionableByPartner": {
            "type": "boolean",
            "readOnly": true
          },
          "action": {
            "$ref": "#/components/schemas/OnboardingChecklistActionPublicDto"
          },
          "findings": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          }
        }
      },
      "OnboardingProvisionPublicDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "readOnly": true
          },
          "dryRun": {
            "type": "boolean",
            "readOnly": true
          },
          "branchId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "bankAccountId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingProvisionUserResultPublicDto"
            },
            "readOnly": true
          },
          "steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingProvisionStepPublicDto"
            },
            "readOnly": true
          }
        }
      },
      "OnboardingProvisionPublicRequest": {
        "required": [
          "branch"
        ],
        "type": "object",
        "properties": {
          "dryRun": {
            "type": "boolean"
          },
          "branch": {
            "$ref": "#/components/schemas/ProvisionBranchPublicRequest"
          },
          "bankAccount": {
            "$ref": "#/components/schemas/ProvisionBankAccountPublicRequest"
          },
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProvisionUserPublicRequest"
            }
          }
        }
      },
      "OnboardingProvisionStepProblemPublicDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          },
          "title": {
            "type": "string",
            "readOnly": true
          },
          "detail": {
            "type": "string",
            "readOnly": true
          }
        },
        "nullable": true,
        "readOnly": true
      },
      "OnboardingProvisionStepPublicDto": {
        "type": "object",
        "properties": {
          "step": {
            "type": "string",
            "readOnly": true
          },
          "target": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "resourceId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "problem": {
            "$ref": "#/components/schemas/OnboardingProvisionStepProblemPublicDto"
          }
        }
      },
      "OnboardingProvisionUserResultPublicDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "readOnly": true
          },
          "userId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "OnboardingReadinessFindingPublicDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "readOnly": true
          },
          "message": {
            "type": "string",
            "readOnly": true
          },
          "resourceId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "OnboardingReadinessPublicDto": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "disbursementsEnabled": {
            "type": "boolean",
            "readOnly": true
          },
          "companyActive": {
            "type": "boolean",
            "readOnly": true
          },
          "kybKycStatus": {
            "type": "string",
            "readOnly": true
          },
          "agreementsComplete": {
            "type": "boolean",
            "readOnly": true
          },
          "branchesConfigured": {
            "type": "boolean",
            "readOnly": true
          },
          "usersConfigured": {
            "type": "boolean",
            "readOnly": true
          },
          "permissionsConfigured": {
            "type": "boolean",
            "readOnly": true
          },
          "bankAccounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingBankAccountReadinessPublicDto"
            },
            "readOnly": true
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingReadinessFindingPublicDto"
            },
            "readOnly": true
          }
        }
      },
      "PayInPublicDto": {
        "required": [
          "disbursementId",
          "sourceAccountReferenceId",
          "paymentRail",
          "amount"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "disbursementId": {
            "type": "string",
            "format": "uuid"
          },
          "sourceAccountReferenceId": {
            "type": "string",
            "format": "uuid"
          },
          "sourceAccountReference": {
            "type": "string",
            "format": "uri-reference",
            "nullable": true
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "format": "decimal"
          },
          "achDebitAuthorizationAccepted": {
            "type": "boolean",
            "description": "Required and must be true for a Same Day ACH debit from a managed source account. Omit for reverse wire. Standard ACH funding is not supported."
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "completedAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "PaymentRail": {
        "enum": [
          "Wire",
          "Ach",
          "SamedayAch",
          "InstantPayment",
          "Zelle",
          "FedNow",
          "Other"
        ],
        "description": "Readonly",
        "readOnly": true
      },
      "PaymentRail2": {
        "enum": [
          "Wire",
          "Ach",
          "SamedayAch",
          "InstantPayment",
          "Zelle",
          "FedNow",
          "Other"
        ]
      },
      "PaymentRail3": {
        "enum": [
          "Wire",
          "Ach",
          "SamedayAch",
          "InstantPayment",
          "Zelle",
          "FedNow",
          "Other"
        ],
        "readOnly": true
      },
      "PaymentRailCapabilityPublicDto": {
        "type": "object",
        "properties": {
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail3"
          },
          "displayName": {
            "type": "string",
            "readOnly": true
          },
          "supportsPayIn": {
            "type": "boolean",
            "readOnly": true
          },
          "supportsPayOut": {
            "type": "boolean",
            "readOnly": true
          },
          "availableInTest": {
            "type": "boolean",
            "readOnly": true
          },
          "maximumAmount": {
            "type": "number",
            "format": "double",
            "nullable": true,
            "readOnly": true
          },
          "settlementSpeed": {
            "type": "string",
            "readOnly": true
          },
          "finality": {
            "type": "string",
            "readOnly": true
          },
          "requiredPayOutFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          }
        }
      },
      "PaymentStatusEventPagePublicDto": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentStatusEventPublicDto"
            },
            "readOnly": true
          },
          "nextEventId": {
            "type": "integer",
            "format": "int64",
            "nullable": true,
            "readOnly": true
          },
          "hasMore": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "PaymentStatusEventPublicDto": {
        "type": "object",
        "properties": {
          "eventId": {
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "disbursementId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "resourceType": {
            "type": "string",
            "readOnly": true
          },
          "resourceId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/NullableOfPaymentRail"
          },
          "statusType": {
            "type": "string",
            "readOnly": true
          },
          "providerReference": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "previousStatus": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "status": {
            "type": "string",
            "readOnly": true
          },
          "isTerminal": {
            "type": "boolean",
            "readOnly": true
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "PayOut": {
        "required": [
          "disbursementId",
          "paymentRail",
          "amount",
          "transactionPurpose",
          "targetAccountId",
          "recipient"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "disbursementId": {
            "type": "string",
            "format": "uuid"
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail2"
          },
          "amount": {
            "type": "number",
            "description": "Payout amount. Zelle payouts have a $5,000 per-transaction maximum.",
            "format": "decimal"
          },
          "createdAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "completedAt": {
            "type": "string",
            "description": "Readonly",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "transferStatus": {
            "$ref": "#/components/schemas/TransferStatus"
          },
          "actualPaymentNetwork": {
            "type": "string",
            "description": "Bank-confirmed network for an instant payout, when available. May differ from the requested paymentRail.",
            "nullable": true,
            "readOnly": true
          },
          "verificationStatus": {
            "$ref": "#/components/schemas/VerificationStatus"
          },
          "transactionPurpose": {
            "$ref": "#/components/schemas/TransactionPurpose"
          },
          "otherPurpose": {
            "type": "string",
            "description": "Required when transactionPurpose is Other; describe the payment in 256 characters or fewer.",
            "nullable": true
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid"
          },
          "recipient": {
            "$ref": "#/components/schemas/Recipient"
          },
          "transactionDetails": {
            "$ref": "#/components/schemas/TransactionDetailsPublicDto"
          },
          "externalReference": {
            "type": "string",
            "description": "Optional partner-supplied reference (e.g. a closing file or order number). Stored and echoed back on reads, and filterable so records can be looked up by your own id.",
            "nullable": true
          }
        }
      },
      "PayOuts": {
        "title": "payOuts",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/PayOut"
        },
        "description": "Response"
      },
      "PhoneNumberPublicDto": {
        "required": [
          "number"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "number": {
            "type": "string"
          },
          "textsOkay": {
            "type": "boolean"
          }
        },
        "nullable": true
      },
      "PhoneNumberPublicDto2": {
        "required": [
          "number"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "number": {
            "type": "string"
          },
          "textsOkay": {
            "type": "boolean"
          }
        }
      },
      "ProblemDetailsResponse": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Http response type"
          },
          "status": {
            "type": "integer",
            "description": "Http status code",
            "format": "int32"
          },
          "title": {
            "type": "string"
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "traceId": {
            "type": "string",
            "nullable": true
          },
          "validationFailures": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationFailureSummary"
            },
            "nullable": true
          },
          "errorCode": {
            "type": "string",
            "nullable": true
          },
          "retryAtUtc": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "nextWindowEasternTime": {
            "type": "string",
            "nullable": true
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "nullable": true
          },
          "resolution": {
            "oneOf": [
              {
                "enum": [
                  null
                ],
                "nullable": true
              },
              {
                "$ref": "#/components/schemas/ApiErrorResolution"
              }
            ]
          }
        }
      },
      "ProvisionBankAccountPublicRequest": {
        "required": [
          "bankName",
          "beneficiary",
          "accountNumber",
          "routingNumber"
        ],
        "type": "object",
        "properties": {
          "bankName": {
            "type": "string"
          },
          "nickName": {
            "type": "string",
            "nullable": true
          },
          "beneficiary": {
            "type": "string"
          },
          "accountNumber": {
            "type": "string",
            "description": "Together with routingNumber, the convergence key: an existing account with the same numbers is reused."
          },
          "routingNumber": {
            "type": "string"
          },
          "depositAccountType": {
            "$ref": "#/components/schemas/NullableOfDepositAccountTypes2"
          },
          "addressId": {
            "type": "string",
            "description": "An existing address to attach when the account must be created. Mutually exclusive with address.",
            "format": "uuid",
            "nullable": true
          },
          "address": {
            "$ref": "#/components/schemas/Address3"
          }
        },
        "nullable": true
      },
      "ProvisionBranchPublicRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The branch is matched case-insensitively by name; an existing branch is reused."
          },
          "addressId": {
            "type": "string",
            "description": "An existing address to attach when the branch must be created. Mutually exclusive with address.",
            "format": "uuid",
            "nullable": true
          },
          "address": {
            "$ref": "#/components/schemas/Address2"
          },
          "phoneNumber": {
            "$ref": "#/components/schemas/PhoneNumberPublicDto"
          }
        }
      },
      "ProvisionUserPublicRequest": {
        "required": [
          "givenName",
          "surname",
          "email"
        ],
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "email": {
            "type": "string",
            "description": "The convergence key: an existing active user with this email is reused."
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "canRequestFunds": {
            "type": "boolean",
            "description": "Grant requester authority on the provisioned branch (merged with existing grants, never revoked)."
          },
          "canApproveFunds": {
            "type": "boolean",
            "description": "Grant approver authority on the provisioned branch (merged with existing grants, never revoked)."
          }
        }
      },
      "Recipient": {
        "required": [
          "name",
          "recipientType"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "dateOfBirth": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "address1": {
            "type": "string"
          },
          "address2": {
            "type": "string",
            "nullable": true
          },
          "address3": {
            "type": "string",
            "nullable": true
          },
          "address4": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Two character state code (OH, CA, NY, etc...) when an address is supplied. Optional: Zelle alias payouts may omit the address entirely."
          },
          "postalCode": {
            "type": "string",
            "description": "Postal code, up to 16 characters, when an address is supplied. Optional: Zelle alias payouts may omit the address entirely."
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "tin": {
            "type": "string",
            "nullable": true
          },
          "recipientType": {
            "$ref": "#/components/schemas/RecipientType"
          }
        }
      },
      "Recipient2": {
        "required": [
          "name",
          "recipientType"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "dateOfBirth": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "address1": {
            "type": "string"
          },
          "address2": {
            "type": "string",
            "nullable": true
          },
          "address3": {
            "type": "string",
            "nullable": true
          },
          "address4": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Two character state code (OH, CA, NY, etc...) when an address is supplied. Optional: Zelle alias payouts may omit the address entirely."
          },
          "postalCode": {
            "type": "string",
            "description": "Postal code, up to 16 characters, when an address is supplied. Optional: Zelle alias payouts may omit the address entirely."
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "tin": {
            "type": "string",
            "nullable": true
          },
          "recipientType": {
            "$ref": "#/components/schemas/RecipientType"
          }
        },
        "nullable": true
      },
      "RecipientType": {
        "enum": [
          "Person",
          "Business"
        ]
      },
      "ReconciliationTransactionPagePublicDto": {
        "type": "object",
        "properties": {
          "transactions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReconciliationTransactionPublicDto"
            },
            "readOnly": true
          },
          "nextCursor": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "hasMore": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "ReconciliationTransactionPublicDto": {
        "type": "object",
        "properties": {
          "resourceType": {
            "type": "string",
            "readOnly": true
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "disbursementId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "externalReference": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "paymentRail": {
            "$ref": "#/components/schemas/PaymentRail3"
          },
          "amount": {
            "type": "number",
            "format": "decimal",
            "readOnly": true
          },
          "transferStatus": {
            "type": "string",
            "readOnly": true
          },
          "verificationStatus": {
            "type": "string",
            "readOnly": true
          },
          "disbursementStatus": {
            "type": "string",
            "readOnly": true
          },
          "providerReference": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "statusUpdatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "settledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "isTerminal": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "ReplaceBranchBankAccountsPublicRequest": {
        "required": [
          "bankAccountIds"
        ],
        "type": "object",
        "properties": {
          "bankAccountIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        }
      },
      "ReplaceUserPermissionDocumentRequest": {
        "type": "object",
        "properties": {
          "branches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserPermissionBranchDto"
            }
          }
        }
      },
      "SandboxPreparationPublicDto": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "bankAccountId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "userId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "branchIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "changesApplied": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "readyForDisbursements": {
            "type": "boolean",
            "readOnly": true
          },
          "verificationResult": {
            "type": "string",
            "readOnly": true
          },
          "verificationTraceId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          },
          "verificationCheckedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "SandboxScenarioPublicDto": {
        "type": "object",
        "properties": {
          "scenario": {
            "type": "string",
            "readOnly": true
          },
          "resultingTransferStatus": {
            "type": "string",
            "readOnly": true
          },
          "terminal": {
            "type": "boolean",
            "readOnly": true
          },
          "description": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "SandboxSimulationErrorPublicDto": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "readOnly": true
          },
          "message": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "SandboxSimulationPublicRequest": {
        "required": [
          "scenario"
        ],
        "type": "object",
        "properties": {
          "scenario": {
            "type": "string"
          }
        }
      },
      "TargetAccount": {
        "required": [
          "bankName",
          "accountNumber",
          "routingNumber",
          "accountBeneficiary",
          "bankAddress1",
          "bankCity",
          "bankState"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "bankName": {
            "type": "string"
          },
          "accountNumber": {
            "type": "string",
            "description": "Write: full account number. Responses contain only **** plus the last four characters; accountNumber cannot be used as a collection filter."
          },
          "routingNumber": {
            "type": "string",
            "description": "Write: full routing number. Responses contain only **** plus the last four characters; routingNumber cannot be used as a collection filter."
          },
          "depositAccountType": {
            "$ref": "#/components/schemas/NullableOfTargetAccountDepositTypes"
          },
          "accountBeneficiary": {
            "type": "string"
          },
          "bankAddress1": {
            "type": "string"
          },
          "bankAddress2": {
            "type": "string",
            "nullable": true
          },
          "bankAddress3": {
            "type": "string",
            "nullable": true
          },
          "bankAddress4": {
            "type": "string",
            "nullable": true
          },
          "bankCity": {
            "type": "string"
          },
          "bankState": {
            "type": "string",
            "description": "Two character state code. OH, CA, NY, etc..."
          },
          "bankPostalCode": {
            "type": "string",
            "description": "Postal code of the receiving bank, up to 16 characters. International formats are accepted (international wires are a supported rail); US codes are typically 12345 or 12345-1234.",
            "nullable": true
          }
        }
      },
      "TransactionDetailsPublicDto": {
        "type": "object",
        "properties": {
          "memoLine": {
            "type": "string",
            "nullable": true
          },
          "bankReferenceType": {
            "type": "string",
            "description": "Readonly",
            "nullable": true
          },
          "bankReference": {
            "type": "string",
            "description": "Readonly",
            "nullable": true
          }
        }
      },
      "TransactionPurpose": {
        "enum": [
          "LoanPayoff",
          "SellerProceeds",
          "RealtorCommission",
          "FundsToClose",
          "EarnestMoney",
          "ClosingRelatedFees",
          "Retainer",
          "TitleAgencyCommission",
          "Other"
        ]
      },
      "TransferStatus": {
        "type": "string",
        "description": "Readonly Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "nullable": true,
        "readOnly": true,
        "x-extensible-enum": [
          "Processing",
          "Submitted",
          "Inconclusive",
          "Completed",
          "Canceled",
          "Rejected",
          "Failed",
          "PendingAccountActivation"
        ]
      },
      "TransferStatus2": {
        "type": "string",
        "description": "Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "x-extensible-enum": [
          "Processing",
          "Submitted",
          "Inconclusive",
          "Completed",
          "Canceled",
          "Rejected",
          "Failed",
          "PendingAccountActivation"
        ]
      },
      "TwoPartyVerificationRequest": {
        "required": [
          "approverUserId"
        ],
        "type": "object",
        "properties": {
          "approverUserId": {
            "type": "string",
            "description": "Required. Identifies the authorized user performing this approval. The user must satisfy the request's current approval requirements and branch/source-account permissions.",
            "format": "uuid"
          },
          "reviewConfirmed": {
            "type": "boolean",
            "description": "Records that the approver reviewed the amount, funding source, recipients, destination accounts, and delivery methods. For backward compatibility, omission is interpreted as true; new integrations should send true explicitly after review. Explicitly sending false is refused with 400 and no money moves.",
            "default": true
          },
          "expectedDraftVersion": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "Version of the request details reviewed by the approver. Send draftVersion from the latest request read. Omission refers only to the original version zero; edited requests require their current version. A mismatch returns 409 without approving or sending the revised request.",
            "format": "int64"
          }
        }
      },
      "User": {
        "required": [
          "givenName",
          "surname",
          "email"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Readonly",
            "format": "uuid",
            "readOnly": true
          },
          "givenName": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "active": {
            "type": "boolean",
            "description": "Omit on create/update, or set true on PUT to reactivate a previously deactivated user. Use DELETE to deactivate; false is rejected.",
            "nullable": true
          },
          "allowedPaymentRailIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Assigned payment-type grants used when per-user payment permissions are active. Workspace administrators manage these in the portal; branch, account, and rail readiness restrictions also apply.",
            "nullable": true,
            "readOnly": true
          },
          "branchPermissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserBranchPermissionsPublicDto"
            },
            "description": "User disbursement permissions for each assigned branch. Use the dedicated User Permissions endpoint only when permission automation is enabled for the integration.",
            "readOnly": true
          },
          "bankAccountPermissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserBankAccountPermissionsPublicDto"
            },
            "description": "User bank account access permissions for each assigned branch. Use the dedicated User Permissions endpoint only when permission automation is enabled for the integration.",
            "readOnly": true
          }
        }
      },
      "UserBankAccountPermissionsPublicDto": {
        "type": "object",
        "properties": {
          "branchId": {
            "type": "string",
            "description": "Bank accounts which the user is allowed to operate with.",
            "format": "uuid"
          },
          "bankAccounts": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        }
      },
      "UserBranchPermissionsPublicDto": {
        "type": "object",
        "properties": {
          "branchId": {
            "type": "string",
            "format": "uuid"
          },
          "canRequest": {
            "type": "boolean"
          },
          "canApprove": {
            "type": "boolean"
          }
        }
      },
      "UserPermissionBranchDto": {
        "type": "object",
        "properties": {
          "branchId": {
            "type": "string",
            "format": "uuid"
          },
          "canRequest": {
            "type": "boolean"
          },
          "canApprove": {
            "type": "boolean"
          },
          "bankAccountIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        }
      },
      "UserPermissionDocumentDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "format": "uuid"
          },
          "branches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserPermissionBranchDto"
            }
          },
          "etag": {
            "type": "string"
          }
        }
      },
      "UserReadinessBranchMembershipPublicDto": {
        "type": "object",
        "properties": {
          "branchId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "branchActive": {
            "type": "boolean",
            "readOnly": true
          },
          "canRequestFunds": {
            "type": "boolean",
            "readOnly": true
          },
          "canApproveFunds": {
            "type": "boolean",
            "readOnly": true
          },
          "bankAccountIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          },
          "fundingReadyBankAccountIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "readOnly": true
          }
        }
      },
      "UserReadinessPublicDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "active": {
            "type": "boolean",
            "readOnly": true
          },
          "ready": {
            "type": "boolean",
            "readOnly": true
          },
          "canRequestDisbursements": {
            "type": "boolean",
            "readOnly": true
          },
          "canApproveDisbursements": {
            "type": "boolean",
            "readOnly": true
          },
          "branchMemberships": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserReadinessBranchMembershipPublicDto"
            },
            "readOnly": true
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OnboardingReadinessFindingPublicDto"
            },
            "readOnly": true
          }
        }
      },
      "Users": {
        "title": "users",
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/User"
        },
        "description": "Response"
      },
      "ValidationFailureSummary": {
        "type": "object",
        "properties": {
          "propertyName": {
            "type": "string"
          },
          "errorMessages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        }
      },
      "VerificationResponse": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
            "x-extensible-enum": [
              "Unverified",
              "Verified",
              "Inconclusive",
              "Failed",
              "NotRequired",
              "ManuallyVerified"
            ]
          },
          "disposition": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "VerificationStatus": {
        "type": "string",
        "description": "Readonly Extensible, read-only lifecycle status. The x-extensible-enum values are the currently documented values, not a closed set. Clients must preserve unknown values, take no money-moving action based on them, refresh authoritative state, and route unresolved values for operational review.",
        "nullable": true,
        "readOnly": true,
        "x-extensible-enum": [
          "Unverified",
          "Verified",
          "Inconclusive",
          "Failed",
          "NotRequired",
          "ManuallyVerified"
        ]
      },
      "PaymentDeliveryAssessment": {
        "type": "object",
        "properties": {
          "assessedAt": {
            "type": "string",
            "format": "date-time"
          },
          "requiredBy": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "fundingState": {
            "type": "string"
          },
          "paymentState": {
            "type": "string"
          },
          "deadlineStatus": {
            "type": "string",
            "description": "NotRequested, AtRisk, Missed, Met, or Unconfirmed. Unconfirmed does not mean the deadline can be met."
          },
          "earliestReleaseAt": {
            "type": "string",
            "description": "Known lower bound from recorded funding holds and scheduled dispatch. This is not an arrival estimate or a release authorization.",
            "format": "date-time",
            "nullable": true
          },
          "lastRecipientCompletedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedPaymentCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "format": "int32"
          },
          "totalPaymentCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "nextStep": {
            "type": "string"
          },
          "deliveryGuaranteed": {
            "type": "boolean",
            "description": "Always false. Recorded timing evidence never guarantees arrival or authorizes releasing funds.",
            "readOnly": true
          }
        },
        "readOnly": true
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "ApiErrorResolution": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "owner": {
            "type": "string"
          },
          "retryMode": {
            "type": "string",
            "description": "Guidance only: DoNotRetryUnchanged, SameIdempotencyKey, RefreshState, Reauthenticate, RetryAfter, or CheckStatus. CheckStatus means the outcome may be unknown: inspect authoritative state before retrying. Never replace an idempotency key to retry an uncertain operation. Treat unknown modes as requiring review."
          },
          "nextAction": {
            "type": "string"
          }
        }
      },
      "DisbursementRequestPreflightPublicDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Draft preflight outcome: Blocked, InputRequired, or VerificationRequired. None authorizes sending or promises settlement. Treat unknown values as requiring review."
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestPreflightCheckPublicDto"
            }
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisbursementRequestPreflightFindingPublicDto"
            }
          }
        }
      },
      "DisbursementRequestPreflightCheckPublicDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "Passed, Blocked, Required, NotPerformed, NotAssessed, or NotApplicable. A passed evidence check only confirms locally available input; it is not a provider verification result."
          },
          "nextAction": {
            "type": "string"
          }
        }
      },
      "DisbursementRequestPreflightFindingPublicDto": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "resolutionOwner": {
            "type": "string"
          },
          "nextAction": {
            "type": "string"
          },
          "paymentReference": {
            "type": "string",
            "nullable": true
          },
          "blocksVerification": {
            "type": "boolean",
            "description": "True when this finding identifies an input or policy blocker. False for advisories. It does not replace the authoritative checks at approval, verification, and dispatch."
          }
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "OAuth 2.0 access token issued to your integration by the DirecFunds identity platform. Send it on every request as `Authorization: Bearer <token>`.",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "Address",
      "description": "A United States address used by branches and bank accounts."
    },
    {
      "name": "Audit Log",
      "description": "Read-only, company-scoped metadata for requests made by the calling integration. Request and response bodies are never exposed."
    },
    {
      "name": "Bank Account",
      "description": "A bank account serves as the source of funds for a particular disbursement."
    },
    {
      "name": "Onboarding"
    },
    {
      "name": "Branch Bank Accounts"
    },
    {
      "name": "Branch",
      "description": "An office or location belonging to the company, such as a Cincinnati or Indianapolis branch."
    },
    {
      "name": "Company",
      "description": "The business integrating with the DirecFunds API. It is created during onboarding and is read-only through this API."
    },
    {
      "name": "Disbursement",
      "description": "High level object for moving funds, contains information about the source of funds, \nthe users which are requesting and approving the funds to be moved, and the pay outs which detail each transfer. \n\nThese endpoints are the advanced granular-assembly flow. New integrations should prefer\n`POST /DisbursementRequests`, which creates the disbursement, target accounts, pay in, and pay outs\nas one aggregate command.\n\nBusiness disbursements must be among the company's requested and DirecFunds-enabled products.\nThe bundled `POST /DisbursementRequests` validation response includes\n`ProductNotEnabled` when that approval is missing. Selecting only Due diligence payments during\nregistration grants access to the Portal's buyer-funded property-payment flow after review; it\ndoes not enable these business-disbursement endpoints or require a company source account.\n\n### Bound Actions\n| Action | Description |\n|--------|---------|\n| $CreateWithLegs | Collection-level action that creates a disbursement together with its pay-in and pay-out legs in one transaction. Managed source-account pay-in legs accept `Wire` (reverse wire) or authorized `SamedayAch` debit. Standard `Ach` funding is unsupported; `Ach` and `SamedayAch` remain valid pay-out rails. |\n| $Request | Submits an initialized disbursement for approval, moving it from Initialized to Pending Approval. Required before Verify. |\n| $Verify | Verifies disbursement data and pay out targets. Names the approver, who must differ from the requester whenever the company's approval policy requires a separate approver (Two Party Approval, an amount at or above the limit, a requester without approve permission, or the Production fallback policy). |\n| $Send | Sends the disbursement to be processed. Verification is required to send. |\n| $VerifyAndSend | Combines the verify and send actions. |\n\n### Read Sub-Resources\n| Route | Description |\n|-------|---------|\n| `GET /Disbursement/{id}/Detailed` | Current aggregate plus every pay-in and pay-out leg, with each leg's payment rail, transfer status, and verification status. |\n| `GET /Disbursement/{id}/Status` | Compact read returning only the disbursement status string. Supports `ETag` / `If-None-Match`. |\n| `GET /Disbursement/{id}/Events` | Append-only transition history across the aggregate and every rail leg. Page forward with `afterEventId`. |\n| `GET /Disbursement/{id}/Readiness` | Whether Request, Verify, and Send are currently eligible, with stable blocker codes and the problem leg ids. Changes nothing. |\n\nEvery bound action supports an `X-Idempotency-Key` header (UUID v4). Production requires it on protected money operations when configured enforcement is enabled; Test follows its own environment setting. Send it in both environments. Retrying an action with the same key replays the original outcome instead of repeating the side effect.\n\nVerification Request\n```json\n{\n  \"approverUserId\": \"00000000-0000-0000-0000-000000000001\"\n}\n```\n\nVerification Response\n```json\n{\n  \"status\": \"Verified\",\n  \"message\": \"Disbursement has been verified successfully and is ready to send\"\n}\n```\n\n### Verification response and settlement\n\nHTTP 200 on granular verification can carry Failed or Inconclusive. Check status == Verified\n(or the allowed manual-evidence status) and authoritative readiness before sending. Bundled\n$VerifyAndSend returns 202 even when verification fails or is inconclusive and nothing is routed;\nread request.status, payment outcomes and allowedNextActions. 202 alone proves no settlement.\n"
    },
    {
      "name": "Disbursement Requests",
      "description": "Atomic, closing-level disbursement bundles: validate and create the full graph, approve and send it, inspect events and reconciliation, triage recipient exceptions, and manage signed webhooks. Per-recipient retry and destination replacement are reserved and capability-disabled."
    },
    {
      "name": "Integration"
    },
    {
      "name": "Pay In",
      "description": "The funding leg of a disbursement. Managed source-account pay ins support Wire (reverse wire) and SamedayAch debit with achDebitAuthorizationAccepted=true. Standard Ach funding is unsupported; Ach and SamedayAch remain available for pay outs."
    },
    {
      "name": "Payment Rails"
    },
    {
      "name": "Pay Out",
      "description": "Transfer instructions for a specific recipient and destination bank account."
    },
    {
      "name": "Phone Number",
      "description": "A United States phone number that can be associated with a branch."
    },
    {
      "name": "Reconciliation",
      "description": "Company-scoped transaction and closing-level views for matching payment-rail state, provider references, settlement timestamps, and exceptions."
    },
    {
      "name": "Test Sandbox"
    },
    {
      "name": "Target Account",
      "description": "A destination account used by a pay in or pay out."
    },
    {
      "name": "User",
      "description": "An employee profile. Ordinary User writes cannot change payment authority; use User Permissions only when permission automation is enabled for the integration."
    },
    {
      "name": "User Permissions",
      "description": "The complete payment authority for one user. This opt-in endpoint atomically replaces the branch and source-account permissions using ETag concurrency and an idempotency key."
    }
  ]
}
