---
title: "List registered end users"
method: GET
path: "/end-users"
tags: ["End Users"]
---

# List registered end users

`GET /end-users`

List registrations belonging to the authenticated organization. Inactive registrations are excluded by default. [Management key](/docs/guides/overview/auth/management-api-keys) required.

## Query parameters

- `offset` integer, nullable — Number of records to skip for pagination
- `limit` integer — Maximum number of records to return (max 100)
- `user` string — Immutable case-sensitive tracking string supplied as user on inference requests. URL-encode it in resource paths.
- `include_inactive` boolean — Include deactivated registrations.

## Response `200`

Matching registrations and their total count.

- ListEndUsersResponse
  - `data` EndUser[], required
    - `created_at` string, date-time, required — Registration creation time.
    - `is_active` boolean, required — Whether this registration is active. Not an inference authorization decision.
    - `updated_at` string, date-time, required — Last registration lifecycle update time.
    - `user` string, required — Immutable case-sensitive tracking string supplied as user on inference requests. URL-encode it in resource paths.
  - `total_count` integer, required — Number of registrations matching the filters before pagination.

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed input
- `401` — Unauthorized - Authentication required or invalid credentials
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error - Unexpected server error

## Changes

- **2026-09-30** `5f145dc0df51` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/end-users/get.md)

---

[API](https://skmtc.dev/openrouterteam/apis/openrouter-api.md) · [All operations](https://skmtc.dev/openrouterteam/apis/openrouter-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openrouterteam/apis/openrouter-api/revisions/ae97b5c6983d?raw)