background image pattern

Developer news

News KYC API v2: Introducing estimatedDeliverySeconds feature

KYC API v2: Introducing estimatedDeliverySeconds feature

Posted 2025-01-22 | Updated 2025-01-23

Summary

We have introduced a new feature – estimatedDeliverySeconds to our KYC API v2, available with the 15th of January 2025’s release. This field can be found in the response of the POST Dataset order and GET Dataset retrieval endpoints, as well as in the POST Enhanced and POST Product order and the coverage endpoint.

This feature aims to increase transparency and manage clients’ expectations regarding delivery times for both datasets and products. Additionally, it is integrated into our coverage endpoint, providing an in-depth overview of our offerings per jurisdiction.

How

The calculation behind the estimatedDeliverySeconds is based on the 90 percentile of all requests for this dataset or product, in the past year. Please be aware that calculation is covering 90% of the cases within which we could return the response in the specified timeframe. The rest of the 10% are not covered (outliers that can take much longer or shorter) and therefore the estimates can be used as an orientation. This estimate is dynamic and may differ based on the point of time of the requests.


Change

Previously the field was always showing 0 in the POST Dataset order and GET Dataset retrieval endpoints, as well as in the POST Enhanced order. Moreover the field was showing 0 for the POST Product order. Now, we are populating an actual number based on the the past year’s requests.


Response before

  "datasetId": "C6CBF6376A35D40A2620C2007064D86C",
  "kompanyId": "D4ACA60BF8ABD55642E55EA1AEA61397",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-01-22T08:04:41+00:00",
  "responseTime": "2025-01-22T08:04:49+00:00",
  "estimatedDeliverySeconds": 0,

Response now (as-is)

  "datasetId": "C6CBF6376A35D40A2620C2007064D86C",
  "kompanyId": "D4ACA60BF8ABD55642E55EA1AEA61397",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-01-22T08:04:41+00:00",
  "responseTime": "2025-01-22T08:04:49+00:00",
  "estimatedDeliverySeconds": 27,


If you would like to provide us with feedback or you have a question related to this, contact us here: support team.

Next