> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Read all destinations

> This endpoint reads all destinations.



## OpenAPI

````yaml /openapi/api-production.yaml get /destinations
openapi: 3.1.0
info:
  version: 1.0.0
  title: Lumx API
  description: >-
    A cross-border banking API with instant settlements and unmatched liquidity,
    powered by stablecoins.
servers:
  - url: https://api.lumx.io
  - url: https://api-sandbox.lumx.io
security: []
paths:
  /destinations:
    get:
      tags:
        - Destinations
      summary: Read all destinations
      description: This endpoint reads all destinations.
      parameters:
        - name: size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Number of destinations to return per page.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            Cursor for pagination. Use the nextCursor or previousCursor from the
            previous response to get the next or previous page.
        - name: customerId
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Filter destinations by customer's unique identifier.
          example: 3c90c3cc-0d44-4b50-8888-8dd25736052a
      responses:
        '200':
          description: Destinations successfully retrieved.
          content:
            application/json:
              examples:
                Destination:
                  value:
                    data:
                      - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                        customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                        name: Lumx Brazil Operations Account
                        type: EXTERNAL
                        rail: PIX
                        currency: BRL
                        identifier:
                          keyType: CNPJ
                          keyValue: 42.887.120/0001-00
                        holder:
                          type: BUSINESS
                          relationship: SELF
                          legalName: Lumx S.A
                          taxId: 42.887.120/0001-00
                          incorporationDate: '2020-01-01'
                          email: hello@lumx.io
                          address:
                            line1: Rua Voluntarios da Patria 89
                            city: Rio de Janeiro
                            state: RJ
                            postalCode: 22270-000
                            country: BRA
                          verification:
                            status: APPROVED
                            level: BASIC
                        createdAt: '2025-10-16T12:30:00.000Z'
                        updatedAt: '2025-10-16T12:30:00.000Z'
                    pagination:
                      size: 25
                      total: 1
                      hasNextPage: false
                      hasPreviousPage: false
                      nextCursor: null
                      previousCursor: null
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: An array containing all destinations.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Destination's unique identifier.
                          example: e80d3137-eddd-4791-b9b8-6e36b289f284
                        customerId:
                          type: string
                          description: Customer's unique identifier.
                          format: uuid
                          example: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                        name:
                          type: string
                          description: Destination's display name.
                        type:
                          type: string
                          enum:
                            - EXTERNAL
                          description: Destination's type.
                        rail:
                          type: string
                          description: Destination's payment rail.
                          enum:
                            - PIX
                            - SWIFT
                            - SEPA
                            - ACH
                            - FEDWIRE
                            - SPEI
                        currency:
                          type: string
                          description: Destination's currency.
                        identifier:
                          type: object
                          description: Destination's identifier.
                        bank:
                          type: object
                          description: Bank information.
                        holder:
                          type: object
                          description: Destination's holder.
                          properties:
                            type:
                              type: string
                              enum:
                                - BUSINESS
                                - INDIVIDUAL
                              description: Holder's type.
                            relationship:
                              type: string
                              enum:
                                - SELF
                                - HOLDING_COMPANY
                                - SUBSIDIARY_COMPANY
                                - BRANCH_OFFICE
                                - BUSINESS_PARTNER
                                - SUPPLIER
                                - CUSTOMER
                                - CREDITOR
                                - DEBTOR
                                - FRANCHISEE
                                - FRIEND
                                - RELATIVE
                                - EMPLOYEE
                              description: Holder's relationship to customer.
                            legalName:
                              type: string
                              description: >-
                                Holder's legal name. Required for business
                                holders.
                            name:
                              type: string
                              description: >-
                                Holder's full name. Required for individual
                                holders.
                            taxId:
                              type: string
                              description: Holder's tax ID.
                            incorporationDate:
                              type: string
                              format: date
                              description: Holder's incorporation date.
                            birthDate:
                              type: string
                              format: date
                              description: Holder's birth date.
                            email:
                              type: string
                              format: email
                              description: Holder's email address.
                            address:
                              $ref: '#/components/schemas/DestinationAddress'
                            verification:
                              type: object
                              description: Holder verification information.
                              properties:
                                status:
                                  type: string
                                  description: Verification status.
                                level:
                                  type: string
                                  description: Verification level.
                        intermediary:
                          type: object
                          description: Intermediary bank information.
                        createdAt:
                          type: string
                          format: date-time
                          description: Creation date and time (UTC).
                        updatedAt:
                          type: string
                          format: date-time
                          description: Last update date and time (UTC).
                  pagination:
                    type: object
                    description: Pagination metadata for the response.
                    properties:
                      size:
                        type: integer
                        description: Number of items per page.
                        example: 25
                      total:
                        type: integer
                        description: Total number of items available.
                        example: 1
                      hasNextPage:
                        type: boolean
                        description: Whether more items are available after this page.
                        example: false
                      hasPreviousPage:
                        type: boolean
                        description: Whether items are available before this page.
                        example: false
                      nextCursor:
                        type: string
                        format: uuid
                        nullable: true
                        description: >-
                          Cursor to fetch the next page. `null` when
                          `hasNextPage` is false.
                        example: null
                      previousCursor:
                        type: string
                        format: uuid
                        nullable: true
                        description: >-
                          Cursor to fetch the previous page. `null` when
                          `hasPreviousPage` is false.
                        example: null
      security:
        - apiKey: []
components:
  schemas:
    DestinationAddress:
      type: object
      description: Holder's address.
      properties:
        line1:
          type: string
          description: Address line 1.
          example: 123 Main Street
        line2:
          type: string
          description: Address line 2.
          example: Apt 4B
        city:
          type: string
          description: Address city.
          example: Frankfurt
        state:
          type: string
          description: Address state.
          example: HE
        postalCode:
          type: string
          description: Address postal code.
          example: '60311'
        country:
          type: string
          description: Address country code (ISO 3166-1 alpha-3).
          example: DEU
      required:
        - line1
        - city
        - state
        - postalCode
        - country
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````