Skip to navigation

New features, enhancements, and fixes to the Vlens API and documentation

October 29, 2026

New features

ID card verification from a single PDF

The national ID can now be uploaded as one PDF that contains both the front and the back, instead of two separate images.

POST /api/FRAServices/PersonallyIdentifiableInformationPdf
Content-Type: multipart/form-data
file=@national-id.pdf
phoneNumber=01000000000
  • Required fields: file and phoneNumber. Optional: otpRequestId, otpCode, transactionId and bypassSpoofingCheck.
  • The file must be a real PDF and no larger than 5 MB.
  • The front and back are saved as the usual ID front and ID back steps, and the response is the same as for POST /api/FRAServices/PersonallyIdentifiableInformation.

The Check Phone Ownership page in the portal has a new Upload ID card as one PDF option — see Check Phone Ownership.

See Submit the ID as one PDF.

Business Requests: signed date filters

The Business Requests page has two new filters: Customer Signed Date Range and Service Provider Signed Date Range. GET /api/BusinessRequest/GetRequests supports the same filters: CustomerSignedFrom / CustomerSignedTo and ServiceProviderSignedFrom / ServiceProviderSignedTo.

See Business Requests and, for the API, Retrieve contracts.

Business Requests: Contract Name column

The Business Requests list, including child request rows, now shows a Contract Name column. See Business Requests.

Enhancements

Faster liveness GIF loading

The liveness GIF is now generated once and cached, so later views load faster.

Smaller scan step responses

API responses no longer include duplicate base64 copies of the scan step images (the ID image and the liveness faces).

If your integration read these duplicate base64 image fields from scan step responses, it will no longer find them there.

Landing page based on permissions (portal)

After login, or when opening an unknown link, users now go to the first page they have permission for. Before, everyone was sent to Transactions, and users without that permission saw a “permission denied” page. See Portal overview.

Bug fixes

  • OCR validation error 5008 (Data Misassigned) is no longer replaced with the generic 5000 (General Error). Clients now receive the real error code and message. See Error codes