Function getUser

GET /users/{userId} – Retrieves user given the ID.

---

📥 Request

Headers:

• Authorization: Bearer <access_token> (required)
• Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

• None

Path Parameters:

• userId: The ID or email of the user to retrieve. (required)

Query Parameters:

• userPoolId: The Cognito user pool ID (required for Cognito)
• provider: The authentication provider (optional). Defaults to auth0-user.

---

📤 Response

• 200 OK – Returns a JSON-stringified User object.

---

❗ Errors

Status Code	Meaning	When it Happens
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Missing or invalid authentication token
404	Not Found	User not found
500	Internal Server Error	Unexpected error during user retrieval

Error Response Format

{
  "error": "Detailed error message here"
}
Copy

---

📦 Examples

📥 Auth0 Request

GET /users/user_123?provider=auth0-user
Copy

📥 Cognito Request

GET /users/user_123?userPoolId=us-east-1_1234test&provider=cognito-user
Copy

📤 Response Example

{
  "id": "user_123",
  "email": "user@district123.com",
  "name": "John Doe",
  "blocked": false,
  "emailVerified": true,
  "createdAt": "2025-09-12T12:00:00Z",
  "updatedAt": "2025-09-12T12:00:00Z",
  "appMetadata": {
    // ...app metadata fields...
  },
  "userMetadata": {
    // ...user metadata fields...
  }
  // Additional user fields
}
Copy

---