How to adjust the data enrichment timeout

Timeouts define the total amount of time a server should wait for a response from a service. You have to keep two timeouts in mind when setting up SEON: your integration timeout, and the Email and Phone API timeout. Learn how to change the latter below.

Timeouts affect the accuracy of the information SEON can provide to help you fight fraud but have to be balanced with your customers' user experience. Every business has a different risk appetite, and we've designed SEON to fit every need. Check our integration guide for a deep dive into timeouts and how they affect results.

Your integration timeout is set on the client-side and tells your servers how long to wait for a response from SEON. It includes network latency and the time needed for SEON's data enrichment and scoring engine processes to run.

The Email and Phone API timeout is set in the SEON settings panel and tells our data enrichment process how long it should wait for a response from the sites and services it checks.

Did you know: You can find the average timeout of each service SEON checks on the Timeouts page. Scroll down to the Finetuning results with timeouts section.

As data enrichment is the most time-consuming part of the process, we recommend you to only implement it at the earliest access point of the customer (e.g. onboarding). 

it's also worth noting that data enrichment can be done async as well: as soon as we have the email/phone (Email and Phone API should be called individually), we can cache it for later, making response times much faster.

1. Head to the SEON Dashboard.

2. Open Settings.

3. Stay on the General tab.

4. Find the Email API / Phone API timeout box.

5. Type your preferred timeout in the textbox.

Tip: In SEON, all timeouts are measured in milliseconds (ms).

6. Click Save Settings to confirm your changes.

7. Monitor results and finetune the setting as needed.

For an overview of how different timeout settings affect results on average check our integration guide.