Skip to main content
These endpoints are primarily for administrative tooling or auto-complete features. They never expose passwords or tokens.

​
GET /api/users

  • Auth – optional.
  • Query params – limit and offset for pagination.
  • Response – each entry contains:
    • Unauthenticated callers: { id, firstName, lastName }.
    • Authenticated callers: the fields above plus { email, created }.
Example: 
[
  {
    "id": "usr_123",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "email": "[email protected]",
    "created": "2024-04-20T10:25:38.000Z"
  }
]

​
GET /api/users/{id}

  • Auth – optional.
  • Response – same shape as the list endpoint but for a single user. When the user does not exist the API responds with HTTP 400 and { "status": "error", "message": "User not found with id: ..." }.