Get Selfie

MarkdownChatGPTClaude

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.

Available for any finished process that executed a biometric capture, including Smart Revalidation journeys (idsmart). Not available when the process finished without a biometric capture (a silent authentication, for example), since there is no selfie to return.

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 process finished without a biometric capture, so there is no selfie to return.

What's next

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