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

# List user contacts

> Retrieves all contacts stored for a user by their ID.



## OpenAPI

````yaml /raas/swagger-partner.json get /user/contacts/{userToken}
openapi: 3.0.0
info:
  title: ''
  version: 0.0.1
servers:
  - url: https://raas-partner-cv.nomas.cash/v1
security: []
paths:
  /user/contacts/{userToken}:
    get:
      tags:
        - Contacts
      summary: List user contacts
      description: Retrieves all contacts stored for a user by their ID.
      operationId: listContacts
      parameters:
        - description: User identifier token.
          in: path
          name: userToken
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            **200 — OK.** Contact list returned.


            **Scenarios for this response**:


            | Scenario | How to reproduce | Typical `code` / body |

            |------------|------------------|------------------------|

            | List contacts | Valid `userToken` that resolves to a stored user.
            | `ContactInfo[]` (may be empty). |


            See also [Full scenario
            matrix](/raas/guides/testing-sandbox#list-contacts-scenario-matrix).
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ContactInfo'
                type: array
              example:
                firstName: Hugo
                lastName: Tru
                phone: '+19166014999'
                email: javier+1@leapfinancial.com
                countryCode: US
                alias: Hugo
        '401':
          description: >-
            **401 — Unauthorized.**


            **Scenarios for this response**:


            | Scenario | How to reproduce | Typical `code` / body |

            |------------|------------------|------------------------|

            | Missing / bad API key | Omit `api_key` or send an invalid key
            (gateway / auth layer). | Environment-specific error body |


            See also [Full scenario
            matrix](/raas/guides/testing-sandbox#list-contacts-scenario-matrix).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                reason: Missing or invalid API key
        '404':
          description: >-
            **404 — Not found.**


            **Scenarios for this response**:


            | Scenario | How to reproduce | Typical `code` / body |

            |------------|------------------|------------------------|

            | User not resolved | Path `userToken` is not a stored user id (or
            user was removed). | `ERROR_USER_NOT_FOUND` |


            See also [Full scenario
            matrix](/raas/guides/testing-sandbox#list-contacts-scenario-matrix).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                reason: User not found
        '500':
          description: >-
            **500 — Internal server error.**


            **Scenarios for this response**:


            | Scenario | How to reproduce | Typical `code` / body |

            |------------|------------------|------------------------|

            | Storage failure | Contact store throws (rare). |
            `ERROR_INTERNAL_SERVER_ERROR` |


            See also [Full scenario
            matrix](/raas/guides/testing-sandbox#list-contacts-scenario-matrix).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                reason: An unhandled error has occurred
      security:
        - api_key:
            - partner
            - partner_send
components:
  schemas:
    ContactInfo:
      description: Row returned by `GET /user/contacts/{userToken}` (partner list).
      properties:
        phone:
          type: string
          description: |-
            Contact phone number in **E.164** form (leading `+`).
            Example: `+19166020018`.
        firstName:
          type: string
          description: Contact first name
        lastName:
          type: string
          description: Contact last name
        email:
          type: string
          description: Contact email
        countryCode:
          type: string
          description: |-
            Contact country code

            ISO 3166-1 alpha-2.
        alias:
          type: string
          description: Contact alias
        id:
          type: string
          description: Contact ID
      required:
        - phone
      type: object
      additionalProperties: false
    ErrorResponse:
      properties:
        detail:
          type: string
        code:
          type: string
        reason:
          type: string
      required:
        - code
        - reason
      type: object
  securitySchemes:
    api_key:
      type: apiKey
      name: api_key
      in: header

````