External Users

List registered external users

Changed on

List registrations belonging to the authenticated organization. Inactive registrations are excluded by default. Management key required.

get/external-users

Request

  • Base URL: https://openrouter.ai/api/v1
  • URL: https://openrouter.ai/api/v1/external-users
  • Auth: HTTP bearer

Query parameters

offsetinteger nullable

Number of records to skip for pagination

limitinteger

Maximum number of records to return (max 100)

Example:50
userstring

Immutable case-sensitive tracking string supplied as user on inference requests or as external.user on API keys: 1 to 512 characters, well-formed Unicode, no NUL, no surrounding whitespace. URL-encode it in resource paths; an ID of . or .. cannot be addressed by path, so look it up with the list filter.

Example:employee_123
include_inactiveboolean

Include deactivated registrations.

Response

Matching registrations and their total count.

total_countinteger required

Number of registrations matching the filters before pagination.

Example response

{
  "data": [
    {
      "created_at": "2026-09-16T12:00:00Z",
      "is_active": true,
      "updated_at": "2026-09-16T12:00:00Z",
      "user": "employee_123"
    }
  ],
  "total_count": 1
}

Changes