> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harmonyforstaffing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Users

> Retrieve users

Retrieve a list of users or get details for a specific user.

### Query Parameters

<ParamField query="id" type="string">
  Optional user ID to get a specific user
</ParamField>

<ParamField query="isActive" type="boolean">
  Filter by active status
</ParamField>

### Response

<ResponseField name="users" type="array">
  List of user objects
</ResponseField>

<RequestExample>
  ```bash theme={null}
  # Get all active users
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/users?isActive=true \
    --header 'Authorization: Bearer <token>'

  # Get specific user
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/users?id=123 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "users": [
      {
        "id": 123,
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "jane.smith@example.com",
        "phone": "+1-555-555-5555",
        "role": {
          "id": 1,
          "name": "Recruiter",
          "description": "Can manage candidates and job submissions"
        },
        "isActive": true,
        "dateAdded": 1679253000
      }
    ]
  }
  ```
</ResponseExample>