Get data blocks

Retrieve input and output data blocks for a session

Retrieve all data blocks associated with a specific session. Data blocks contain the input data provided when creating the session and output data generated during flow execution. This endpoint supports both input and output data block retrieval with pagination.

Endpoint

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

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

{
  "datablocks": [
    {
      "type": "BasicIdentity",
      "createdByStep": "doc_idv",
      "createdAt": "2025-10-24T12:30:00Z",
      "name": "Schmidt",
      "familyName": "Schmidt",
      "givenName": "Max",
      "birthDate": "1985-08-22"
    },
    {
      "type": "Credentials",
      "createdByStep": "doc_idv",
      "createdAt": "2025-10-24T12:30:00Z",
      "credentialType": "io.idnow.idcheckio.<document code>",
      "issuanceDate": "2025-12-07",
      "expiryDate": "2035-12-07",
      "issuer": {}
    }
  ]
}

Response parameters

Parameter	Type	Description
datablocks	array	Array of data block objects

All data blocks include these fields:

Field	Type	Description
type	string	Type of data block (e.g., BasicIdentity, Credentials)
createdByStep	string	Step that created this data block
createdAt	string	ISO 8601 timestamp when data block was created

info

For a complete list of available data block types and their schemas, see Core concepts: Data blocks.

Example

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

Notes

• Data blocks are sorted by createdAt timestamp by default
• Both input data blocks (provided at session creation) and output data blocks (generated during execution) are returned
• Data blocks are linked to the steps that created them via the createdByStep field
• All access attempts are logged for auditability and compliance