---
title: "List Tenants"
method: GET
path: "/tenants"
tags: ["Tenants"]
---

# List Tenants

`GET /tenants`

List all tenants with cursor-based pagination.

**Requirements:** This endpoint requires Redis with RediSearch module (e.g., `redis/redis-stack-server`).
If RediSearch is not available, this endpoint returns `501 Not Implemented`.

The response includes lightweight tenant objects without computed fields like `destinations_count` and `topics`.
Use `GET /tenants/{tenant_id}` to retrieve full tenant details including these fields.

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `next` string
- `prev` string

## Response `200`

List of tenants.

- TenantListResponse — Paginated list of tenants.
  - `data` TenantListItem[] — Array of tenant objects.
    - `id` string — User-defined system ID for the tenant.
    - `destinations_count` integer — Number of destinations associated with the tenant.
    - `topics` string[] — List of subscribed topics across all destinations for this tenant.
    - `metadata` object, nullable — Arbitrary key-value pairs for storing contextual information about the tenant.
    - `created_at` string, date-time — ISO Date when the tenant was created.
    - `updated_at` string, date-time — ISO Date when the tenant was last updated.
  - `next` string, nullable — Cursor for the next page of results. Null if no more results.
  - `prev` string, nullable — Cursor for the previous page of results. Null if on first page.
  - `count` integer — Total count of all tenants.

## Other responses

- `400` — Invalid request parameters (e.g., invalid cursor, both next and prev provided).
- `401` — Unauthorized (Admin API Key missing or invalid).
- `501` — List Tenants feature is not available. Requires Redis with RediSearch module.

## Changes

- **2026-01-14** `71b1a6e5c824` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hookdeck/apis/outpost-api/changes/tenants/get.md)

---

[API](https://skmtc.dev/hookdeck/apis/outpost-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/outpost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/outpost-api/revisions/07bb5388b476/schema)