Skip to main content

Retrieving audio binary files

In some countries it is sufficient, to have an audio recording instead of a video file. In these cases, the configuration will be made by IDnow for the given account. An audio recording cannot be requested with the putOrder request.

Method and URL​

[GET] https://customer.identity.tm/api/2.10/getVoiceFiles/[OrderID]
[GET] https://customer.identity.tm/api/2.10/getVoiceFiles/[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, JSON document in body

401 Authentication fails, please check username and password

400 Bad request, error description in body

404 Order not found

Example Request​

[GET] https://customer.identity.tm/api/2.10/getVoiceFiles/99920006C38842

Example Response​

{
  "Voicefiles": [
    {
      "Filename": "sound_4348.mp3",
      "Base64Data": "//uQBAAAAA......."
    }
  ]
}