Get session results

Retrieve the status and results of a flow session

Retrieve detailed information about a specific session, including its current status, outcome, and session history. The response follows data minimization principles by default, returning only essential metadata.

Endpoint

GET v1/{environment}/sessions/{sessionId}

Path parameters

Parameter	Type	Required	Description
sessionId	string	Yes	The unique identifier of the session
environment	String	Yes	Environment name

Request

No request body is required for this endpoint.

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer token for authentication

Response

    {
      "sessionId": "0197c55f-5af6-7e3d-af9b-f2359b134be8",
      "sessionStatus": "COMPLETED",
      "flowId": "0197c55f-5af6-7e3d-af9b-f2359b154be8",
      "flowVersion": 1,
      "environment": "live",
      "outcome": "ACCEPTED",
      "createdAt": "2025-01-07T10:30:00.000Z",
      "startedAt": "2025-01-07T10:30:00.000Z",
      "updatedAt": "2025-01-07T10:35:00.000Z",
      "completedAt": "2025-01-07T10:35:00.000Z",
      "lastStep": {
        "stepName": "END",
        "stepType": "END",
        "verdict": "accepted"
      }
}

Response parameters

Parameter	Type	Description
sessionId	string	The unique identifier of the session
sessionStatus	string	Current status (e.g. RUNNING or COMPLETED)
flowId	string	Flow identifier
flowVersion	number	Version of the flow executed
environment	string	Environment name
subjectId	string	The provided reference ID for the user
outcome	string	Final session outcome (e.g., ACCEPTED, REJECTED`)
createdAt	string	ISO 8601 timestamp when session was created
startedAt	string	ISO 8601 timestamp when processing started (null if not started)
updatedAt	string	ISO 8601 timestamp of last update
completedAt	string	ISO 8601 timestamp when session completed
expiresAt	string	ISO 8601 timestamp when session expires
lastStep	object	Information about the last executed step
lastStep.stepName	string	Name of the last step
lastStep.stepType	string	Type of the last step (e.g., END, START)
lastStep.verdict	string	Last step verdict (e.g., accepted, failed)

Example

curl https://api.eu.platform.idnow.io/api/v1/live/sessions/123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Notes

• Response implements data minimization by default for GDPR compliance
• If the session status is not accepted, the lastStep object provides debugging context
• Data block access is separated to allow granular access control