---
title: "Gets a filtered list of Users"
method: GET
path: "/Users/Search"
tags: ["Users"]
---

# Gets a filtered list of Users

`GET /Users/Search`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Users/Search`
- Auth: none declared. Required headers: `Authorization`

This is a read only endpoint that returns a list of users associated with an Insightly instance.            Use this endpoint when you need to obtain a list of valid USER_IDs, for example, when you want to assign            a task to a specific user (do not confuse the USER_ID with their CONTACT_ID).             <br /> To filter with a field name and value, both field_name and field_value parameters must be provided.            <br /> For other filters, only one optional parameter (excluding brief, top, skip and count_total) can be specified.             <br /> Simple object graphs (excluding NOTELINKS) are returned if "brief=true" is used in the query string.

## Query parameters

- `field_name` string
- `field_value` string
- `updated_after_utc` string, date-time
- `skip` integer
- `top` integer
- `count_total` boolean

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- object[]
  - `USER_ID` integer
  - `CONTACT_ID` integer
  - `FIRST_NAME` string
  - `LAST_NAME` string
  - `TIMEZONE_ID` string
  - `EMAIL_ADDRESS` string
  - `EMAIL_DROPBOX_IDENTIFIER` string
  - `EMAIL_DROPBOX_ADDRESS` string
  - `ADMINISTRATOR` boolean
  - `ACCOUNT_OWNER` boolean
  - `ACTIVE` boolean
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `USER_CURRENCY` string
  - `CONTACT_DISPLAY` string
  - `CONTACT_ORDER` string
  - `TASK_WEEK_START` integer
  - `INSTANCE_ID` integer
  - `PROFILE_ID` integer
  - `ROLE_ID` integer

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Authentication failed.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)