---
title: "Get User by ID"
method: GET
path: "/api/v3/user/{user_id}"
tags: ["User"]
---

# Get User by ID

`GET /api/v3/user/{user_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/user/{user_id}`
- Auth: HTTP bearer

Get a single User by ID.

## Path parameters

- `user_id` string, required

## Query parameters

- `returning` string[]
- `omit` string[]

## Response `200`

OK

- User: Represents a human user in Benchling who can log in, perform actions, and own data. Users belong to one or more Organizations and may be members of Teams within those organizations. As an Owner, users can own Projects, Folders, and other resources. As a Principal, users can be assigned as reviewers, authors, or collaborators on various items. Users have attributes like email and username for identification. Users are distinct from `ServicePrincipal`, which represents non-human service accounts used for integrations.
  - `__typename` string
  - `createdAt` string, datetime
  - `email` string
  - `id` string
  - `lastSeen` string, datetime, nullable
  - `modifiedAt` string, datetime
  - `name` string, nullable
  - `status` 'ACTIVE' | 'SUSPENDED'
  - `username` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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