background image pattern

Developer news

News KYC API v2: Upcoming changes for US-MD (Maryland) live search and refresh dataset 

KYC API v2: Upcoming changes for US-MD (Maryland) live search and refresh dataset 

Posted 2025-07-31

Summary

Starting August 13, 2025, our US-MD (Maryland) search and refresh dataset operations will be migrated to asynchronous processing. This upgrade affects both liveSearch and refresh dataset operations and is designed to improve performance, system stability, and reliability for data retrieval in Maryland.

As part of this enhancement, responses will now return a 202 Accepted status with a PROCESSING state, and you will need to use polling or callback mechanisms to retrieve results once processing is complete.

Live Search Availability

This enhancement is designed to improve performance and reliability in jurisdictions where live data retrieval may take longer. By returning a 202 Accepted status and allowing results to be retrieved once ready, we can ensure more consistent response times and greater system stability.

Once the live search is triggered, the following response is returned:

{
  "searchId": "sample--search-82736492",
  "countryCode": "US-MD",
  "searchMethod": "name",
  "searchValue": "sample search value",
  "status": "PROCESSING",
  "requestTime": "2025-07-29T13:32:44+00:00",
  "responseTime": "2025-07-29T13:32:45+00:00",
  "searchResults": []
}

Use liveSearch/{searchId} to retrieve the status of your live search or the search results once processing is complete.

Dataset Availability

Refresh dataset processing for US-MD will be migrated to asynchronous processing. This means the returned status code will be 202 instead of 200, and the response will include a PROCESSING status.

Use the dedicated endpoint dataset/{datasetId} to check the status of your dataset order or retrieve the dataset once processing is complete.

Callback Settings

If you prefer not to use polling, you can use our dedicated Callback Settings endpoints to configure a callback. This allows us to notify you automatically when your orders are completed.

Both liveSearch and dataset are supported as affectedService options.

Once your live search or dataset order is completed, you will receive a notification via one of the following callback types:

  • stream
  • webhook-post
  • webhook-get

Useful links

  • To get more information on the Search endpoint, please visit Search Endpoint Guide .
  • To get more information on how the Dataset endpoint functions, visit Dataset Endpoint Guide .
    • If you would like to provide us with feedback or you have a question related to this connection, contact us here: support team
    Next