---
title: "Get user"
method: GET
path: "/core/users/me"
tags: ["Users"]
---

# Get user

`GET /core/users/me`

## Request

- Base URL: `https://api.enterprise.sandbox.uphold.com`
- URL: `https://api.enterprise.sandbox.uphold.com/core/users/me`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/core/oauth2/token` scopes: `core.users:read`
- TypeScript: <https://skmtc.dev/uphold/apis/core-api/docs/core/users/me/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve an existing user.

## Headers

- `X-On-Behalf-Of` string
- `X-Uphold-User-Ip` union
  - string, ipv4
  - string, ipv6
- `X-Uphold-User-Agent` string
- `X-Uphold-User-Origin` string
- `X-Uphold-User-Country` string
- `X-Uphold-User-Subdivision` string
- `X-Uphold-User-City` string

## Response `200`

User retrieved.

- object
  - `user` union, required
    - object
      - `id` string, uuid, required: The id of the user.
      - `type` 'individual', required: The type of the user.
      - `email` string, email, required: The email address.
      - `fullName` string: The full legal name.
      - `birthdate` string: The date of birth.
      - `primaryCitizenship` string, required: The citizenship country.
      - `citizenshipCountry` string: The citizenship country. Deprecated in favor of `primaryCitizenship`.
      - `address` object, required: The address of residency.
        - `country` string, required: The country of the address.
        - `subdivision` string: The subdivision of the address.
        - `city` string: The city of the address.
        - `line1` string: The first line of the address.
        - `line2` string: The second line of the address.
        - `postalCode` string: The postal code of the address.
      - `phone` object: The phone number.
        - `number` string, required: The E.164 formatted phone number.
        - `country` string, required: The country code of the phone number.
      - `createdAt` string, date-time, required: The time at which the user was created.
      - `updatedAt` string, date-time, required: The time at which the user was last updated.
    - object
      - `id` string, uuid, required: The id of the user.
      - `type` 'business', required: The type of the user.
      - `email` string, email, required: The email address.
      - `legalEntityType` 'government-entity' | 'non-profit' | 'partnership' | 'private-limited-company' | 'public-company' | 'sole-proprietor', required: Business legal form/classification.
      - `legalEntityName` string: The full legal entity name.
      - `formationDate` string, date: The date of the business formation.
      - `industry` union
        - union: The industry classification of the business. Allowed `subSector` values depend on the selected `sector`.
          - object
            - `sector` 'financial-institutions-and-money-services', required
            - `subSector` 'money-transmitters' | 'remittance-services' | 'vasp-casp' | 'payment-processors' | 'fx-providers' | 'other-regulated-nbfi'
          - object
            - `sector` 'crypto-services-and-products', required
            - `subSector` 'exchanges' | 'custodial-wallet-providers' | 'non-custodial-wallet-providers' | 'miners' | 'nft-platforms' | 'defi-projects'
          - object
            - `sector` 'personal-investment-vehicles', required
            - `subSector` 'private-trusts' | 'roth-ira' | 'llc-spe-for-holding-assets'
          - object
            - `sector` 'family-offices-and-investment-funds', required
            - `subSector` 'family-offices' | 'pooled-investment-vehicles' | 'private-investment-funds'
          - object
            - `sector` 'professional-services', required
            - `subSector` 'law-firms' | 'accounting-firms' | 'consultants' | 'company-formation-or-secretarial-services'
          - object
            - `sector` 'technology-and-software', required
            - `subSector` 'it-services' | 'saas' | 'gaming-studios' | 'cybersecurity' | 'data-analytics' | 'ai-firms'
          - object
            - `sector` 'ecommerce-and-retail', required
            - `subSector` 'online-marketplaces' | 'merchants' | 'wholesalers' | 'direct-to-consumer-retailers'
          - object
            - `sector` 'real-estate-and-property-management', required
            - `subSector` 'brokerages' | 'property-developers' | 'management-companies' | 'investment-vehicles'
          - object
            - `sector` 'high-value-goods-and-luxury-dealers', required
            - `subSector` 'jewelry' | 'art' | 'precious-metals' | 'automobiles' | 'auction-houses'
        - object
          - `sector` 'other', required
          - `otherSector` string: Free-form description of the sector and sub-sector.
      - `legalIds` object[]: The legal identifiers of the business, usually government-issued.
        - `type` 'tax-id' | 'registration-id', required: The type of the legal identifier.
        - `id` string, required: The legal identifier value.
        - `country` string, required: The country of the legal identifier.
      - `registrationAddress` object: The registration address of the business. Always available for non-legacy business users.
        - `country` string, required: The country of the address.
        - `subdivision` string: The subdivision of the address.
        - `city` string: The city of the address.
        - `line1` string: The first line of the address.
        - `line2` string: The second line of the address.
        - `postalCode` string: The postal code of the address.
      - `operatingAddress` Address, required: The address information.
        - `country` string: The country of the address.
        - `subdivision` string: The subdivision of the address.
        - `city` string: The city of the address.
        - `line1` string: The first line of the address.
        - `line2` string: The second line of the address.
        - `postalCode` string: The postal code of the address.
      - `name` string: The legal name of the business.
      - `address` object, required: The address of the business (operating address).
        - `country` string, required: The country of the address.
        - `subdivision` string: The subdivision of the address.
        - `city` string: The city of the address.
        - `line1` string: The first line of the address.
        - `line2` string: The second line of the address.
        - `postalCode` string: The postal code of the address.
      - `createdAt` string, date-time, required: The time at which the user was created.
      - `updatedAt` string, date-time, required: The time at which the user was last updated.

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `429`: Too Many Requests.

---

[API](https://skmtc.dev/uphold/apis/core-api.md) - [All operations](https://skmtc.dev/uphold/apis/core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/uphold/apis/core-api/revisions/6c663575c57a?raw)