Liveness History
This endpoint retrieves the captured image and video clip generated during a completed Liveness Check.
GET {{baseurl}}/v2/api/identity/liveness
Header
Field
Type
Description
token
String
Your API secret token used for authentication.
Query Parameters
Field
Type
Description
page
String
Page number of the requested data.
Default value: 1
limit
String
Number of logs to return.
Default value: 20
sessionId
String
Optional filter to fetch logs for a specific session ID.
Found Response:
HTTP/1.1 200 OK
{
"success": true,
"statusCode": 200,
"message": "All liveness data retrieved successfully!",
"data": {
"docs": [
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1758189745918-OjZKC2OsiuoQKQkqCR73m.jpg",
"livenessClip": "https://cdn.youverify.co/1758189745919-ipJqWMP5qQ2jnZo-w9NEi.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-09-18T10:02:27.216Z",
"_createdAt": "2025-09-18T11:02:2727+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68cbd8b20f3dc9d9bd19f9fd"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756286367492-yboWGB_SLWXTWMdCh1rP4.jpg",
"livenessClip": "https://cdn.youverify.co/1756286367492-IaahaXH1MlpIgkw3r90PX.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T09:19:28.605Z",
"_createdAt": "2025-08-27T10:19:2828+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68aecda0bb5875becc5717cb"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756285023782-WJaN52tUs_-LLH02Aq3Uj.jpg",
"livenessClip": "https://cdn.youverify.co/1756285023783-ynt_QKY4FD2Ite3HypOPm.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T08:57:05.083Z",
"_createdAt": "2025-08-27T09:57:055+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68aec860bb5875becc5717c8"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756284932298-hsQIIW2JjevtXs9b71yPE.jpg",
"livenessClip": "https://cdn.youverify.co/1756284932298-VWHfk23CU7-QwYraF4_Az.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T08:55:33.583Z",
"_createdAt": "2025-08-27T09:55:3333+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68aec804bb5875becc5717c5"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756276554363-VxQls_r_1bSMRjbAWh1DC.jpg",
"livenessClip": "https://cdn.youverify.co/1756276554364-ekxm7N4peQJnY_QI7hR6l.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T06:35:55.307Z",
"_createdAt": "2025-08-27T07:35:5555+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68aea74abb5875becc5717c1"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756275900961--XdhSnHdW9CyFLxdDTutI.jpg",
"livenessClip": "https://cdn.youverify.co/1756275900962-ktsHjn9LEr1X_QzFpaLaa.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T06:25:02.916Z",
"_createdAt": "2025-08-27T07:25:022+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68aea4bebb5875becc5717be"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756274164295-ekNggOUZpFaddcliDTl-n.png",
"livenessClip": "https://cdn.youverify.co/1756274164296-hEBpGGovdqeBJXK-JeRT3.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-27T05:56:05.783Z",
"_createdAt": "2025-08-27T06:56:055+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68ae9df5bb5875becc5717bb"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756220139792-T-5Eh61IUwIHNFp3arrRv.jpg",
"livenessClip": "https://cdn.youverify.co/1756220139792-34QNEXSL07mbzvGBNCV98.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-26T14:55:40.799Z",
"_createdAt": "2025-08-26T15:55:4040+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68adcaec0272ef5315dd3611"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756219607690-UhhWdHFCPGRMw17uF8Bfc.jpg",
"livenessClip": "https://cdn.youverify.co/1756219607691-PDuqkpo_MKYcXrzoY4E0K.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-26T14:46:49.325Z",
"_createdAt": "2025-08-26T15:46:4949+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68adc8d80272ef5315dd360e"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756207223488-WugAqy8LrO9mI6JxqrGS9.jpg",
"livenessClip": "https://cdn.youverify.co/1756207223490-pps9m7e5CdsjlWMri6qBJ.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-26T11:20:24.529Z",
"_createdAt": "2025-08-26T12:20:2424+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68ad98788f3cd3be1a24a3e6"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1756207055078-vqyz3Aq-D76L6jHymjfaf.jpg",
"livenessClip": "https://cdn.youverify.co/1756207055079-2iqRMiMka8Dj0xKc1aXiW.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-26T11:17:36.426Z",
"_createdAt": "2025-08-26T12:17:3636+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "68ad97cf8f3cd3be1a24a3e3"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754992907670-duulsizSzp2JJpCAKJAmn.jpg",
"livenessClip": "https://cdn.youverify.co/1754992907671-hVmobt5fuapy8uVEvJbwA.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-12T10:01:49.387Z",
"_createdAt": "2025-08-12T11:01:4949+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "689b110c6631457edd1a4a25"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754992274984-6BFF_jUIfW8_5kPrYFE__.jpg",
"livenessClip": "https://cdn.youverify.co/1754992274984-vvCV872eyVAe5gfKlP2Rr.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-12T09:51:16.311Z",
"_createdAt": "2025-08-12T10:51:1616+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "689b0e936631457edd1a4a22"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754990666339-_T6-NOnWvVNe-rampLDwQ.jpg",
"livenessClip": "https://cdn.youverify.co/1754990666340-O0ww_aqDpxN0qZI_EmNAt.mp4",
"passed": true,
"country": null,
"sessionId": "8053d9aff1f50518b3d6e23972bcc2a7",
"createdAt": "2025-08-12T09:24:28.206Z",
"_createdAt": "2025-08-12T10:24:2828+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "689b084a6631457edd1a4a1f"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754939213136-ZJqVXOozQ9wUezXTBkGb3.jpg",
"livenessClip": "https://cdn.youverify.co/1754939213137-cY75DMgHf2lY0JXWnVv80.mp4",
"passed": true,
"country": null,
"createdAt": "2025-08-11T19:06:55.691Z",
"_createdAt": "2025-08-11T20:06:5555+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "689a3f4e6631457edd1a4a10"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754081661925-M9aprG4fcz2cz4h8IDDw8.png",
"livenessClip": "https://cdn.youverify.co/1754081661928-bbH7x3ETJ8WAJomBYimw6.mp4",
"passed": true,
"country": null,
"createdAt": "2025-08-01T20:54:22.800Z",
"_createdAt": "2025-08-01T21:54:2222+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "688d297e5d2696335a2678dd"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1754053451495-lTAi2zr7rKjUryxsl-_Ba.png",
"livenessClip": "https://cdn.youverify.co/1754053451496-ZkLa4iX8qHFiKNO5eec8Z.mp4",
"passed": true,
"country": null,
"createdAt": "2025-08-01T13:04:12.889Z",
"_createdAt": "2025-08-01T14:04:1212+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "688cbb4b5d2696335a2678d5"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1753951771311-OQEJoFXgIf3zNWJunTwEQ.png",
"livenessClip": "https://cdn.youverify.co/1753951771313-KZZxpwtRTA_gN7FXTu-Uk.mp4",
"passed": true,
"country": null,
"createdAt": "2025-07-31T08:49:34.786Z",
"_createdAt": "2025-07-31T09:49:3434+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "688b2e1d5d2696335a2678b7"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1753943139458-74gOjjrP_iK3D-Hp8O8-S.png",
"livenessClip": "https://cdn.youverify.co/1753943139460-nnGiIFqNZjmJIO4MriSeG.mp4",
"passed": true,
"country": null,
"createdAt": "2025-07-31T06:25:41.093Z",
"_createdAt": "2025-07-31T07:25:4141+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "688b0c645d2696335a2678a0"
},
{
"method": "liveness",
"faceImage": "https://cdn.youverify.co/1753943081394-_O2U5dE9AZZ_D2gqwKAoO.png",
"livenessClip": "https://cdn.youverify.co/1753943081397-6bSqWEqbv9NheNlK9ufQy.mp4",
"passed": true,
"country": null,
"createdAt": "2025-07-31T06:24:43.096Z",
"_createdAt": "2025-07-31T07:24:4343+01:00",
"_lastModifiedAt": "2025-09-18T12:49:2727+01:00",
"id": "688b0c2a5d2696335a26789d"
}
],
"pagination": {
"totalDocs": 630,
"perPage": 20,
"totalPages": 32,
"currentPage": 1,
"serialNo": 1,
"hasPrevPage": false,
"hasNextPage": true,
"prevPage": null,
"nextPage": 2
}
},
"links": []
}Other Error Response:
HTTP/1.1 404 NotFound
{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}Last updated
Was this helpful?