GET/clients/{client_id}

Get a client

Retrieves the details of a client and its associated session information. Use client_id to look up the client whose sessions and authentication state you need to inspect.

1 parameter
client_idstringrequired
The unique identifier of the client to retrieve.

4 status codes
200Returns the client object, including its session IDs, session details, sign-in and sign-up IDs, last authentication strategy, and timestamps.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:client
idstringrequired
String representing the identifier of the session.
session_idsarray<string>required
sessionsarray<object>required
sign_in_idstringrequired
sign_up_idstringrequired
last_active_session_idstringrequired
Last active session_id.
last_authentication_strategystringrequired
The authentication strategy that was last used to authenticate the user on this client.
updated_atintegerrequired
Unix timestamp of last update.
created_atintegerrequired
Unix timestamp of creation.
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the client resource is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

An invalid request returns a 400, and invalid authentication returns a 401. The client_id path parameter must identify an existing client; a 404 is returned when the resource is not found.