> ## 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.

# Import an individual's Sumsub verification

> Consumes an opaque, single-use share token on an individual intake Task's actionable identity session. Configure bilateral Sumsub sharing and generate the donor token for SwipeLux clientId swipelux.com_21030. Imports matching steps against the exact process level with fresh checks, then records an ordinary verification execution. Existing webhook and polling reconciliation settle its requirements. An already bound applicant returns verification_already_started. Reading a Task does not create an applicant. Replays recheck customer, Task and session ownership; the token is never stored or logged. Until its KYB is approved, a merchant may create at most 10 Sumsub imports in any 24 hours, sandbox included.



## OpenAPI

````yaml /openapi.json post /v3/customers/{customerId}/tasks/{taskId}/verification-sessions/{verificationSessionId}/share-token
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}/verification-sessions/{verificationSessionId}/share-token:
    post:
      tags:
        - Tasks
      summary: Import an individual's Sumsub verification
      description: >-
        Consumes an opaque, single-use share token on an individual intake
        Task's actionable identity session. Configure bilateral Sumsub sharing
        and generate the donor token for SwipeLux clientId swipelux.com_21030.
        Imports matching steps against the exact process level with fresh
        checks, then records an ordinary verification execution. Existing
        webhook and polling reconciliation settle its requirements. An already
        bound applicant returns verification_already_started. Reading a Task
        does not create an applicant. Replays recheck customer, Task and session
        ownership; the token is never stored or logged. Until its KYB is
        approved, a merchant may create at most 10 Sumsub imports in any 24
        hours, sandbox included.
      operationId: importCustomerTaskShareToken
      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: verificationSessionId
          in: path
          required: true
          description: Verification session 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: Opaque donor share token; do not parse or retain its contents.
        content:
          application/json:
            schema:
              type: object
              required:
                - shareToken
              properties:
                shareToken:
                  type: string
                  minLength: 1
                  maxLength: 1024
                  x-max-utf8-bytes: 1024
                  writeOnly: true
                  description: >-
                    Opaque, single-use Sumsub share token, at most 1024 UTF-8
                    bytes. Never stored or logged.
      responses:
        '200':
          description: >-
            Session execution recorded. Pending or queued checks return
            in_review; missing steps remain action_required and can be finished
            through the same session link. GREEN or RED settle through normal
            reconciliation.
          headers:
            Idempotency-Replayed:
              description: >-
                Present with value `true` when an idempotent request is
                replayed.
              schema:
                type: string
                enum:
                  - 'true'
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
          content:
            application/json:
              schema:
                type: object
                required:
                  - verificationSessionId
                  - status
                properties:
                  verificationSessionId:
                    type: string
                    description: Imported verification session identifier.
                  status:
                    type: string
                    enum:
                      - action_required
                      - in_review
                    description: Current verification session status after import.
        '400':
          description: Invalid request body or 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
                    enum:
                      - 400
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - validation_error
                      - unknown_parameter
                    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.
                oneOf:
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - https://docs.swipelux.com/errors/validation-error
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 400
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - validation_error
                        description: Stable snake_case error code.
                      detail:
                        type: string
                        description: Actionable problem detail for legitimate callers.
                      correlationId:
                        type: string
                        description: Request correlation id. Mirrors `X-Request-Id`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: validation_error
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - https://docs.swipelux.com/errors/unknown-parameter
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 400
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - unknown_parameter
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: unknown_parameter
          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
                    enum:
                      - https://docs.swipelux.com/errors/unauthorized
                    description: Documentation URL for this stable problem code.
                  title:
                    type: string
                    description: Short human-readable problem title.
                  status:
                    type: integer
                    enum:
                      - 401
                    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`.
                  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.
                  retryable:
                    type: boolean
                    enum:
                      - false
                    description: Whether retrying the same request may succeed.
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '403':
          description: >-
            Every Task submission permission and customer ownership are
            required.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - type
                  - title
                  - status
                  - code
                  - detail
                  - correlationId
                  - retryable
                properties:
                  type:
                    type: string
                    format: uri
                    enum:
                      - https://docs.swipelux.com/errors/forbidden
                    description: Documentation URL for this stable problem code.
                  title:
                    type: string
                    description: Short human-readable problem title.
                  status:
                    type: integer
                    enum:
                      - 403
                    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`.
                  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.
                  retryable:
                    type: boolean
                    enum:
                      - false
                    description: Whether retrying the same request may succeed.
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '404':
          description: The scoped Task or session was 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
                    enum:
                      - 404
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - task_not_found
                      - not_found
                    description: Stable snake_case error code.
                  detail:
                    type: string
                    description: Actionable problem detail for legitimate callers.
                  correlationId:
                    type: string
                    description: Request correlation id. Mirrors `X-Request-Id`.
                  transferId:
                    type: string
                    description: >-
                      Existing transfer that consumed the quote. Present on
                      `quote_already_executed`.
                  retryable:
                    type: boolean
                    description: Whether retrying the same request may succeed.
                  errors:
                    type: array
                    description: Field-level validation errors.
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - pointer
                        - code
                        - message
                      properties:
                        pointer:
                          type: string
                          description: JSON Pointer into the request body.
                        code:
                          type: string
                          description: Machine-readable field error code.
                        message:
                          type: string
                          description: Human-readable field error message.
                  statusReason:
                    type: object
                    description: >-
                      Structured reason for a state conflict when the failed
                      operation depends on the resource's current status.
                    required:
                      - code
                      - message
                      - actor
                      - retryable
                    properties:
                      code:
                        type: string
                        description: >-
                          Stable snake_case reason code from the documented
                          catalog.
                        example: sanctions_screening_failed
                      message:
                        type: string
                        description: Human-readable explanation of the current status.
                      actor:
                        type: string
                        enum:
                          - customer
                          - developer
                          - provider
                          - network
                          - swipelux
                        description: >-
                          Party whose action moves the resource forward: the end
                          customer, the developer integrating the API, the
                          underlying provider, payment network or rail, or
                          Swipelux. Closed enum — exhaustive; additions would be
                          a breaking change.
                      retryable:
                        type: boolean
                        description: >-
                          Whether retrying the blocked operation without
                          changing its inputs or state may succeed.
                  reviewAnswer:
                    type: string
                    nullable: true
                    description: Verification review answer when supplied by the verifier.
                  capabilities:
                    type: array
                    minItems: 1
                    items:
                      type: string
                    description: Capability ids that satisfy the failed operation.
                  blockingResources:
                    type: array
                    minItems: 1
                    description: >-
                      Customer resources that must be resolved before the
                      requested operation can proceed, sorted by type and id.
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - type
                        - id
                        - requiredAction
                      properties:
                        type:
                          type: string
                          enum:
                            - account
                            - transfer
                        id:
                          type: string
                          description: Public id of the blocking resource.
                        requiredAction:
                          type: string
                          enum:
                            - archive_account
                            - cancel_transfer
                            - wait_for_transfer
                            - resolve_transfer
                          description: Next action required before retrying the operation.
                oneOf:
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - https://docs.swipelux.com/errors/task-not-found
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 404
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: task_not_found
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - https://docs.swipelux.com/errors/not-found
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 404
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - 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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: not_found
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '409':
          description: >-
            Verification already started, the Task or session is ineligible, or
            the idempotency key conflicts.
          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
                    enum:
                      - 409
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - verification_already_started
                      - verification_session_not_allowed
                      - kyc_process_conflict
                      - idempotency_conflict
                      - idempotency_request_in_progress
                    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.
                oneOf:
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/verification-already-started
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 409
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - verification_already_started
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: verification_already_started
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/verification-session-not-allowed
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 409
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - verification_session_not_allowed
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: verification_session_not_allowed
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/kyc-process-conflict
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 409
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - kyc_process_conflict
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: kyc_process_conflict
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/idempotency-conflict
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 409
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - idempotency_conflict
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: idempotency_conflict
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/idempotency-request-in-progress
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 409
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - idempotency_request_in_progress
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - true
                        description: Whether retrying the same request may succeed.
                    title: idempotency_request_in_progress
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '422':
          description: >-
            Sumsub rejected the share token. Generate a fresh token for SwipeLux
            and retry with a new key. Business verification must be approved
            before this action on a required live space.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - share_token_rejected
                      - merchant_kyb_not_approved
                    description: Stable snake_case error code.
                anyOf:
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/share-token-rejected
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 422
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - share_token_rejected
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: share_token_rejected
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/merchant-kyb-not-approved
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 422
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - merchant_kyb_not_approved
                        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`.
                      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.
                    title: merchant_kyb_not_approved
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '429':
          description: >-
            Too many requests from this credential, merchant or client IP. Retry
            after the number of seconds in the Retry-After header.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - type
                  - title
                  - status
                  - code
                  - detail
                  - correlationId
                  - retryable
                properties:
                  type:
                    type: string
                    format: uri
                    enum:
                      - https://docs.swipelux.com/errors/rate-limited
                    description: Documentation URL for this stable problem code.
                  title:
                    type: string
                    description: Short human-readable problem title.
                  status:
                    type: integer
                    enum:
                      - 429
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - rate_limited
                    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`.
                  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.
                  retryable:
                    type: boolean
                    enum:
                      - true
                    description: Whether retrying the same request may succeed.
        '500':
          description: The import could not be completed.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - type
                  - title
                  - status
                  - code
                  - detail
                  - correlationId
                  - retryable
                properties:
                  type:
                    type: string
                    format: uri
                    enum:
                      - https://docs.swipelux.com/errors/internal-error
                    description: Documentation URL for this stable problem code.
                  title:
                    type: string
                    description: Short human-readable problem title.
                  status:
                    type: integer
                    enum:
                      - 500
                    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`.
                  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.
                  retryable:
                    type: boolean
                    enum:
                      - true
                    description: Whether retrying the same request may succeed.
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
        '503':
          description: >-
            Verification import is unavailable. If retryable is false, continue
            through the normal verification session without resubmitting the
            share token.
          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
                    enum:
                      - 503
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - kyc_provider_unavailable
                      - kyc_configuration_unavailable
                      - kyc_level_configuration_invalid
                    description: Stable snake_case error code.
                  detail:
                    type: string
                    description: Actionable problem detail for legitimate callers.
                  correlationId:
                    type: string
                    description: Request correlation id. Mirrors `X-Request-Id`.
                  transferId:
                    type: string
                    description: >-
                      Existing transfer that consumed the quote. Present on
                      `quote_already_executed`.
                  retryable:
                    type: boolean
                    description: Whether retrying the same request may succeed.
                  errors:
                    type: array
                    description: Field-level validation errors.
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - pointer
                        - code
                        - message
                      properties:
                        pointer:
                          type: string
                          description: JSON Pointer into the request body.
                        code:
                          type: string
                          description: Machine-readable field error code.
                        message:
                          type: string
                          description: Human-readable field error message.
                  statusReason:
                    type: object
                    description: >-
                      Structured reason for a state conflict when the failed
                      operation depends on the resource's current status.
                    required:
                      - code
                      - message
                      - actor
                      - retryable
                    properties:
                      code:
                        type: string
                        description: >-
                          Stable snake_case reason code from the documented
                          catalog.
                        example: sanctions_screening_failed
                      message:
                        type: string
                        description: Human-readable explanation of the current status.
                      actor:
                        type: string
                        enum:
                          - customer
                          - developer
                          - provider
                          - network
                          - swipelux
                        description: >-
                          Party whose action moves the resource forward: the end
                          customer, the developer integrating the API, the
                          underlying provider, payment network or rail, or
                          Swipelux. Closed enum — exhaustive; additions would be
                          a breaking change.
                      retryable:
                        type: boolean
                        description: >-
                          Whether retrying the blocked operation without
                          changing its inputs or state may succeed.
                  reviewAnswer:
                    type: string
                    nullable: true
                    description: Verification review answer when supplied by the verifier.
                  capabilities:
                    type: array
                    minItems: 1
                    items:
                      type: string
                    description: Capability ids that satisfy the failed operation.
                  blockingResources:
                    type: array
                    minItems: 1
                    description: >-
                      Customer resources that must be resolved before the
                      requested operation can proceed, sorted by type and id.
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - type
                        - id
                        - requiredAction
                      properties:
                        type:
                          type: string
                          enum:
                            - account
                            - transfer
                        id:
                          type: string
                          description: Public id of the blocking resource.
                        requiredAction:
                          type: string
                          enum:
                            - archive_account
                            - cancel_transfer
                            - wait_for_transfer
                            - resolve_transfer
                          description: Next action required before retrying the operation.
                oneOf:
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/kyc-provider-unavailable
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 503
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - kyc_provider_unavailable
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                          - true
                        description: Whether retrying the same request may succeed.
                    title: kyc_provider_unavailable
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/kyc-configuration-unavailable
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 503
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - kyc_configuration_unavailable
                        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`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: kyc_configuration_unavailable
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                      - retryable
                    properties:
                      type:
                        type: string
                        format: uri
                        enum:
                          - >-
                            https://docs.swipelux.com/errors/kyc-level-configuration-invalid
                        description: Documentation URL for this stable problem code.
                      title:
                        type: string
                        description: Short human-readable problem title.
                      status:
                        type: integer
                        enum:
                          - 503
                        description: HTTP status code.
                      code:
                        type: string
                        enum:
                          - kyc_level_configuration_invalid
                        description: Stable snake_case error code.
                      detail:
                        type: string
                        description: Actionable problem detail for legitimate callers.
                      correlationId:
                        type: string
                        description: Request correlation id. Mirrors `X-Request-Id`.
                      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.
                      retryable:
                        type: boolean
                        enum:
                          - false
                        description: Whether retrying the same request may succeed.
                    title: kyc_level_configuration_invalid
          headers:
            Cache-Control:
              description: Prevents storage of sensitive task data.
              schema:
                type: string
                enum:
                  - no-store
              example: no-store
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Swipelux API key. Obtain this from the Swipelux Dashboard.

````

## Related topics

- [KYC verification levels](https://docs.swipelux.com/knowledge-base/individual-onboarding/verification-levels.md)
- [Capabilities and tasks](https://docs.swipelux.com/integration/onboarding/capabilities-and-requirements.md)
- [Swipelux API changelog and release notes](https://docs.swipelux.com/api-reference/versioning/changelog.md)
- [Jurisdiction Framework](https://docs.swipelux.com/knowledge-base/compliance/jurisdictions-and-availability.md)
- [Individual onboarding overview](https://docs.swipelux.com/knowledge-base/individual-onboarding/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.