ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiUsers

Get a user by ID

GET
/api/v1/users/{id}

Retrieves a single user by their UUID. Returns cached data if available.

Authorization

bearer

Path Parameters

id*string

User UUID

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Response Body

Return the user.

response?unknownapplication/json
Example Request
curl -X GET 'http://localhost:3001/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe'
Example Response
{  "status": "success",  "statusCode": 200,  "message": "User fetched successfully",  "data": {    "id": "6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe",    "email": "john.doe@example.com",    "firstName": "John",    "lastName": "Doe",    "isActive": true,    "createdAt": "2026-01-27T10:23:22.983Z",    "updatedAt": "2026-01-27T10:23:22.983Z"  },  "meta": {    "cached": true  },  "timestamp": "2026-01-27T10:28:36.014Z",  "path": "/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}

Get all users with pagination (Admin/Moderator) GET

Retrieves a paginated list of users. Use page and limit query parameters to control pagination. Requires Admin or Moderator role.

Get user statistics (Admin/Moderator) GET

Retrieves user statistics including total, active, inactive, and today registered counts. Requires Admin or Moderator role.