List Users
List all users in your Clowk instance with the GET /api/v1/users REST endpoint, authenticated with your secret key in the X-Clowk-Secret-Key header.
GET /api/v1/users
Returns all users that belong to the instance associated with your secret key.
Request
curl https://myapp.clowk.dev/api/v1/users \
-H "X-Clowk-Secret-Key: sk_live_..."Headers
| Header | Required | Description |
|---|---|---|
X-Clowk-Secret-Key | Yes | Your instance secret key |
Response
200 — Success
[
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"resource": "user",
"data": {
"email": "[email protected]",
"name": "Jane Doe",
"avatar_url": "https://lh3.googleusercontent.com/...",
"email_verified": true,
"providers": ["google"],
"created_at": "2026-03-20T10:30:00Z"
}
}
]401 — Unauthorized
{ "error": "Unauthorized" }Verify Token
Verify a Clowk JWT and get the signed-in user with POST /api/v1/tokens/verify, plus the JWT payload and claims, signed with HS256 by your secret key.
Get User
Fetch one Clowk user by UUID with GET /api/v1/users/:id using your secret key: email, name, avatar, email verification and connected OAuth providers.