Get flow result
Retrieve the execution results of a completed or failed flow. Returns a projected view of the results for all sessions executed during the flow, associated with the person's identity. Access is restricted to the flow's owner. Returns 404 if flow is not started yet.
curl -X GET "https://demo.verigram.kz/flow/{flow_id}/result" \
-H "X-Verigram-Api-Key: $IDENTIFICATION_SAAS_API_KEY" \
-H "X-Verigram-Api-Version: 2.0.0"Авторизация
X-Verigram-Api-KeystringheaderобязательноAPI key in the X-Verigram-Api-Key header
Параметры
X-Verigram-Api-VersionstringheaderобязательноRequired API version header.
Значение по умолчанию:2.0.0
Ответ
Flow Projection
person_idstringIdentifier of a person associated with the session. Alphanumeric string.
flow_idstringUnique identifier for the flow.
person_namestringThe full name of the person being verified. This field is populated if a document recognition service was part of the flow and successfully extracted the name.
iinstringIndividual Identification Number (IIN) of the person, if extracted.
check_typeenum<string>Indicates whether the verification result was determined automatically or manually reviewed/edited by an operator.
Одно из:autoeditedcountry_codestringThree-letter ISO 3166-1 alpha-3 country code (e.g., "KAZ").
end_causeenum<string>The reason why the flow ended. Returns "completed" when execution finishes without errors, "failed" when a server error or unhandled exception occurs, "timeout" when a specific step exceeds its allocated duration, or "disconnected" when the flow terminates due to a lost network connection or user intervention — a status applied automatically once the default five-minute inactivity threshold is reached, provided at least one service session was successfully initialized.
Одно из:completedfailedtimeoutdisconnectedflow_statusenum<string>The main status of a flow or a service. Helps to make a binary decision whether the flow/service was successful or not. If "pass" - the flow/service was successful, unsuccessful otherwise.
Одно из:passfailunknownsessions_countintegerThe total number of service sessions (e.g., liveness checks, document recognition) executed during the flow.
services_countintegerThe total number of unique services that were executed during the flow.
created_atstring<date-time>Timestamp when the flow was first initialized.
updated_atstring<date-time>Timestamp of the last update to any session within the flow.
ended_atstring<date-time>Timestamp when the flow reached its final state.
service_statusesFlowServiceStatus[]Detailed status and result summary for each service executed in the flow.
{
"person_id": "string",
"flow_id": "string",
"person_name": "string",
"iin": "string",
"check_type": "auto",
"country_code": "string",
"end_cause": "completed",
"flow_status": "pass",
"sessions_count": 0,
"services_count": 0,
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"ended_at": "2026-01-15T09:30:00Z",
"service_statuses": [
{
"service_name": "verilive",
"session_id": "string",
"step_id": "string",
"session_status": "pass",
"session_state": "created",
"session_states": [
{
"state_name": "created",
"created_at": "2026-01-15T09:30:00Z"
}
],
"frontend_session_status": "approved",
"session_result": {
"created_at": "2026-01-15T09:30:00Z",
"created_by": "string",
"error_code": "string",
"error_msg": "string",
"service_name": "verilive",
"service_status": "real",
"error_codes": [
"timeout"
],
"warnings": [
"timeout"
],
"start_time": "2026-01-15T09:30:00Z",
"end_time": "2026-01-15T09:30:00Z"
},
"sessions_count": 0,
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z"
}
]
}