/v1/attempts/{id}/media

  • Updated on Mar 18, 2025
Get
/v1/attempts/{id}/media

Returns a list of media objects associated with the specific attemptId = {Id}

The list of objects are sorted based on their accuracy (e.g., does an image match the required image type) and their quality. The order is determined by the automation system.

To find a specific attemptId, call the list of attemptId-s from GET sessions/{sessionId}/attempts endpoint


Note: always ensure that you use the correct API URL to send requests. See the API URL section for more info.


Security
API Key
Header parameter namex-auth-client

Your integration's API key (occasionally referred to the "Token", "API public key" or "Publishable key")

Header parameters
x-hmac-signature
stringRequired

Attempt id signed with the shared secret key

Path parameters
id
stringRequired

Attempt id

Responses
200
Expand All
object
status
string

API request status

Examplesuccess
images
Array of object (VerificationSessionImageUpload)
object
id
string (uuid)

UUID v4 which identifies the uploaded media

Exampled69a07cf-4434-4d36-be6c-d22af7dc01fb
name
string

Name which identifies the uploaded media

Valid values[ "document-and-face", "document-and-face-pre", "document-back", "document-back-pre", "document-front", "document-front-pre", "document-front-with-signature", "document-front-with-signature-pre", "face", "face-pre", "face-nfc", "face-reference", "address-front", "document-front-face-cropped" ]
Exampledocument-front
context
string

Context type of the uploaded media

Valid values[ "document-and-face", "document-and-face-pre", "document-back", "document-back-pre", "document-front", "document-front-pre", "document-front-with-signature", "document-front-with-signature-pre", "face", "face-pre", "face-nfc", "face-reference", "address-front", "document-front-face-cropped" ]
Exampledocument-front
timestamp
string Deprecated

*Always returns None/null

Examplenull
size
number

Size of the uploaded media, in bytes

Example12345
mimetype
string

File type of the uploaded media, one of .jpg, .jpeg, .png, .heif, .heic, .webp or .pdf

Exampleimage/jpeg
url
string

Download URL of the media

Examplehttps://api.veriff.com/v1/media/d69a07cf-4434-4d36-be6c-d22af7dc01fb
sessionId
string

UUID v4 of the verification session the uploaded media belongs to

Exampled69a07cf-4434-4d36-be6c-d22af7dc01fb
videos
Array of object (VerificationSessionVideoUpload)
object
id
string (uuid)

UUID v4 which identifies the uploaded media

Exampled69a07cf-4434-4d36-be6c-d22af7dc01fb
name
string

Name which identifies the uploaded media

Valid values[ "document-and-face", "document-and-face-pre", "document-back", "document-back-pre", "document-front", "document-front-pre", "document-front-with-signature", "document-front-with-signature-pre", "face", "face-pre", "face-nfc", "face-reference", "address-front", "document-front-face-cropped" ]
Exampleselfid_video
context
string

Context type of the uploaded media

Valid values[ "document-and-face", "document-and-face-pre", "document-back", "document-back-pre", "document-front", "document-front-pre", "document-front-with-signature", "document-front-with-signature-pre", "face", "face-pre", "face-nfc", "face-reference", "address-front", "document-front-face-cropped" ]
Exampleselfid_video
timestamp
string Deprecated

*Always returns None/null

Examplenull
size
number

Size of the uploaded media, in bytes

Example12345
mimetype
string

File type of the uploaded media

Examplevideo/mp4
url
string

Download URL of the media

Examplehttps://api.veriff.com/v1/media/d69a07cf-4434-4d36-be6c-d22af7dc01fb
sessionId
string

UUID v4 of the verification session the uploaded media belongs to

Exampled69a07cf-4434-4d36-be6c-d22af7dc01fb
duration
number (integer)

Duration of the uploaded media, in seconds

Example12345
400

Bad request

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleValidation failed
401

Unauthorized

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleMandatory X-AUTH-CLIENT header containing the API key is missing from the request.
404

Attempt not found

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleResource not found
500

Internal server error

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleSomething went wrong