> ## 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 a task submission > Creates one complete immutable attempt for the task's current remediation round. ## OpenAPI ````yaml /openapi.json post /v3/customers/{customerId}/tasks/{taskId}/submissions 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}/tasks/{taskId}/submissions: post: tags: - Task submissions summary: Create a task submission description: >- Creates one complete immutable attempt for the task's current remediation round. operationId: createCustomerTaskSubmission parameters: - name: customerId in: path required: true description: Customer identifier. schema: type: string minLength: 1 - name: taskId in: path required: true description: Task identifier. schema: type: string minLength: 1 - 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 description: >- Complete current-round answers and task revision. The entire JSON request body is limited to 524288 bytes. x-max-body-bytes: 524288 content: application/json: schema: $ref: '#/components/schemas/SubmissionRequest' examples: submission: $ref: '#/components/examples/SubmissionRequest' responses: '201': description: Current authorized submission detail. content: application/json: schema: $ref: '#/components/schemas/SubmissionDetailResponse' headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store Idempotency-Replayed: description: >- Present with value `true` when an idempotent request is replayed. schema: type: string enum: - 'true' '400': description: The submission request is invalid. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - invalid_document_reference - unknown_parameter - 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 enum: - false description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '401': description: Authentication is required. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - unauthorized 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 enum: - false description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '403': description: Every submission permission is required. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - forbidden 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 enum: - false description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '404': description: The task was not found. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - task_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 enum: - false description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '409': description: The task changed, profile conflicts, or idempotency failed. content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/TaskChangedProblem' - $ref: '#/components/schemas/AbsenceConflictsWithProfileProblem' - $ref: '#/components/schemas/IdempotencyConflictProblem' - $ref: '#/components/schemas/IdempotencyRequestInProgressProblem' headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '413': description: The submission request body is too large. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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_body_too_large 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 enum: - false description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '422': description: One or more current actionable requirements are missing. content: application/problem+json: schema: $ref: '#/components/schemas/TaskSubmissionIncompleteProblem' headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store '500': description: The submission could not be created. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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 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 enum: - true description: Static retry guidance for this problem code. 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. headers: Cache-Control: description: Prevents storage of sensitive task data. schema: type: string enum: - no-store example: no-store components: schemas: SubmissionRequest: type: object additionalProperties: false required: - taskRevision - answers properties: taskRevision: type: integer minimum: 1 answers: type: array minItems: 1 maxItems: 100 x-max-total-document-references: 128 items: $ref: '#/components/schemas/SubmissionAnswerEntry' SubmissionDetailResponse: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/SubmissionDetail' TaskChangedProblem: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable - currentRevision - currentStatus - taskId - taskUrl 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: - task_changed description: Stable problem 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 enum: - false description: Retrying the stale request cannot 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. currentRevision: type: integer minimum: 1 currentStatus: type: string enum: - action_required - in_review - satisfied - rejected - canceled description: Current task status. taskId: type: string taskUrl: type: string format: uri-reference example: /v3/customers/cus_01JABC/tasks/tsk_01JXYZ AbsenceConflictsWithProfileProblem: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable - profilePointer 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: - absence_conflicts_with_profile description: Stable problem 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 enum: - false description: Static retry guidance for this problem code. 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. profilePointer: type: string pattern: ^/ description: Canonical field that already has a value. IdempotencyConflictProblem: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - idempotency_conflict description: Stable problem 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 enum: - false description: Static retry guidance for this problem code. 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. IdempotencyRequestInProgressProblem: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable 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: - idempotency_request_in_progress description: Stable problem 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 enum: - true description: Static retry guidance for this problem code. 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. TaskSubmissionIncompleteProblem: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId - retryable - missingRequirementIds 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: - task_submission_incomplete description: Stable problem 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 enum: - false description: Static retry guidance for this problem code. 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. missingRequirementIds: type: array items: type: string description: Ordered actionable requirement ids still missing. SubmissionAnswerEntry: type: object additionalProperties: false required: - requirementId - answer properties: requirementId: type: string alternativeKey: type: string answer: $ref: '#/components/schemas/SubmissionAnswer' SubmissionDetail: type: object additionalProperties: false required: - id - taskId - customerId - remediationRound - taskRevision - outcome - answers - submittedAt - updatedAt properties: id: type: string taskId: type: string customerId: type: string remediationRound: type: integer minimum: 0 taskRevision: type: integer minimum: 1 outcome: type: string enum: - in_review - accepted - changes_requested - rejected description: Closed submission review outcome. answers: type: array items: $ref: '#/components/schemas/SubmissionSnapshotAnswerEntry' reviewFeedback: $ref: '#/components/schemas/ReviewFeedback' submittedAt: type: string format: date-time updatedAt: type: string format: date-time SubmissionAnswer: oneOf: - $ref: '#/components/schemas/ProfileSubmissionAnswer' - $ref: '#/components/schemas/TextSubmissionAnswer' - $ref: '#/components/schemas/DateSubmissionAnswer' - $ref: '#/components/schemas/SingleSelectSubmissionAnswer' - $ref: '#/components/schemas/MultiSelectSubmissionAnswer' - $ref: '#/components/schemas/BooleanSubmissionAnswer' - $ref: '#/components/schemas/AttestationSubmissionAnswer' - $ref: '#/components/schemas/DocumentSubmissionAnswer' - $ref: '#/components/schemas/ResourceReferenceSubmissionAnswer' - $ref: '#/components/schemas/AbsenceSubmissionAnswer' discriminator: propertyName: type SubmissionSnapshotAnswerEntry: type: object additionalProperties: false required: - requirementId - answer properties: requirementId: type: string alternativeKey: type: string answer: $ref: '#/components/schemas/SubmissionSnapshotAnswer' ReviewFeedback: type: object additionalProperties: false required: - code - message properties: code: type: string description: Stable actionable feedback code. message: type: string description: Redacted developer-facing review feedback. ProfileSubmissionAnswer: type: object additionalProperties: false required: - type - value properties: type: type: string enum: - profile description: Submission answer discriminator. value: anyOf: - type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. - type: boolean - $ref: '#/components/schemas/SubmissionProfileAddress' - $ref: '#/components/schemas/SubmissionProfileRegistration' - $ref: '#/components/schemas/SubmissionProfileFlows' - $ref: '#/components/schemas/SubmissionProfileOwnership' - type: array uniqueItems: true items: type: string enum: - business_expenses - charitable_donations - cross_border_remittance - ecommerce - family_support - investment - payroll - operate_company - personal_expenses - purchase_goods_and_services - receive_freelance_payments - receive_payments - receive_salary - tax_optimization - tax_payments - third_party_money_transmission - treasury_management - wealth_preservation - other - type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ - type: array uniqueItems: true items: $ref: '#/components/schemas/SubmissionProfileTaxIdentifier' x-max-serialized-utf8-bytes: 131072 x-max-depth: 12 x-max-aggregate-entries: 512 TextSubmissionAnswer: type: object additionalProperties: false required: - type - value properties: type: type: string enum: - text description: Submission answer discriminator. value: type: string minLength: 1 maxLength: 16384 DateSubmissionAnswer: type: object additionalProperties: false required: - type - value properties: type: type: string enum: - date description: Submission answer discriminator. value: type: string format: date description: A real Gregorian calendar date from year 0001 through 9999. SingleSelectSubmissionAnswer: type: object additionalProperties: false required: - type - value properties: type: type: string enum: - single_select description: Submission answer discriminator. value: type: string minLength: 1 MultiSelectSubmissionAnswer: type: object additionalProperties: false required: - type - values properties: type: type: string enum: - multi_select description: Submission answer discriminator. values: type: array minItems: 1 uniqueItems: true items: type: string BooleanSubmissionAnswer: type: object additionalProperties: false required: - type - value properties: type: type: string enum: - boolean description: Submission answer discriminator. value: type: boolean AttestationSubmissionAnswer: type: object additionalProperties: false required: - type - accepted properties: type: type: string enum: - attestation description: Submission answer discriminator. accepted: type: boolean enum: - true description: Attestations can only be submitted as accepted. acceptedAt: type: string format: date-time endUserIpAddress: type: string endUserUserAgent: type: string minLength: 1 maxLength: 1024 DocumentSubmissionAnswer: type: object additionalProperties: false required: - type - documentIds properties: type: type: string enum: - document description: Submission answer discriminator. documentIds: type: array minItems: 1 maxItems: 32 uniqueItems: true items: type: string pattern: ^doc_ ResourceReferenceSubmissionAnswer: type: object additionalProperties: false required: - type - relatedPartyId properties: type: type: string enum: - resource_reference description: Submission answer discriminator. relatedPartyId: type: string pattern: ^rp_ AbsenceSubmissionAnswer: type: object additionalProperties: false required: - type - reason properties: type: type: string enum: - absence description: Submission answer discriminator. reason: type: string enum: - not_available - not_applicable - does_not_exist - other description: Why the requested value cannot be provided. explanation: type: string oneOf: - properties: reason: type: string enum: - not_available - not_applicable - does_not_exist description: Absence reason that does not require an explanation. - required: - explanation properties: reason: type: string enum: - other description: Absence reason that requires an explanation. explanation: type: string minLength: 1 pattern: \S SubmissionSnapshotAnswer: oneOf: - $ref: '#/components/schemas/ProfileSubmissionAnswer' - $ref: '#/components/schemas/TextSubmissionAnswer' - $ref: '#/components/schemas/DateSubmissionAnswer' - $ref: '#/components/schemas/SingleSelectSubmissionAnswer' - $ref: '#/components/schemas/MultiSelectSubmissionAnswer' - $ref: '#/components/schemas/BooleanSubmissionAnswer' - $ref: '#/components/schemas/AttestationSubmissionSnapshot' - $ref: '#/components/schemas/DocumentSubmissionAnswer' - $ref: '#/components/schemas/ResourceReferenceSubmissionAnswer' - $ref: '#/components/schemas/AbsenceSubmissionAnswer' discriminator: propertyName: type SubmissionProfileAddress: type: object additionalProperties: false required: [] properties: streetLine1: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. streetLine2: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. city: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. state: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. postalCode: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. country: type: string pattern: ^[A-Z]{2}$ minProperties: 1 SubmissionProfileRegistration: type: object additionalProperties: false required: [] properties: jurisdiction: $ref: '#/components/schemas/SubmissionProfileJurisdiction' number: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. formationDate: type: string format: date description: A real Gregorian calendar date from year 0001 through 9999. minProperties: 1 SubmissionProfileFlows: type: object additionalProperties: false required: [] properties: payin: $ref: '#/components/schemas/SubmissionProfileFlowDirection' payout: $ref: '#/components/schemas/SubmissionProfileFlowDirection' SubmissionProfileOwnership: type: object additionalProperties: false required: [] properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ anyOf: - required: - declared properties: declared: type: boolean enum: - true - required: - directPercentage - required: - indirectPercentage - required: - effectivePercentage SubmissionProfileTaxIdentifier: type: object additionalProperties: false required: - type - country - value properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - other typeDescription: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. country: type: string pattern: ^[A-Z]{2}$ value: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. oneOf: - not: required: - typeDescription properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - required: - typeDescription properties: type: type: string enum: - other AttestationSubmissionSnapshot: type: object additionalProperties: false required: - type - accepted - text - version properties: type: type: string enum: - attestation description: Submission answer discriminator. accepted: type: boolean enum: - true description: Attestations can only be submitted as accepted. acceptedAt: type: string format: date-time endUserIpAddress: type: string endUserUserAgent: type: string minLength: 1 maxLength: 1024 text: type: string minLength: 1 description: Immutable text presented for acceptance. version: type: string minLength: 1 description: Immutable attestation text version. SubmissionProfileJurisdiction: type: object additionalProperties: false required: - country properties: country: type: string pattern: ^[A-Z]{2}$ region: type: string minLength: 1 maxLength: 256 pattern: ^(?!\s)(?!.*\s$)[^\u0000-\u001F\u007F-\u009F]+$ description: >- A 1-256 character string without leading/trailing whitespace or control characters. SubmissionProfileFlowDirection: type: object additionalProperties: false required: - firstParty - thirdParty properties: firstParty: type: boolean thirdParty: type: boolean examples: SubmissionRequest: value: taskRevision: 3 answers: - requirementId: req_01JSOURCE answer: type: profile value: Revenue from annual software subscriptions. - requirementId: req_01JIDENTITY alternativeKey: passport answer: type: document documentIds: - doc_01JPASS securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: Your Swipelux API key. Obtain this from the Swipelux Dashboard. ```` ## Related topics - [List task submissions](/api-reference/task-submissions/list-customer-task-submissions.md) - [Get task submission detail](/api-reference/task-submissions/get-customer-task-submission.md) - [Review sandbox task submission](/api-reference/sandbox/post-v3-sandbox-tasks-by-task-id-review.md) - [Create sandbox task](/api-reference/sandbox/post-v3-sandbox-tasks.md) - [Create capability](/api-reference/capabilities/post-v3-customers-by-customer-id-capabilities-by-capability-id.md)