Get approval request timeline
/approval-requests/{type}/{requestId}/timelineLists the events of an approval request, oldest first, across every time the request was started: started, restarted, rejected (stamped with the refusal time), one vote_ event per vote named for its state, vote_removal after every deleted vote except a sent-back one (the reason in note, or null) and choice when a route was chosen. Visibility is the same as for the request itself.
Path parameters
- One of:
The kind of request: opportunity (a deal being published or shared) or invite (an investor invitation).
opportunity,invite The request key: the deal's UUID for opportunity, or the invite's UUID for invite. Matched without regard to case. Anything that is not a UUID is 404.
Query parameters
- Default:
Page size (1–100). Defaults to 25; values are clamped to the range.
25 Opaque pagination cursor taken from a prior response's
meta.next_cursor.
Responses
{
"data": [
{
"event": "started",
"occurred_at": "2026-06-15T10:30:00Z"
},
{
"event": "vote_approved",
"occurred_at": "2026-06-15T11:02:10Z",
"user_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"step_id": 318,
"note": "Looks good."
}
],
"meta": {
"limit": 25,
"next_cursor": null,
"prev_cursor": null
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl https://your-org-domain/kong/core/api/v2/approval-requests/{type}/{requestId}/timeline\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"