Skip to main content

Retrieving video binary files after provision

This file is provided, when identification was conducted in video with a recording of the session from the agent's point of view.

Requirements

This file is provided, when final status from video is 6 or 89 and the recording requirement was set either in the Add element of the putOrder request or globally configured in the account for legal (e.g. German AML) compliance by IDnow.

Furthermore, if you did not request provisioning of the file or did not wait for the callback to happen before calling this function, you might get a placeholder video instead.

Method and URL

[GET] https://customer.identity.tm/api/2.10/getVideoFileBinary/[OrderID]
[GET] https://customer.identity.tm/api/2.10/getVideoFileBinary/[OrderID]/crypt

Variants

VariantDescription
DefaultNormal variant, response as described
cryptEncrypt response content using AES-256/GCM/NoPadding and a 23 byte long IV prefixed to the encrypted content.

This variant can be used in combination with the other variants.

HTTP Codes

200 OK, binary video file (video/mp4 or video/webm) in body

400 Bad request, error description in body

401 Authentication failed, please check username and password

404 Order not found