List users
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.
Authentication
Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.
Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.
Query parameters
Sort field. Prefix with - for descending. Common values include customer_identifier, email, name, -first_seen, -number_of_requests, and -total_cost.
Request
Each key is a field to filter on, and each value is a condition: {"<field>": {"operator": "<operator>", "value": [...]}}. A user must match every condition. To set two conditions on one field, such as a range, pass a list of conditions.
Operators: "" (equals, the default), not, in, not_in, lt, lte, gt, gte, contains, not_contains, icontains (ignores case), startswith, not_startswith, endswith, not_endswith, empty, not_empty. Put values in a list: "" and in match any of the listed values, and not and not_in match none of them. Other operators take one value; for empty and not_empty, send [""].
Fields: customer_identifier, name, email, environment, number_of_requests, total_cost, total_tokens, total_prompt_tokens, total_completion_tokens, average_latency, average_ttft, active_days. Unsupported fields, including metadata__<key>, return a 400 error.
Example:
{
"total_cost": {"operator": "gte", "value": [10]},
"email": {"operator": "endswith", "value": ["@acme.dev"]}
}
Response
Number of results on this page, not the total. Request pages until next is null to get every result.