Overview

Unlock automated fraud prevention while staying in complete control with SEON's APIs. Integrating our APIs is as easy as pie and this process can be completed in a matter of hours. We've collected everything you need to complete technical integration on this page.

API basics

Application Programming Interfaces (APIs) help different applications communicate with one another. 

All SEON's APIs follow the REST protocol (REpresentational State Transfer). REST APIs are great for cloud applications because they are based on the Uniform Resource Identifiers (URIs) and HTTP protocols and use JSON for data formatting.

Learn more: Discover the basics of APIs and learn more about RESTful APIs.

APIs make SEON quick, easy, and painless to integrate with your systems. They work as the connective layer to enable different applications to easily connect together to share data seamlessly. This means that regardless of your current setup and applications used, SEON’s APIs can easily plug and play into your existing workflow.

Simply add an API request when you need information from SEON and create the logic to parse information from the response. 

Take a look at the table below to gauge who you'll have to involve. Time values are estimates and highly dependent on the complexity of your integration:

SEON's APIs

SEON's API-based architecture makes our solution extremely flexible. Integrate different APIs – with various unique parameters and timeouts – to different parts of your user journey. Prevent fraud by using the right tools at the right time.

Our most popular APIs you’ll come across are:

• Fraud API: SEON’s proprietary modular API combines our email, phone number, and IP APIs with device fingerprinting so that you can request and receive our enriched data, rules, and scoring in a single API call.
• Email API: Our standalone email enrichment tool that will help you learn about the approximate minimum age of an email address, its provider, and any connected online profiles.
• Phone API: Unlock insights into a user's phone number's history, and social or digital profiles connected to it, using SEON's standalone phone number enrichment solution.
• IP API: Identify suspicious VPN and proxy connections and pinpoint users with accurate geolocation information relying on our standalone IP address data enrichment API.
• AML API: Complement your fraud prevention toolkit with anti-money laundering tools. AML API makes anti-money laundering checks efficient and pain-free.
• Device Fingerprinting: Integrate our JS module or SDK for iOS or Android to learn about the devices your customers are using to access your service. Identify quirky configurations that may hide fraudsters before they can cause any damage.

Browser environmentMobile application

Learn more: Find a complete list of our APIs in our API reference.

Which SEON APIs to use

Use the table below to identify which APIs you should use at various touchpoints. Find the corresponding section of the page below for recommended API fields and integration tips.

Warning: Before you continue, please bear in mind that all SEON API formatting is case-sensitive. Always follow the formatting provided below and in our API reference to avoid errors. 

Onboarding

Stop bad actors before they do harm by catching them at registration. Stop fake accounts, multi-accounting, bots, and bonus abuse with SEON. Confirm if new accounts are honest users with digital and social footprint checks using email addresses and phone numbers. Unlock information about their devices and connection with IP address lookup and device fingerprinting tools.

Here's an example setup to get you started. See our full API reference for all possible fields.

Note: We've created the recommendations below for integrations that include onboarding monitoring. If your integration does not monitor registrations you may want to consider adding further APIs and data fields to your integration.

Logins

Fight account takeover (ATO) attempts and protect your business from fraudulent transactions. ATOs can lead to fraudulent purchases and chargebacks, or unauthorized transfers or withdrawal of funds from accounts. Our transaction monitoring powered by our Rules and Scoring Engines makes recommendations to best defend your customers and your business.

Run device fingerprinting and IP address checks to learn where users are logging in and the devices they are using to spot suspicious changes.

Here's an example setup to get you started. See our full API reference for all possible fields.

Transaction monitoring

Monitor transactions including new orders, funds transfers, and withdrawals with SEON to block fraudulent activity. Use geolocation information, shipping address, payment option details, and device characteristics to uncover questionable purchases and strange account actions.

Here's an example setup to get you started. See our full API reference for all possible fields.

Credit scoring

People leave a trail of digital breadcrumbs across the internet as they sign up for services and social media with their email addresses and phone numbers. Unlock this wealth of information to accelerate credit scoring while cutting back on fraud, and lowering your risk indicators.

Run social and digital background checks using our industry-leading data enrichment tools. Unlock more information by providing as many data points as possible to our Email, Phone, and IP APIs.

Here's an example setup to get you started. See our full API reference for all possible fields.

Using the API Quick Start guide

You can rely on the configurator to give you a head start in building your API request and the logic to extract value from our response. 

The code samples provided are examples. Do not copy and paste them into your integration without customization.

Select the options that apply to your existing infrastructure, your industry, and the use case you are implementing. Then, click Show API references in the top right corner of the configurator.

You will now be forwarded to the corresponding section of the SEON API reference pages. Expand and look through the list of data fields and parameters on the left and browse the sample code and expected formatting on the right.

If you have any difficulty using the configurator, contact our team.

Resources

Everything you may need for integration that is not on this page can be found in one of our integration resources below.

Authentication

Our API uses a standard HTTP Authorization header. This protects your account and the data within it, so only you and SEON can access them.
 

You must authenticate all API requests using the following format: X-API-KEY: [license_key]

You can also find your unique license_key on the Organization page.

API timeouts

As with all API-based services, timeouts will affect the results you see while using SEON. Read our detailed overview of timeout settings and how timeouts will affect your data enrichment results for more information.

Learn more: Visit our Timeouts page for a breakdown of performance and settings.

Error codes

When your integration is not working properly, SEON will send error codes in its API response. Use these error messages to better understand what's wrong. Our team is ready to help if anything is unclear.

Learn more: Check our Error codes for more information.

Device Fingerprinting integration

You can easily integrate our device fingerprinting solutions using our java script agent for browser environments or our SDK for mobile apps. Head over to GitHub to find the code and everything you'll need for integration.

Learn more: Head over to GitHub for our Device Fingerprinting integration guide.

API status

As with all cloud-based tools, our systems can also be affected by internet and server outages. SEON maintains a high standard of uptime and service operations but if you think something might be wrong on our side, you can check the status of our services on the status page.

Learn more: Check the SEON status page for details.

Rate limits

We apply limits based on all requests with a specific license key, not individual API requests. Limits are 2 requests/second for trial accounts and 10 requests/second for paid users (by default). Our team can increase your limit on request.