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

# List customer applications

> Lists every institution application case of this customer with the capability keys requested against it and the keys its approval covers. A case is shared: one approval at an institution can cover several capabilities. Retained historical cases identify their successor through supersededByApplicationId.



## OpenAPI

````yaml /openapi.json get /v3/customers/{customerId}/applications
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}/applications:
    get:
      tags:
        - capabilities
      summary: List customer applications
      description: >-
        Lists every institution application case of this customer with the
        capability keys requested against it and the keys its approval covers. A
        case is shared: one approval at an institution can cover several
        capabilities. Retained historical cases identify their successor through
        supersededByApplicationId.
      operationId: getV3CustomersByCustomerIdApplications
      parameters:
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: Opaque cursor returned as `nextCursor` from the previous page.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Maximum number of records to return. Defaults to 25.
        - name: updatedAfter
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: >-
            Return only records updated at or after this RFC 3339 timestamp. Use
            it to recover from missed webhooks by replaying a window of changes.
        - schema:
            type: string
          in: path
          name: customerId
          required: true
      responses:
        '200':
          description: Applications returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Application identifier (`apl_...`).
                        status:
                          enum:
                            - requested
                            - in_review
                            - action_required
                            - ready
                            - rejected
                            - disabled
                            - canceled
                          description: >-
                            Institution application status. Closed enum —
                            exhaustive; additions would be a breaking change.
                        statusReason:
                          type: object
                          properties:
                            code:
                              type: string
                              description: >-
                                Stable snake_case reason code from the
                                documented catalog.
                            message:
                              type: string
                              description: >-
                                Human-readable explanation of the current
                                status.
                            actor:
                              enum:
                                - customer
                                - developer
                                - provider
                                - network
                                - swipelux
                              description: >-
                                Party whose action moves the resource forward:
                                the end customer, the developer integrating the
                                API, the underlying provider, payment network or
                                rail, or Swipelux. Closed enum — exhaustive;
                                additions would be a breaking change.
                            retryable:
                              type: boolean
                              description: >-
                                Whether retrying the blocked operation without
                                changing its inputs or state may succeed.
                          required:
                            - code
                            - message
                            - actor
                            - retryable
                          nullable: true
                          description: >-
                            Structured reason for the current status.
                            `in_review` always returns a stored or synthesized
                            reason; self-explanatory statuses may return null.
                        openTaskIds:
                          type: array
                          items:
                            type: string
                          description: >-
                            Ids of open tasks associated with this application,
                            including shared customer tasks reached through an
                            active dependency, ordered by creation time and then
                            task id. Empty when nothing is open.
                        submittedAt:
                          type: string
                          nullable: true
                          description: Submitted at.
                        createdAt:
                          type: string
                          description: Created at.
                        updatedAt:
                          type: string
                          description: Updated at.
                        scope:
                          enum:
                            - named
                            - provider_pooled
                            - platform
                          nullable: true
                          description: >-
                            Case scope. `named` cases are approved at one
                            institution; `provider_pooled` and `platform` cases
                            have none. Null only for a retained historical case
                            that has not been classified.
                        institution:
                          type: object
                          properties:
                            id:
                              type: string
                              description: >-
                                Opaque public institution id to send in
                                `institutions`.
                            name:
                              type: string
                              description: Public institution name.
                            bic:
                              type: string
                              nullable: true
                              description: BIC/SWIFT code when known.
                          required:
                            - id
                            - name
                            - bic
                          description: >-
                            The institution of a named case. Absent for
                            provider-pooled and platform scope.
                        requestedScope:
                          type: array
                          items:
                            type: object
                            properties:
                              capabilityKey:
                                type: string
                                description: Capability key requested against this case.
                              requestedAt:
                                type: string
                                description: First request time for this key.
                            required:
                              - capabilityKey
                              - requestedAt
                          description: >-
                            Capability keys requested against this case, in
                            request order. Recorded before any approval; never
                            removed.
                        coverage:
                          type: array
                          items:
                            type: object
                            properties:
                              capabilityKey:
                                type: string
                                description: Capability key this case's approval covers.
                              grantedAt:
                                type: string
                                description: When coverage was recorded.
                              source:
                                enum:
                                  - approval
                                  - operations
                                  - succession
                                  - migration
                                description: How coverage was established.
                            required:
                              - capabilityKey
                              - grantedAt
                              - source
                          description: >-
                            Capability keys the case's approval covers. Present
                            only once the case is ready for that key; never
                            removed.
                        probes:
                          type: array
                          items:
                            type: object
                            properties:
                              capabilityKey:
                                type: string
                                description: The pooled capability key tested.
                              status:
                                enum:
                                  - pending
                                  - passed
                                  - retryable
                                  - remediable
                                  - terminal
                                description: >-
                                  Current method-scoped usability result,
                                  independent of compliance approval.
                              reason:
                                type: string
                                nullable: true
                                description: >-
                                  Public-safe reason for a missing or
                                  unsuccessful probe; null when passed.
                            required:
                              - capabilityKey
                              - status
                              - reason
                          description: >-
                            Current pooled-method probes. Named keys never
                            require a probe.
                        generation:
                          type: number
                          nullable: true
                          description: >-
                            Case generation; a successor opened under a replaced
                            approval contract increments it.
                        predecessorApplicationId:
                          type: string
                          nullable: true
                          description: The case this one succeeded, when any.
                        supersededByApplicationId:
                          type: string
                          nullable: true
                          description: >-
                            The current case that superseded this retained one,
                            when any.
                      required:
                        - id
                        - status
                        - statusReason
                        - openTaskIds
                        - submittedAt
                        - createdAt
                        - updatedAt
                        - scope
                        - requestedScope
                        - coverage
                        - probes
                        - generation
                        - predecessorApplicationId
                        - supersededByApplicationId
                    description: Applications of the customer.
                  nextCursor:
                    type: string
                    nullable: true
                    description: >-
                      Cursor for the next page, or null when there is no next
                      page.
                  hasMore:
                    type: boolean
                    description: Whether another page is available.
                required:
                  - data
                  - nextCursor
                  - hasMore
        '400':
          description: Invalid request.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - type
                  - title
                  - status
                  - code
                  - detail
                  - correlationId
                properties:
                  type:
                    type: string
                    format: uri
                    description: Documentation URL for this stable problem code.
                  title:
                    type: string
                    description: Short human-readable problem title.
                  status:
                    type: integer
                    enum:
                      - 400
                    description: HTTP status code.
                  code:
                    type: string
                    enum:
                      - 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
                    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
                    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.
                  - type: object
                    additionalProperties: false
                    required:
                      - type
                      - title
                      - status
                      - code
                      - detail
                      - correlationId
                    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.
        '401':
          description: Authentication 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.
        '403':
          description: Insufficient permissions.
          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.
        '404':
          description: Resource not found.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - type
                  - title
                  - status
                  - code
                  - detail
                  - correlationId
                properties:
                  type:
                    type: string
                    format: uri
                    enum:
                      - https://docs.swipelux.com/errors/customer-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:
                      - customer_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.
        '500':
          description: Internal server error.
          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.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Swipelux API key. Obtain this from the Swipelux Dashboard.

````

## Related topics

- [List capability applications](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-applications.md)
- [List application history](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-applications-by-application-id-history.md)
- [List customers](/api-reference/customers/get-v3-customers.md)
- [List customer tasks](/api-reference/tasks/list-customer-tasks.md)
- [List customer document metadata](/api-reference/documents/get-v3-customers-by-customer-id-documents.md)