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

Stay up to date with changes to the Vlens API, documentation, and platform.

September 1, 2025

September 1, 2025

New features

Webhooks — App.BusinessRequestStatusChange

Tenants can now subscribe to contract lifecycle events via the Vlens portal. When a business request changes status (e.g. PendingApprovalApproved, ApprovedCustomerSigned), Vlens sends an HTTP POST to your configured endpoint.

Configure subscriptions under Webhook Subscriptions in the portal. Each delivery is logged with the source IP, headers, and body for debugging.

See the Webhooks guide for payload format and best practices.

Co-signer support

POST /api/BusinessRequest/Create/{typeId} now accepts customerSignersIdentifiers — a list of additional customers who must co-sign the contract. Use minimumRequiredSignatories to define how many must sign for the contract to be valid.

Business request retrieval by ID

GET /api/BusinessRequest/GetBusinessRequestById/{id} is now available, returning full contract details for any request by UUID — not limited to the current user’s active request.

Enhancements

  • Admin endpoint GET /api/DigitalIdentity/GetUserDigitalIdentityImages now returns livenessFace01Image, livenessFace02Image, livenessFace03Image alongside the existing liveness composite image
  • POST /api/BusinessRequest/Create/{typeId} response now includes relatedBusinessRequest for request types with configured sub-contracts

Documentation