Get return on investment by job type

get

https://app.revenium.ai/api/v2/analytics/jobs/roi-summary

Returns cost, value and return on investment for each job type over the date range, best ratio of value to cost first, with totals across all job types. Cost is in USD and is the sum of token cost, modality cost (image, video and audio), external tool cost and human cost. Return on investment is in percent.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

startDate

date-time

Start of the date range, ISO 8601 in UTC, for example 2026-01-01T00:00:00Z. Defaults to 24 hours before endDate.

endDate

date-time

End of the date range, ISO 8601 in UTC. Defaults to now.

metricType

string

enum

Accepted for compatibility. This endpoint ignores it.

jobType

string

Keep only this job type. Case is ignored. Omit it for every job type.

teamId

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

200Get return on investment by job type

400Bad Request: the request is invalid. code is one of INVALID_TEAM_ID, VALIDATION_ERROR.

401Unauthorized: the API key or token is missing or invalid. code is UNAUTHORIZED.

403Forbidden: the credential may not make this request. code is one of FORBIDDEN, TEAM_NOT_IN_MEMBERSHIP.

500Internal Server Error: the request could not be completed. code is one of INTERNAL_ERROR, INTERNAL_SERVER_ERROR.