Skip to main content
GET
/
users
/
{id}
Get User
curl --request GET \
  --url https://api.petstoreapi.com/v1/users/{id}
{
  "id": "019b4138-e0af-70b9-8f0c-6ea97d495dfa",
  "username": "ameliehackett",
  "firstName": "Amelie",
  "lastName": "Hackett",
  "email": "[email protected]",
  "phone": "+16324377270",
  "createdAt": "2025-12-21T13:56:23Z",
  "updatedAt": "2025-12-21T13:56:23Z"
}

Headers

​
X-Tenant-ID
string<uuid>

Optional tenant identifier for data isolation. When provided, all operations will be scoped to this tenant, ensuring data separation between different organizations or users. If omitted, operations will access the shared/public data pool where data may be visible to and modified by other users.

Path Parameters

​
id
string
required

Unique identifier for the user

Response

Operation successful

User account information

​
id
string<uuid>
required

Unique user identifier (UUID v7)

Examples:

"019b4138-e0af-70b9-8f0c-6ea97d495dfa"

"019b4128-6a6b-777c-9ae8-335e962c68d8"

​
username
string
required

Unique username for login

Required string length: 3 - 50
Examples:

"johndoe"

"mysqluser"

​
email
string<email>
required

User email address

Examples:

"[email protected]"

"[email protected]"

​
firstName
string
required

User's first name

Examples:

"John"

"Jane"

​
lastName
string
required

User's last name

Examples:

"Doe"

"Smith"

​
createdAt
string<date-time>
required

Account creation timestamp (RFC 3339)

Examples:

"2025-12-21T13:56:23Z"

"2025-11-15T08:30:00Z"

​
updatedAt
string<date-time>
required

Account last update timestamp (RFC 3339)

Examples:

"2025-12-21T13:56:23Z"

"2025-12-21T15:30:45Z"

​
phone
string

Phone number in E.164 format

Example:

"+12025551234"

​
tenantId
string<uuid> | null

Optional tenant identifier for data isolation. When present, indicates this user belongs to a specific tenant. Null or omitted means the user is in the shared/public data pool.

Examples:

"550e8400-e29b-41d4-a716-446655440000"

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

​
preferences
object