---
title: "List Users"
method: GET
path: "/tenants/{tenant_id}/users"
tags: ["Users"]
---

# List Users

`GET /tenants/{tenant_id}/users`

Returns a list of users.

---

Users are returned sorted in descending order based on creation date.

## Path parameters

- `tenant_id` string, uuid, required

## Query parameters

- `email[]` string[]
- `external_provider_id[]` string[]
- `partner_id[]` string[]

## Response `200`

Users successfully retrieved.

- object
  - `users` object[]
    - `id` string, uuid — Unique ID identifying the user.
    - `first_name` string — First name of the user.
    - `last_name` string — Last name of the user.
    - `email` string, email — Email address of the user.
    - `account_status` string — Status of the user.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.net/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/revisions/5b41808d104d/schema)