---
title: "GET /users/{userID}"
method: GET
path: "/users/{userID}"
tags: ["users"]
---

# GET /users/{userID}

`GET /users/{userID}`

Get a user by id

## Path parameters

- `userID` string, uuid, required

## Response `200`

Successful response

- User
  - `id` string, uuid
  - `email` string, email
  - `name` string — The user's full name
  - `firstName` string — The user's first name
  - `lastName` string — The user's last name
  - `role` string — The user's current role
  - `isAdmin` boolean — Whether or not the user is an administrator
  - `groups` object[]
    - `id` string, uuid — The group id
    - `name` string — The group name
  - `onboardingResponses` object[]
    - `question` string — The question this user was asked while onboarding
    - `answer` string — This user's answer to the question
    - `isPrivate` boolean — Whether this question was marked as private
  - `bio` string — The user's Heartbeat bio
  - `avatar` string, uri — A URL that points to the user's Heartbeat avatar
  - `linkedInSummary` string — A single formatted string containing the user's entire LinkedIn history. Empty if no LinkedIn data is available
  - `linkedInData` object, nullable
    - `profileUrl` string
    - `headline` string, nullable
    - `company` string, nullable
    - `description` string, nullable
    - `location` string, nullable
    - `jobs` object[], nullable
      - `companyName` string, nullable
      - `jobTitle` string, nullable
      - `description` string, nullable
      - `location` string, nullable
      - `dateRange` string, nullable
    - `schools` object[], nullable
      - `schoolName` string, nullable
      - `degree` string, nullable
      - `degreeSpec` string, nullable
      - `dateRange` string, nullable
    - `skills` string[], nullable

## Other responses

- `401` — API Key is missing or invalid
- `404` — Could not find the specified user

---

[API](https://skmtc.net/heartbeat/apis/heartbeat-api.md) · [All operations](https://skmtc.net/heartbeat/apis/heartbeat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heartbeat/heartbeat-api/versions/6c3cf537d508/schema)