---
title: "Retrieves users"
method: GET
path: "/Users"
tags: ["Accounting"]
---

# Retrieves users

`GET /Users`

## Query parameters

- `where` string
- `order` string

## Headers

- `If-Modified-Since` string, date-time

## Response `200`

Success - return response of type Users array of all User

- Users
  - `Users` User[]
    - `UserID` string, uuid — Xero identifier
    - `EmailAddress` string — Email address of user
    - `FirstName` string — First name of user
    - `LastName` string — Last name of user
    - `UpdatedDateUTC` string — Timestamp of last change to user
    - `IsSubscriber` boolean — Boolean to indicate if user is the subscriber
    - `OrganisationRole` 'READONLY' | 'INVOICEONLY' | 'STANDARD' | 'FINANCIALADVISER' | 'MANAGEDCLIENT' | 'CASHBOOKCLIENT' | 'UNKNOWN' | 'REMOVED' — User role that defines permissions in Xero and via API (READONLY, INVOICEONLY, STANDARD, FINANCIALADVISER, etc)

## Changes

> 57 revisions in range; 2 could not be searched.

- **2025-06-19** `e45588290009` — 1 warning
  - added the new `REMOVED` enum value to the `Users/items/OrganisationRole` response property for the response status `200`

[Change history](https://skmtc.dev/xeroapi/apis/xero-accounting-api/changes/Users/get.md)

---

[API](https://skmtc.dev/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.dev/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xeroapi/xero-accounting-api/revisions/f980dbcfc317/schema)