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

# Get User Details

> Fetch user's details, including KYC and Bank Account status

**Query parameters**

Exactly one of `user_uuid`, `client_user_id`, `email`, or `phone` must be provided. Passing multiple will return an error.

**Response field values**

| Field | Possible Values |
| --- | --- |
| `kyc_status` | `Verified`, `Unverified` |




## OpenAPI

````yaml openapi-v2.json GET /api/v2/user
openapi: 3.1.0
info:
  title: Saber Money API (v2)
  version: v2
  description: >-
    ## Authentication


    There is no standalone API-key auth — every request must be **signed**. An
    API key by itself authenticates nothing. Each call requires four headers
    together: `X-Api-Key` (your key), `X-Signature` (HMAC-SHA256 of `apiKey +
    timestamp` — or `apiKey + timestamp + userId` when `X-User-Id` is required —
    keyed with your API secret), `X-Timestamp` (unix seconds), and
    `X-Request-Id` (any unique string per request). The signature must be
    computed by a client script; there is no way to derive it by hand. Use the
    HMAC Generator flow to compute valid values for manual testing.


    ## Common Authentication Errors


    - **Invalid Client ID**: {"error_code":6092,"message":"X-Client-Id
    invalid","success":false}

    - **Invalid Secret**: {"error_code":6090,"message":"invalid
    secret","success":false}

    - **Timestamp (Older than 10 secs)**:
    {"errors":{"error_code":6093,"text":"timestamp expired"},"success":false}
servers:
  - url: https://api.saber.money
security: []
paths:
  /api/v2/user:
    get:
      tags:
        - User Operations
      summary: Get User Details
      description: >
        Fetch user's details, including KYC and Bank Account status


        **Query parameters**


        Exactly one of `user_uuid`, `client_user_id`, `email`, or `phone` must
        be provided. Passing multiple will return an error.


        **Response field values**


        | Field | Possible Values |

        | --- | --- |

        | `kyc_status` | `Verified`, `Unverified` |
      operationId: get-user-details-v2
      parameters:
        - name: user_uuid
          in: query
          required: false
          description: User UUID to look up.
          schema:
            type: string
            description: User UUID to look up.
        - name: client_user_id
          in: query
          required: false
          description: Client-specific user ID.
          schema:
            type: string
            description: Client-specific user ID.
        - name: email
          in: query
          required: false
          description: User's email address.
          schema:
            type: string
            description: User's email address.
        - name: phone
          in: query
          required: false
          description: User's phone number in E.164 format (e.g. `+919876543210`).
          schema:
            type: string
            description: User's phone number in E.164 format (e.g. `+919876543210`).
        - name: X-Api-Key
          in: header
          required: true
          description: Your API key (configured in credentials)
          schema:
            type: string
        - name: X-Signature
          in: header
          required: true
          description: >-
            HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256
            of `apiKey + timestamp` (or `apiKey + timestamp + userId` when
            X-User-Id is required), keyed with your API secret. The HMAC
            Generator flow computes this for you.
          schema:
            type: string
        - name: X-Timestamp
          in: header
          required: true
          description: >-
            Unix timestamp in seconds (auto-generated) Unix seconds, e.g.
            `Math.floor(Date.now() / 1000)`. Must match the timestamp used in
            the X-Signature computation.
          schema:
            type: string
        - name: X-Request-Id
          in: header
          required: true
          description: >-
            Unique request identifier (auto-generated) Any unique string per
            request, e.g. a UUID.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      user_uuid:
                        type: string
                      client_user_id:
                        type: string
                      kyc_status:
                        type: string
                        enum:
                          - Verified
                          - Unverified
                      bank_accounts:
                        type: array
                        items:
                          type: object
                      is_nri:
                        type: boolean
                      email:
                        type: string
                      phone:
                        type: string
                      phone_country:
                        type: string
                      kyc_country:
                        type: string
              example:
                success: true
                data:
                  user_uuid: b3e77842-af94-449e-bd29-187ce54dd535
                  client_user_id: ''
                  kyc_status: Verified
                  bank_accounts:
                    - bank_id: 8dd23876-1588-4ba0-b813-b4e274bb5d76
                      account_number: 12XXXXX5678
                      account_holder_name: Utkarsh
                      routing_code: '123456'
                      routing_type: IFSC
                      status: APPROVED
                      is_default: false
                      message: Bank account validated successfully
                      created_at: '2026-03-13T09:08:06Z'
                      updated_at: '2026-03-13T09:08:07Z'
                      is_nre: false
                      country: IND
                  is_nri: false
                  email: ''
                  phone: '+910078678200'
                  phone_country: IND
                  kyc_country: IND
        '400':
          description: >-
            `102001`: missing required parameters; `102003`: invalid email
            format; `102004`: invalid phone format; `102008`: multiple search
            parameters provided, please provide only one
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type:
                            - integer
                            - string
                        text:
                          type: string
              example:
                success: false
                errors:
                  - code: 6092
                    text: Invalid X-Api-Key or X-Client-Id
        '401':
          description: '`6092`: Invalid X-Api-Key or X-Client-Id'
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type:
                            - integer
                            - string
                        text:
                          type: string
              example:
                success: false
                errors:
                  - code: 6092
                    text: Invalid X-Api-Key or X-Client-Id
        '404':
          description: '`102007`: user not found for client'
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type:
                            - integer
                            - string
                        text:
                          type: string
              example:
                success: false
                errors:
                  - code: 6092
                    text: Invalid X-Api-Key or X-Client-Id
        '500':
          description: '`109999`: Something went wrong!'
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type:
                            - integer
                            - string
                        text:
                          type: string
              example:
                success: false
                errors:
                  - code: 6092
                    text: Invalid X-Api-Key or X-Client-Id

````

## Related topics

- [Frequently Asked Questions](/faq.md)
- [Get Beneficiary Details](/api-reference/onramp/get-beneficiary-details.md)
- [Get Sell Transaction Details](/api-reference/offramp/from-user-wallet/get-sell-transaction-details.md)
- [Get External Buy Detail](/api-reference/onramp/to-external-wallet/get-external-buy-detail.md)
- [Get Pool Buy Transaction Details](/api-reference/onramp/to-pool-wallet/get-pool-buy-transaction-details.md)
