---
title: "Get Users in Tenant"
method: GET
path: "/tenants/{tenant_id}/users"
tags: ["Tenants"]
---

# Get Users in Tenant

`GET /tenants/{tenant_id}/users`

Returns the users belonging to a tenant with cursor paging. Use it to see who a tenant-scoped send will reach.

## Path parameters

- `tenant_id` string, required

## Query parameters

- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

- ListUsersForTenantResponse
  - `items` UserTenantAssociation[], nullable
    - `user_id` string, nullable — User ID for the association between tenant and user
    - `type` 'user', nullable
    - `tenant_id` string, required — Tenant ID for the association between tenant and user
    - `profile` object, nullable — Additional metadata to be applied to a user profile when used in a tenant context
  - `has_more` boolean, required — Set to true when there are more pages that can be retrieved.
  - `url` string, required — A url that may be used to generate these results.
  - `next_url` string, nullable — A url that may be used to generate fetch the next set of results. Defined only when `has_more` is set to true
  - `cursor` string, nullable — A pointer to the next page of results. Defined only when `has_more` is set to true
  - `type` 'list', required — Always set to `list`. Represents the type of this object.

## Other responses

- `400`

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/04f69fbf96a5/schema)