Users

List users

Changed on Oct 21, 2026

Returns users in your organization with usage analytics and budget settings. Filter fields include customer_identifier, name, email, number_of_requests, total_tokens, total_cost, and active_days.

post/api/users/list/

Request

Base URL
https://api.respan.ai
URL
https://api.respan.ai/api/users/list/
Auth
- HTTP bearer
- or HTTP bearer

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of users per page. Maximum is 1000.

sort_bystring

Sort field. Prefix with - for descending. Common values include customer_identifier, email, name, -first_seen, -number_of_requests, and -total_cost.

environment'prod' | 'test'

Optional environment filter. If omitted, the backend uses the environment implied by your auth context when applicable.

Request body

Example request

{
  "filters": {
    "customer_identifier": {
      "operator": "",
      "value": [
        "alex@acme.dev"
      ]
    }
  }
}

Response

Paginated list of users.

countinteger required

Number of results on this page, not the total. Request pages until next is null to get every result.

nextstring nullable

Next page URL.

previousstring nullable

Previous page URL.

Changes

Oct 21, 2026c30bcb383ee8 Revision changes
- breaking
  request body became required
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property format changed from double to no format for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property format changed from double to no format for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property format changed from double to no format for status
- info
  api operation id users_listCustomers removed and replaced with listCustomers
- info
  the endpoint scheme security DashboardJwt was added to the API
- info
  api tag Users added
- info
  api tag users removed
Oct 2, 2026b830b79cfd52 Revision changes
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the non-success response with the status
- info
  removed the non-success response with the status

Operation history (4 revisions)