Get Evidence Set

Returns the evidence bundle generated during the biometric capture — a package containing the captured images, metadata, and capture artefacts used to prove that liveness detection was performed under controlled conditions.

Only available for completed processes (state = PROCESS_STATE_FINISHED).

Endpoint

Environment	URL
Production	GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

Request

Headers

Header	Value
Authorization	Bearer <access_token> (see Authentication)

Path parameters

Parameter	Type	Required	Description
processId	string (UUID)	yes	Process identifier returned by Create Process.

Example

cURL

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

Responses

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

Field	Type	Description
fileContents	string (base64)	The evidence bundle, base64-encoded.
contentType	string	MIME type — typically application/pdf.

400 Bad Request

The processId path parameter is missing or malformed. See Error Codes below.

401 Unauthorized

Bearer token missing, expired, or invalid. See Authentication.

404 Not Found

Process not found, or the evidence set is not yet available (process not finished).

Error Codes

note

The API does not expose specific code or message values for this endpoint.

400 Bad Request

No specific code or message values are documented for this status.

401 Unauthorized

No specific code or message values are documented for this status.

404 Not Found

No specific code or message values are documented for this status.

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	When there is an internal error.

What's next

• For the full process result, see Get Process.
• For the captured selfie image, see Get Selfie.