> ## 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 capability > Requests a customer capability by permanent capability id. Requesting a canceled capability with a new idempotency key starts a fresh lifecycle after current eligibility and routing checks pass. For bank-backed capabilities, omitted or empty `institutions` lists select registry defaults; a non-empty list explicitly overrides defaults. When customer intake is incomplete, the capability is created in `restricted` with open tasks and durable planned application identities, while provider submission is deferred until those tasks are satisfied. Known ineligible variants fail instead of silently falling back. Send `Idempotency-Key` for every POST; the same key and body replay the original response. ## OpenAPI ````yaml /openapi.json post /v3/customers/{customerId}/capabilities/{capabilityId} 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/customers/{customerId}/capabilities/{capabilityId}: post: tags: - capabilities summary: Create capability description: >- Requests a customer capability by permanent capability id. Requesting a canceled capability with a new idempotency key starts a fresh lifecycle after current eligibility and routing checks pass. For bank-backed capabilities, omitted or empty `institutions` lists select registry defaults; a non-empty list explicitly overrides defaults. When customer intake is incomplete, the capability is created in `restricted` with open tasks and durable planned application identities, while provider submission is deferred until those tasks are satisfied. Known ineligible variants fail instead of silently falling back. Send `Idempotency-Key` for every POST; the same key and body replay the original response. operationId: postV3CustomersByCustomerIdCapabilitiesByCapabilityId 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. - schema: type: string in: path name: customerId required: true - schema: type: string in: path name: capabilityId required: true requestBody: required: true content: application/json: schema: type: object properties: institutions: type: array items: type: string description: Opaque public institution id. description: >- Public institution ids returned by `GET /v3/customers/{customerId}/capabilities/supported`. Omitted or empty `institutions` lists select applicable registry defaults; a non-empty list explicitly overrides defaults. example: - jpmorgan examples: achPooled: summary: Request pooled ACH capability value: institutions: - citibank - jpmorgan achPooledForOneInstitution: summary: Request pooled ACH for one institution value: institutions: - jpmorgan wireNamedSwipeluxUsd: summary: Request named USD wire capability value: institutions: - swipelux_usd fasterPaymentsNamedSwipeluxGbp: summary: Request named GBP Faster Payments capability value: institutions: - swipelux_gbp ippNamedSwipeluxAed: summary: Request named AED IPP capability value: institutions: - swipelux_aed responses: '200': description: Canceled capability requested again 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: anyOf: - type: object properties: id: type: string pattern: ^[a-z0-9]+(?:_[a-z0-9]+)*$ description: >- Permanent capability id, for example `ach_pooled`. `wire_pooled`/`wire_named` cover bank-wire capability requests, including provider routes that use the domestic wire network as the underlying rail. The internal rail remains a method/rail vocabulary value, not a public capability id. Open enum — values are added over time; clients must tolerate unknown values. customerId: type: string description: Customer identifier. method: enum: - ach - wire - rtp - pix - sepa - swift - spei - pse - transfers_3_0 - uaefts - faster_payments - sepa_instant - ipp - card - stablecoin_transfers description: >- Single payment method represented by this capability. Open enum — values are added over time; clients must tolerate unknown values. accountType: enum: - pooled - named nullable: true description: >- Bank account type when the capability is bank-account based. status: description: >- Capability status. Closed enum — exhaustive; additions would be a breaking change. enum: - ready statusReason: allOf: - type: string - type: number description: >- Structured reason for a non-ready capability. Ready capabilities omit this field. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this capability or one of its applications, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. applications: type: array items: type: object properties: id: type: string description: Application identifier (`apl_...`). institution: type: object required: - id - name - bic properties: id: type: string description: >- Opaque public institution id to send in `institutions`. name: type: string description: Public institution name. bic: type: string nullable: true description: BIC/SWIFT code when known. status: enum: - requested - in_review - action_required - ready - rejected - disabled - canceled description: >- Institution application status. Closed enum — exhaustive; additions would be a breaking change. statusReason: 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 status. `in_review` always returns a stored or synthesized reason; self-explanatory statuses may return null. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this application, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - institution - status - statusReason - openTaskIds - submittedAt - createdAt - updatedAt description: Institution compliance flows for this capability. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - customerId - method - accountType - status - openTaskIds - applications - submittedAt - createdAt - updatedAt - type: object properties: id: type: string pattern: ^[a-z0-9]+(?:_[a-z0-9]+)*$ description: >- Permanent capability id, for example `ach_pooled`. `wire_pooled`/`wire_named` cover bank-wire capability requests, including provider routes that use the domestic wire network as the underlying rail. The internal rail remains a method/rail vocabulary value, not a public capability id. Open enum — values are added over time; clients must tolerate unknown values. customerId: type: string description: Customer identifier. method: enum: - ach - wire - rtp - pix - sepa - swift - spei - pse - transfers_3_0 - uaefts - faster_payments - sepa_instant - ipp - card - stablecoin_transfers description: >- Single payment method represented by this capability. Open enum — values are added over time; clients must tolerate unknown values. accountType: enum: - pooled - named nullable: true description: >- Bank account type when the capability is bank-account based. status: enum: - pending - restricted - rejected - canceled description: >- Capability status. Closed enum — exhaustive; additions would be a breaking change. statusReason: type: object properties: code: type: string description: >- Stable snake_case reason code for the capability status. resolution: enum: - complete_tasks - wait - contact_support - none description: Action that can move the capability forward. message: type: string description: >- Human-readable explanation of the capability status. required: - code - resolution - message description: >- Structured reason for a non-ready capability. Ready capabilities omit this field. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this capability or one of its applications, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. applications: type: array items: type: object properties: id: type: string description: Application identifier (`apl_...`). institution: type: object required: - id - name - bic properties: id: type: string description: >- Opaque public institution id to send in `institutions`. name: type: string description: Public institution name. bic: type: string nullable: true description: BIC/SWIFT code when known. status: enum: - requested - in_review - action_required - ready - rejected - disabled - canceled description: >- Institution application status. Closed enum — exhaustive; additions would be a breaking change. statusReason: 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 status. `in_review` always returns a stored or synthesized reason; self-explanatory statuses may return null. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this application, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - institution - status - statusReason - openTaskIds - submittedAt - createdAt - updatedAt description: Institution compliance flows for this capability. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - customerId - method - accountType - status - statusReason - openTaskIds - applications - submittedAt - createdAt - updatedAt description: Capability. required: - data examples: restricted: summary: Capability awaiting customer tasks value: data: id: ach_pooled customerId: cus_7F3pL2nQ9xA5mW8kR1sT4v method: ach accountType: pooled status: restricted statusReason: code: tasks_due resolution: complete_tasks message: Additional customer information is required. openTaskIds: - tsk_8uL2nA7xQ5mR9pT4vZ1sWc applications: - id: apl_4Y9xQ8u3m2N7p6R5s1T0vZ institution: id: jpmorgan name: JPMorgan Chase bic: CHASUS33 status: in_review statusReason: code: internal_review message: The submission is under internal review. actor: swipelux retryable: true openTaskIds: - tsk_8uL2nA7xQ5mR9pT4vZ1sWc submittedAt: '2026-06-22T10:15:30.000Z' createdAt: '2026-06-22T10:15:30.000Z' updatedAt: '2026-06-22T10:15:30.000Z' submittedAt: '2026-06-22T10:15:30.000Z' createdAt: '2026-06-22T10:15:30.000Z' updatedAt: '2026-06-22T10:15:30.000Z' '201': description: Capability 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: anyOf: - type: object properties: id: type: string pattern: ^[a-z0-9]+(?:_[a-z0-9]+)*$ description: >- Permanent capability id, for example `ach_pooled`. `wire_pooled`/`wire_named` cover bank-wire capability requests, including provider routes that use the domestic wire network as the underlying rail. The internal rail remains a method/rail vocabulary value, not a public capability id. Open enum — values are added over time; clients must tolerate unknown values. customerId: type: string description: Customer identifier. method: enum: - ach - wire - rtp - pix - sepa - swift - spei - pse - transfers_3_0 - uaefts - faster_payments - sepa_instant - ipp - card - stablecoin_transfers description: >- Single payment method represented by this capability. Open enum — values are added over time; clients must tolerate unknown values. accountType: enum: - pooled - named nullable: true description: >- Bank account type when the capability is bank-account based. status: description: >- Capability status. Closed enum — exhaustive; additions would be a breaking change. enum: - ready statusReason: allOf: - type: string - type: number description: >- Structured reason for a non-ready capability. Ready capabilities omit this field. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this capability or one of its applications, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. applications: type: array items: type: object properties: id: type: string description: Application identifier (`apl_...`). institution: type: object required: - id - name - bic properties: id: type: string description: >- Opaque public institution id to send in `institutions`. name: type: string description: Public institution name. bic: type: string nullable: true description: BIC/SWIFT code when known. status: enum: - requested - in_review - action_required - ready - rejected - disabled - canceled description: >- Institution application status. Closed enum — exhaustive; additions would be a breaking change. statusReason: 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 status. `in_review` always returns a stored or synthesized reason; self-explanatory statuses may return null. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this application, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - institution - status - statusReason - openTaskIds - submittedAt - createdAt - updatedAt description: Institution compliance flows for this capability. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - customerId - method - accountType - status - openTaskIds - applications - submittedAt - createdAt - updatedAt - type: object properties: id: type: string pattern: ^[a-z0-9]+(?:_[a-z0-9]+)*$ description: >- Permanent capability id, for example `ach_pooled`. `wire_pooled`/`wire_named` cover bank-wire capability requests, including provider routes that use the domestic wire network as the underlying rail. The internal rail remains a method/rail vocabulary value, not a public capability id. Open enum — values are added over time; clients must tolerate unknown values. customerId: type: string description: Customer identifier. method: enum: - ach - wire - rtp - pix - sepa - swift - spei - pse - transfers_3_0 - uaefts - faster_payments - sepa_instant - ipp - card - stablecoin_transfers description: >- Single payment method represented by this capability. Open enum — values are added over time; clients must tolerate unknown values. accountType: enum: - pooled - named nullable: true description: >- Bank account type when the capability is bank-account based. status: enum: - pending - restricted - rejected - canceled description: >- Capability status. Closed enum — exhaustive; additions would be a breaking change. statusReason: type: object properties: code: type: string description: >- Stable snake_case reason code for the capability status. resolution: enum: - complete_tasks - wait - contact_support - none description: Action that can move the capability forward. message: type: string description: >- Human-readable explanation of the capability status. required: - code - resolution - message description: >- Structured reason for a non-ready capability. Ready capabilities omit this field. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this capability or one of its applications, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. applications: type: array items: type: object properties: id: type: string description: Application identifier (`apl_...`). institution: type: object required: - id - name - bic properties: id: type: string description: >- Opaque public institution id to send in `institutions`. name: type: string description: Public institution name. bic: type: string nullable: true description: BIC/SWIFT code when known. status: enum: - requested - in_review - action_required - ready - rejected - disabled - canceled description: >- Institution application status. Closed enum — exhaustive; additions would be a breaking change. statusReason: 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 status. `in_review` always returns a stored or synthesized reason; self-explanatory statuses may return null. openTaskIds: type: array items: type: string description: >- Ids of open tasks associated with this application, including shared customer tasks reached through an active dependency, ordered by creation time and then task id. Empty when nothing is open. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - institution - status - statusReason - openTaskIds - submittedAt - createdAt - updatedAt description: Institution compliance flows for this capability. submittedAt: type: string nullable: true description: Submitted at. createdAt: type: string description: Created at. updatedAt: type: string description: Updated at. required: - id - customerId - method - accountType - status - statusReason - openTaskIds - applications - submittedAt - createdAt - updatedAt description: Capability. required: - data examples: restricted: summary: Capability awaiting customer tasks value: data: id: ach_pooled customerId: cus_7F3pL2nQ9xA5mW8kR1sT4v method: ach accountType: pooled status: restricted statusReason: code: tasks_due resolution: complete_tasks message: Additional customer information is required. openTaskIds: - tsk_8uL2nA7xQ5mR9pT4vZ1sWc applications: - id: apl_4Y9xQ8u3m2N7p6R5s1T0vZ institution: id: jpmorgan name: JPMorgan Chase bic: CHASUS33 status: in_review statusReason: code: internal_review message: The submission is under internal review. actor: swipelux retryable: true openTaskIds: - tsk_8uL2nA7xQ5mR9pT4vZ1sWc submittedAt: '2026-06-22T10:15:30.000Z' createdAt: '2026-06-22T10:15:30.000Z' updatedAt: '2026-06-22T10:15:30.000Z' submittedAt: '2026-06-22T10:15:30.000Z' createdAt: '2026-06-22T10:15:30.000Z' updatedAt: '2026-06-22T10:15:30.000Z' '400': description: Invalid request or missing idempotency key 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 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 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 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: Customer 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 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: >- Capability already exists, idempotency conflict, or temporally unavailable variant 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 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. '422': description: Capability intent or structurally unavailable variant 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 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. '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 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. components: securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: Your Swipelux API key. Obtain this from the Swipelux Dashboard. ```` ## Related topics - [Capability created](/api-reference/webhooks/capability-created.md) - [Create quote](/api-reference/money-movement/post-v3-quotes.md) - [Create rule](/api-reference/rules/post-v3-customers-by-customer-id-rules.md) - [Create sandbox task](/api-reference/sandbox/post-v3-sandbox-tasks.md) - [Create recipient](/api-reference/recipients/post-v3-customers-by-customer-id-recipients.md)