---
title: "A User"
method: GET
path: "/api/users/{id}"
tags: ["users"]
---

# A User

`GET /api/users/{id}`

This endpoint allows the client to retrieve a single user, either by id or by the user's username.

### Path Parameter Options:
- **id**: Can be either the user's unique numerical ID (e.g. `123`) OR the user's string username (e.g. `ben`).
- Note that the returned user object schema (`ExtendedUser`) includes extended profile statistics and social link details.

## Path parameters

- `id` string, required

## Response `200`

successful

- object

## Changes

> 59 revisions in range; 8 could not be searched.

- **2023-11-22** (v1) `3f0ed916f9af` — 2 info
  - added the optional property `items/badge_ids` to the response with the `200` status
  - added the optional property `items/email` to the response with the `200` status
- **2023-02-03** (v1) `0789a6ed97e3` — 4 breaking
  - the response property `items/location` became nullable for the status `200`
  - the response property `items/summary` became nullable for the status `200`
  - the response property `items/website_url` became nullable for the status `200`
  - the `items/id` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
- **2023-02-03** (v1) `8423851526d7` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2023-01-10** (v1) `754f8b25f815` — 1 breaking
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/users/:id/get.md)

---

[API](https://skmtc.dev/forem/apis/forem-api-v1.md) · [All operations](https://skmtc.dev/forem/apis/forem-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/forem/forem-api-v1/revisions/1f64f71fc2a7/schema)