---
title: "Admin \u2014 lookup endpoints"
path: reference/api/admin-lookups
status: published
---

# Admin — lookup endpoints

**3 endpoints** in this group. All paths are prefixed with `/api/v1`.

## Endpoints in this group

- [`GET /api/v1/admin/lookups/partners`](#get-api-v1-admin-lookups-partners) — List Partners
- [`GET /api/v1/admin/lookups/subscriptions`](#get-api-v1-admin-lookups-subscriptions) — List Subscriptions
- [`GET /api/v1/admin/lookups/tenants`](#get-api-v1-admin-lookups-tenants) — List Tenants

---

### GET `/api/v1/admin/lookups/partners` — List Partners {#get-api-v1-admin-lookups-partners}

List all configured partners.

**Parameters**:

- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_list_PartnerSummary__` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### GET `/api/v1/admin/lookups/subscriptions` — List Subscriptions {#get-api-v1-admin-lookups-subscriptions}

List subscriptions platform-wide with optional filters.

**Parameters**:

- `page` (query, integer, optional)
- `page_size` (query, integer, optional)
- `tenant_id` (query, string, optional)
- `service_slug` (query, string, optional)
- `status` (query, string, optional)
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `PaginatedResponse_SubscriptionSummary_` — {`data`, `pagination`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### GET `/api/v1/admin/lookups/tenants` — List Tenants {#get-api-v1-admin-lookups-tenants}

List distinct tenants with user counts.

**Parameters**:

- `q` (query, string, optional) — Filter by tenant ID prefix or email
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_list_TenantSummary__` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}