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

# List Users

> Retrieves all users in the authenticated user's organization

Retrieves a list of all users belonging to the currently authenticated user's organization. This endpoint is useful for displaying team members, assigning leads to users, or managing organization-wide user data.

## Authentication

This endpoint requires authentication. The user must be signed in and belong to an organization.

<Note>
  Only users within the same Clerk organization are returned. The requesting
  user must have a valid organization context.
</Note>

## Request

This endpoint does not require any query parameters or request body.

## Response

Returns an array of user objects.

<ResponseField name="users" type="array">
  An array of user objects belonging to the organization.

  <Expandable title="User object properties">
    <ResponseField name="id" type="string" required>
      Unique identifier for the user (same as `clerkId`).
    </ResponseField>

    <ResponseField name="firstName" type="string | null" required>
      The user's first name. May be `null` if not set in Clerk.
    </ResponseField>

    <ResponseField name="lastName" type="string | null" required>
      The user's last name. May be `null` if not set in Clerk.
    </ResponseField>

    <ResponseField name="email" type="string | null" required>
      The user's primary email address. May be `null` if no primary email is set.
    </ResponseField>

    <ResponseField name="profilePictureUrl" type="string | null" required>
      URL to the user's profile picture. May be `null` if no image is set.
    </ResponseField>

    <ResponseField name="createdAt" type="string" required>
      ISO 8601 timestamp of when the user was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string" required>
      ISO 8601 timestamp of when the user was last updated.
    </ResponseField>

    <ResponseField name="clerkId" type="string" required>
      The user's Clerk ID. This is the same value as `id`.
    </ResponseField>

    <ResponseField name="clerkOrgId" type="string | null" required>
      The Clerk organization ID the user belongs to.
    </ResponseField>
  </Expandable>
</ResponseField>

## Response Examples

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "user_abc123",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@company.com",
      "profilePictureUrl": "https://img.clerk.com/user_abc123.jpg",
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-15T14:30:00.000Z",
      "clerkId": "user_abc123",
      "clerkOrgId": "org_xyz789"
    },
    {
      "id": "user_def456",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane.doe@company.com",
      "profilePictureUrl": null,
      "createdAt": "2024-01-12T10:15:00.000Z",
      "updatedAt": "2024-01-12T10:15:00.000Z",
      "clerkId": "user_def456",
      "clerkOrgId": "org_xyz789"
    }
  ]
  ```

  ```json 400 theme={null}
  {
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "User Org Id missing"
    }
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "code": "UNAUTHORIZED",
      "message": "User not authenticated"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Status Code | Error Code         | Description                                                                                   |
| ----------- | ------------------ | --------------------------------------------------------------------------------------------- |
| 400         | `VALIDATION_ERROR` | User does not belong to an organization. Ensure the user has joined an organization in Clerk. |
| 401         | `UNAUTHORIZED`     | User is not authenticated. Ensure a valid session exists.                                     |
| 500         | `INTERNAL_ERROR`   | An unexpected server error occurred.                                                          |