API Reference / Finance - ROI

Get contributor ROI detail

get https://api.intelig.ai/api/v1/intelig/finance/roi/contributors/{contributorId}

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: getContributorDetail

Returns a detailed ROI breakdown for a specific contributor including cost efficiency metrics (cost per PR, commit, review), individual metric scores, and normalization context. Filters by from/to date range (max 90 days) and optional budgetId.

Example request

curl -X GET "https://api.intelig.ai/api/v1/intelig/finance/roi/contributors/1?from=string&to=string" \
  -H "Authorization: ApiKey $INTELIG_API_KEY"

Path parameters

NameTypeRequiredDescription
contributorId integer (int64) yes

Query parameters

NameTypeRequiredDescription
from string (date) yes
to string (date) yes
budgetId integer (int64) no

Response 200

application/json · ApiResponseContributorRoiDetailResponseDto

FieldTypeDescription
success boolean
message string
data ContributorRoiDetailResponseDto Detailed contributor ROI response with full cost and output breakdowns

Status codes

  • 200 — Contributor ROI detail returned
  • 400 — Invalid date range, range exceeds 90 days, or missing org context
  • 401 — Authentication required
  • 403 — Insufficient permissions for Finance pillar
  • 404 — Contributor not found or has no budget data
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.