API Reference
Log In
API Reference

List insights runs

get
https://app.revenium.ai/api/v2/insights/runs

List insights runs for the authenticated team, newest first. Each item has the run status, the analyzed period and the number of findings and recommendations, without the full results. Fetch one run for those.

Filter with status, since, until and triggered_by. To page through results, pass the next_cursor from a response as cursor; a null next_cursor means you reached the last page.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≤ 100
Defaults to 20

Maximum number of runs to return, from 1 to 100. Defaults to 20.

string

Pagination cursor. Pass the next_cursor from the previous response to get the next page.

string
enum

Keep only runs with this status: running, completed, partial, failed or cancelled.

Allowed:
string | null

Keep only runs created at or after this time. ISO 8601, for example 2026-01-01T00:00:00Z.

string | null

Keep only runs created at or before this time. ISO 8601, for example 2026-01-31T23:59:59Z.

string
enum

Keep only runs started this way: user (in the Revenium app), system or schedule (automatic), or api (through this API).

Allowed:
string

Hashed id of the team to answer for. Optional. With a user token it may be any team the user belongs to; without it the user's default team answers. An API key always answers for its own team, and naming any other team is refused with 403.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 4 days ago

Did this page help you?
Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated 4 days ago

Did this page help you?