> ## 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 related parties

> Returns active related-party summaries for the customer with cursor pagination. Individual customers have no related parties and return an empty page. Summaries carry roles, derived display name, and ownership, voting, and control indicator booleans; archived parties are excluded.



## OpenAPI

````yaml /openapi.json get /v3/customers/{customerId}/related-parties
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}/related-parties:
    get:
      tags:
        - customers
      summary: List related parties
      description: >-
        Returns active related-party summaries for the customer with cursor
        pagination. Individual customers have no related parties and return an
        empty page. Summaries carry roles, derived display name, and ownership,
        voting, and control indicator booleans; archived parties are excluded.
      operationId: getV3CustomersByCustomerIdRelated-parties
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
        - 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: Related-party summaries
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - nextCursor
                  - hasMore
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RelatedPartySummary'
                  nextCursor:
                    type: string
                    nullable: true
                  hasMore:
                    type: boolean
              examples:
                activeParties:
                  summary: Active related-party summaries
                  value:
                    data:
                      - id: rp_01JDIRECTOR
                        customerId: cus_01JBUSINESS
                        partyType: person
                        roles:
                          - director
                        displayName: Amina Diallo
                        hasOwnership: false
                        hasVotingRights: false
                        hasControl: false
                        createdAt: '2026-07-15T18:20:00.000Z'
                        updatedAt: '2026-07-15T18:20:00.000Z'
                    nextCursor: null
                    hasMore: false
        '400':
          description: Invalid or unknown related-party list query parameter.
          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
                    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.
                  - 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.
        '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: Customer not found, foreign, or archived.
          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:
  schemas:
    RelatedPartySummary:
      type: object
      additionalProperties: false
      description: >-
        Field-selected related-party list item without contact, tax, address,
        document, or answer values.
      required:
        - id
        - customerId
        - partyType
        - roles
        - displayName
        - hasOwnership
        - hasVotingRights
        - hasControl
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          pattern: ^rp_[0-9A-Za-z]+$
          description: Immutable rp_ related-party identifier.
        customerId:
          type: string
          pattern: ^cus_[0-9A-Za-z]+$
        partyType:
          type: string
          enum:
            - person
            - entity
        roles:
          type: array
          items:
            type: string
          uniqueItems: true
        displayName:
          type: string
          nullable: true
        hasOwnership:
          type: boolean
        hasVotingRights:
          type: boolean
        hasControl:
          type: boolean
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key

````

## Related topics

- [Errors and retries](/integration/errors.md)
- [Archive related party](/api-reference/customers/delete-v3-customers-by-customer-id-related-parties-by-related-party-id.md)
- [Get related party](/api-reference/customers/get-v3-customers-by-customer-id-related-parties-by-related-party-id.md)
- [Create related party](/api-reference/customers/post-v3-customers-by-customer-id-related-parties.md)
- [Update related party](/api-reference/customers/patch-v3-customers-by-customer-id-related-parties-by-related-party-id.md)