> ## Documentation Index > Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt > Use this file to discover all available pages before exploring further. # Create transfer (executes a quote) > Executes the selected quote without intentionally re-pricing it. Execution can still fail validation, balance, destination, rail, or provider checks. ## OpenAPI ````yaml /openapi.json post /v3/transfers openapi: 3.1.0 info: title: Swipelux API version: 3.1.0 servers: - url: https://platform.swipelux.com description: Production and sandbox; environment selected by API key security: - apiKey: [] tags: - name: customers x-displayName: Customers description: >- Create, list, update, export, and archive individual and business customers and their related parties. - name: capabilities x-displayName: Capabilities description: >- Discover, request, inspect, and cancel customer capabilities and their institution applications. - name: accounts x-displayName: Accounts description: Create, inspect, update, and archive customer accounts. - name: recipients x-displayName: Recipients description: Create third-party recipients and their payout destinations. - name: Tasks x-displayName: Tasks description: Inspect customer, capability, application, account, and transfer tasks. - name: Task submissions x-displayName: Task submissions description: Submit and inspect immutable answers to customer tasks. - name: documents x-displayName: Documents description: Upload and inspect customer documents used in task submissions. - name: money-movement x-displayName: Money movement description: Create quotes, execute quote-backed transfers, and inspect transfer state. - name: rules x-displayName: Rules description: >- Standing instructions that act on incoming funds. A rule watches a custodial wallet account (`trigger`) and, when funds become available on it, transfers them to a target (`action`) — most commonly a sweep to a non-custodial wallet destination. Rules match at the account credit, not at the deposit rail: fiat deposits settle into the issued bank account's settlement wallet account, so a rule on that wallet account catches ACH/SEPA/SWIFT deposits, stablecoin deposits, and internal transfers alike. The action target reuses the money-movement vocabulary (`account` for the customer's own accounts, `destination` for recipient destinations). At most one non-archived rule may watch a given trigger account. Statuses: `active ⇄ paused → archived` — pause and resume through PATCH, archive (terminal) through DELETE. - name: sandbox x-displayName: Sandbox description: Simulate supported account, task, capability, and transfer outcomes. - name: institutions x-displayName: Institutions description: List institutions referenced by capabilities and applications. - name: webhooks x-displayName: Webhooks description: Configure webhook endpoints and inspect delivery activity. externalDocs: description: Swipelux Documentation url: https://docs.swipelux.com paths: /v3/transfers: post: tags: - money-movement summary: Create transfer (executes a quote) description: >- Executes the selected quote without intentionally re-pricing it. Execution can still fail validation, balance, destination, rail, or provider checks. operationId: postV3Transfers parameters: - name: Idempotency-Key in: header required: true schema: type: string minLength: 1 maxLength: 255 example: idem_20260626_0001 description: >- Required for effectful v3 requests (POST, PATCH, PUT, DELETE). Reuse the same key with the same body to replay the cached response. requestBody: required: true content: application/json: schema: type: object required: - quoteId properties: quoteId: type: string pattern: ^quo_[a-zA-Z0-9]+$ example: quo_6dV8xN2pQ4rT7mA9sL1kBc externalId: type: string minLength: 1 maxLength: 255 description: >- Merchant-supplied correlation reference echoed on reads and filterable on GET /v3/transfers. Not required to be unique; independent of the quote's externalId. example: your-transfer-ref-123 memo: type: string minLength: 1 maxLength: 140 description: Free-text memo stored on the transfer resource. example: Invoice 118 supportingDocuments: type: array maxItems: 10 items: type: string pattern: ^doc_[a-zA-Z0-9]+$ description: >- Up to 10 document ids previously uploaded for this customer and linked to the transfer. example: - doc_4rT7mA9sL1kBc6dV8xN2pQ examples: quoted: summary: Execute transfer value: quoteId: quo_6dV8xN2pQ4rT7mA9sL1kBc withContext: summary: Execute transfer with correlation and stored context value: quoteId: quo_6dV8xN2pQ4rT7mA9sL1kBc externalId: your-transfer-ref-123 memo: Invoice 118 supportingDocuments: - doc_4rT7mA9sL1kBc6dV8xN2pQ responses: '201': description: Transfer created headers: Idempotency-Replayed: description: >- Present with value `true` when an idempotent request is replayed. schema: type: string enum: - 'true' content: application/json: schema: type: object properties: data: type: object properties: id: type: string origin: enum: - quoted - inbound_deposit description: >- How the transfer was created. `quoted` comes from a v3 quote; `inbound_deposit` comes from reconciliation. Open enum — values are added over time; clients must tolerate unknown values. quoteId: type: string description: >- Quote id. Always present for `quoted` transfers and absent for `inbound_deposit` transfers. customerId: type: string capabilityId: type: string description: >- Capability id when a capability applies. Absent for inbound deposits that do not map to a capability. openTaskIds: type: array items: type: string description: >- Ids of transfer-scoped tasks with status `action_required` or `in_review`, ordered by creation time and id. Empty when nothing is open. institutionId: type: string description: >- Public institution id echoed from the quote when the backing bank capability has a single institution. externalId: type: string method: type: string description: >- Movement method derived from the capability for quoted transfers or normalized from the receiving rail for inbound deposits. Open enum — values are added over time; clients must tolerate unknown values. direction: enum: - fiat_to_stablecoin - stablecoin_to_fiat - stablecoin_move description: >- Transfer direction. Closed enum — exhaustive; additions would be a breaking change. state: enum: - awaiting_funds - processing - action_required - completed - failed - canceled description: >- Public transfer state. `processing` covers funds received through settlement. `action_required` is projected when an otherwise in-flight transfer has open transfer tasks. `canceled` is projected when an unfunded deposit window expires. Closed enum — exhaustive; additions would be a breaking change. stateDetail: type: object properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. message: type: string description: Human-readable explanation of the current status. actor: enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. required: - code - message - actor - retryable nullable: true description: >- Structured reason for the current state. Nullable on happy-path states; required for action_required and other non-terminal blocking/failure states. amounts: type: object properties: in: type: object properties: amount: type: string currency: type: string network: enum: - polygon - ethereum - base - arbitrum - optimism - bsc - avalanche description: >- Blockchain network for a crypto leg. Absent for fiat legs and uncatalogued networks. Blockchain network id. Open enum — values are added over time; clients must tolerate unknown values. required: - amount - currency out: type: object properties: amount: type: string currency: type: string network: enum: - polygon - ethereum - base - arbitrum - optimism - bsc - avalanche description: >- Blockchain network for a crypto leg. Absent for fiat legs and uncatalogued networks. Blockchain network id. Open enum — values are added over time; clients must tolerate unknown values. required: - amount - currency settled: type: object properties: amount: type: string currency: type: string required: - amount - currency description: Actually delivered amount; present once completed. required: - in - out fees: type: array items: type: object properties: beneficiary: anyOf: - enum: - developer - enum: - service description: >- Fee beneficiary. Closed enum — exhaustive; additions would be a breaking change. amount: type: string currency: type: string rule: type: object required: - fixed - bips properties: fixed: type: string bips: type: number required: - beneficiary - amount - currency description: >- Applied fee snapshot, using the same shape as the quote fee lines. source: anyOf: - type: object properties: type: enum: - external required: - type - type: object properties: type: enum: - account id: type: string description: >- Source account for stablecoin-funded movements. required: - type - id destination: anyOf: - type: object properties: type: enum: - account id: type: string pattern: ^acc_[a-zA-Z0-9]+$ required: - type - id - type: object properties: type: enum: - destination id: type: string pattern: ^dst_[a-zA-Z0-9]+$ required: - type - id references: type: object properties: transactionHash: type: string traceNumber: type: string description: >- Provider payment tracking reference, such as an ACH trace number or wire reference. Absent when unavailable. imad: type: string uetr: type: string explorerUrl: type: string description: >- Block-explorer link for the crypto leg, derived from the wallet network. Absent when the network has no catalogued explorer. returnedTransferId: type: string nullable: true description: Return-movement id; currently always null. required: - returnedTransferId memo: type: string supportingDocuments: type: array items: type: string instructions: anyOf: - type: object properties: type: enum: - bank method: enum: - ach - wire - rtp - sepa - swift - spei - transfers_3_0 - uaefts - faster_payments description: >- Bank instruction method. Open enum — values are added over time; clients must tolerate unknown values. amount: type: object properties: amount: type: string currency: type: string required: - amount - currency accountHolderName: type: string bankName: type: string details: type: object additionalProperties: type: string description: >- Per-method banking coordinates in camelCase: routingNumber/accountNumber/accountType (ach, wire, rtp), iban/bic (sepa, uaefts), swiftCode/accountNumber (swift), sortCode/accountNumber (faster_payments), clabe (spei), cbu (transfers_3_0). reference: type: object properties: value: type: string required: type: boolean description: >- Whether the deposit must carry this reference to be matched. Pooled accounts match deposits by reference; named virtual accounts match by account number. required: - value - required description: Payment reference to include with the deposit. localAmount: type: object properties: amount: type: string currency: type: string required: - amount - currency description: >- Amount in the local settlement currency when the rail settles in a currency different from the quoted in amount. expiresAt: type: string required: - type - method - amount - details - type: object properties: type: enum: - code method: enum: - pix description: >- Code instruction method. Open enum — values are added over time; clients must tolerate unknown values. amount: type: object properties: amount: type: string currency: type: string required: - amount - currency code: type: string description: >- Copyable payment code the customer pastes into their banking app. localAmount: type: object properties: amount: type: string currency: type: string required: - amount - currency expiresAt: type: string required: - type - method - amount - code - type: object properties: type: enum: - redirect method: enum: - pse description: >- Redirect instruction method. Open enum — values are added over time; clients must tolerate unknown values. amount: type: object properties: amount: type: string currency: type: string required: - amount - currency url: type: string description: >- Hosted payment page the customer completes the payment on. localAmount: type: object properties: amount: type: string currency: type: string required: - amount - currency expiresAt: type: string required: - type - amount - url nullable: true description: >- Deposit instructions, discriminated by `type`. `null` for payout-side transfers, which are funded from the source account. timestamps: type: object properties: createdAt: type: string updatedAt: type: string fundsReceivedAt: type: string nullable: true description: Currently always null. completedAt: type: string nullable: true description: Currently always null. failedAt: type: string nullable: true description: Currently always null. returnedAt: type: string nullable: true description: Currently always null. settledAt: type: string nullable: true description: Currently always null. required: - createdAt - updatedAt - fundsReceivedAt - completedAt - failedAt - returnedAt - settledAt required: - id - origin - customerId - openTaskIds - method - direction - state - stateDetail - amounts - fees - source - destination - references - instructions - timestamps required: - data examples: awaitingFunds: summary: Fiat to stablecoin transfer awaiting the deposit value: data: id: tr_6dV8xN2pQ4rT7mA9sL1kBc origin: quoted quoteId: quo_6dV8xN2pQ4rT7mA9sL1kBc customerId: cus_7F3pL2nQ9xA5mW8kR1sT4v capabilityId: ach_pooled openTaskIds: [] institutionId: jpmorgan externalId: your-transfer-ref-123 method: ach direction: fiat_to_stablecoin state: awaiting_funds stateDetail: null amounts: in: amount: '150.00' currency: USD out: amount: '145.00' currency: USDC network: base fees: - beneficiary: developer amount: '0.88' currency: USDC rule: fixed: '0.50' bips: 25 - beneficiary: service amount: '4.12' currency: USDC source: type: external destination: type: account id: acc_3eG7xN2pQ4rT8mA1sL6dVc references: returnedTransferId: null memo: Invoice 118 instructions: type: bank method: ach amount: amount: '150.00' currency: USD accountHolderName: Swipelux FBO Customer bankName: JPMorgan Chase details: routingNumber: '021000021' accountNumber: '123456789' accountType: checking reference: value: SWX-7F3P required: true timestamps: createdAt: '2026-06-25T12:01:00.000Z' updatedAt: '2026-06-25T12:01:00.000Z' fundsReceivedAt: null completedAt: null failedAt: null returnedAt: null settledAt: null processing: summary: Stablecoin to fiat transfer processing value: data: id: tr_9zK4pQ8rT2mA7sL1dV6xNc origin: quoted quoteId: quo_9zK4pQ8rT2mA7sL1dV6xNc customerId: cus_7F3pL2nQ9xA5mW8kR1sT4v capabilityId: ach_pooled openTaskIds: [] institutionId: jpmorgan method: ach direction: stablecoin_to_fiat state: processing stateDetail: null amounts: in: amount: '150.00' currency: USDC network: base out: amount: '145.00' currency: USD fees: - beneficiary: developer amount: '0.88' currency: USDC rule: fixed: '0.50' bips: 25 - beneficiary: service amount: '4.12' currency: USDC source: type: account id: acc_base123 destination: type: account id: acc_7mA9sL1kBc6dV8xN2pQ4rT references: transactionHash: >- 0x3f5a1c9d2e8b7a6f4c1d0e9b8a7f6c5d4e3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f explorerUrl: >- https://basescan.org/tx/0x3f5a1c9d2e8b7a6f4c1d0e9b8a7f6c5d4e3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f returnedTransferId: null instructions: null timestamps: createdAt: '2026-06-25T12:01:00.000Z' updatedAt: '2026-06-25T12:06:00.000Z' fundsReceivedAt: null completedAt: null failedAt: null returnedAt: null settledAt: null completed: summary: Completed stablecoin move with settled amount value: data: id: tr_4mT8xN2pQ7rV6sL1dZ9yPa origin: quoted quoteId: quo_4mT8xN2pQ7rV6sL1dZ9yPa customerId: cus_7F3pL2nQ9xA5mW8kR1sT4v capabilityId: stablecoin_transfers openTaskIds: [] method: stablecoin_transfers direction: stablecoin_move state: completed stateDetail: null amounts: in: amount: '1.234567' currency: USDC network: base out: amount: '1.234567' currency: USDC network: base settled: amount: '1.234567' currency: USDC fees: - beneficiary: service amount: '0.00' currency: USD source: type: account id: acc_base123 destination: type: destination id: dst_8xN2pQ4rT7mA9sL1kBc6dV references: transactionHash: >- 0x9d8c7b6a5f4e3d2c1b0a9f3f5a1c9d2e8b7a6f4c1d0e9b8a7f6c5d4e3b2a1f0e explorerUrl: >- https://basescan.org/tx/0x9d8c7b6a5f4e3d2c1b0a9f3f5a1c9d2e8b7a6f4c1d0e9b8a7f6c5d4e3b2a1f0e returnedTransferId: null instructions: null timestamps: createdAt: '2026-06-25T12:01:00.000Z' updatedAt: '2026-06-25T12:03:00.000Z' fundsReceivedAt: null completedAt: null failedAt: null returnedAt: null settledAt: null '400': description: Invalid request. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - validation_error description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '401': description: Authentication required. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - request_failed description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '403': description: Insufficient permissions. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - request_failed description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '404': description: Resource not found. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - not_found - quote_not_found - transfer_not_found description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '409': description: Request conflict. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - account_unavailable - account_not_ready - capability_not_ready - idempotency_conflict - insufficient_balance - quote_already_executed - quote_destination_missing - quote_expired - rail_not_ready description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. examples: capabilityNotReady: summary: Capability is not ready value: type: https://docs.swipelux.com/errors/capability-not-ready title: Capability Not Ready status: 409 code: capability_not_ready detail: Capability is not ready to use. correlationId: cor_01JMM23TRANSFERERRORS retryable: false idempotencyConflict: summary: Idempotency key conflict value: type: https://docs.swipelux.com/errors/idempotency-conflict title: Idempotency Conflict status: 409 code: idempotency_conflict detail: Idempotency-Key was already used with a different request. correlationId: cor_01JMM23TRANSFERERRORS retryable: false quoteAlreadyExecuted: summary: Quote already executed value: type: https://docs.swipelux.com/errors/quote-already-executed title: Quote Already Executed status: 409 code: quote_already_executed detail: This quote was already executed by another request. correlationId: cor_01JMM23TRANSFERERRORS retryable: false transferId: tr_6dV8xN2pQ4rT7mA9sL1kBc quoteDestinationMissing: summary: Quote destination missing value: type: https://docs.swipelux.com/errors/quote-destination-missing title: Quote Destination Missing status: 409 code: quote_destination_missing detail: >- Quote cannot be executed because its destination was not stored. correlationId: cor_01JMM23TRANSFERERRORS retryable: false quoteExpired: summary: Quote expired value: type: https://docs.swipelux.com/errors/quote-expired title: Quote Expired status: 409 code: quote_expired detail: >- The quote's expiresAt deadline passed; create a new quote and execute it. correlationId: cor_01JMM23TRANSFERERRORS retryable: false '422': description: Request cannot be processed. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - developer_fee_invalid - recipient_destination_invalid - supporting_document_not_found description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. examples: supportingDocumentNotFound: summary: Supporting document not found value: type: >- https://docs.swipelux.com/errors/supporting-document-not-found title: Supporting Document Not Found status: 422 code: supporting_document_not_found detail: One or more supporting documents were not found. correlationId: cor_01JMM23TRANSFERERRORS retryable: false errors: - pointer: /supportingDocuments/0 code: not_found message: The document was not found for this customer. '500': description: Internal server error. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - internal_error - quote_direction_invalid - quote_mode_invalid - transfer_execution_failed - transfer_state_invalid description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. examples: transferExecutionFailed: summary: Transfer execution failed value: type: https://docs.swipelux.com/errors/transfer-execution-failed title: Transfer Execution Failed status: 500 code: transfer_execution_failed detail: >- The quoted transfer could not be executed. Contact support with the correlation id. correlationId: cor_01JMM23TRANSFERERRORS retryable: false components: securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: Your Swipelux API key. Obtain this from the Swipelux Dashboard. ```` ## Related topics - [Quotes and transfers](/integration/quotes-and-transfers.md) - [Receive funds](/integration/receive-funds.md) - [Create quote](/api-reference/money-movement/post-v3-quotes.md) - [Quickstart](/integration/quickstart.md) - [Send funds](/integration/send-funds.md)