Skip to main content

Get Evidence Set

Markdown

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​

EnvironmentURL
ProductionGET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
SandboxGET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

Request​

Headers
HeaderValue
AuthorizationBearer <access_token> (see Authentication)
Path parameters
ParameterTypeRequiredDescription
processIdstring (UUID)yesProcess identifier returned by Create Process.

Example​

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf

Responses​

200 OK
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
FieldTypeDescription
fileContentsstring (base64)The evidence set PDF, base64-encoded.
contentTypestringCurrently returns x-pdf.
Building the PDF

x-pdf is not a valid MIME type, and browsers don't recognize it. Don't forward contentType to the browser. Decode fileContents from base64 and serve the bytes as application/pdf, as in the Node.js example above.

Error Codes​

note

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

The processId path parameter is missing or malformed.

What's next​