Get Selfie

Returns the biometric selfie captured by the user during the Unico-hosted journey. The image is returned as a base64-encoded string with a watermark applied.

Only available for processes that executed biometric capture (any flow that includes Liveness or Identity Verification). Not available for Smart Revalidation flows (idsmart).

Endpoint

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

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/selfie \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

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

Responses

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Field	Type	Description
fileContents	string (base64)	The captured selfie, base64-encoded. Contains a watermark.
contentType	string	MIME type of the image — image/jpeg or image/png.

Error Codes

note

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

400 Bad Request

The processId path parameter is missing or malformed.

401 Unauthorized

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

403 Forbidden

Insufficient permissions to access the selfie for this process.

404 Not Found

Process not found, or the selfie is not available for this process (e.g. Smart Revalidation flow).

What's next

• For the full process result, see Get Process.
• For the evidence audit bundle, see Get Evidence Set.