GET STARTED
Introduction
Learn how you can prevent fraud and improve user experiences with Trustfull.
What is Trustfull?
Trustfull is a fraud prevention and identity risk intelligence platform for mid-market and enterprise businesses. It analyzes email addresses, phone numbers, IP addresses, devices, and behavioral signals in real time to identify fake users, bots, and high-risk activity. Risk scores and reason codes help teams block abuse or apply additional checks.
How Trustfull works
Trustfull offers five ways to submit data and receive a score. This page explains each method and how to get started.
If you are new here, read The Free Trial and Before You Start, then work through Your First Steps in order. Together, these sections take you from account setup to your first score.
Prefer a worked example? Start with Recipes.
The Free Trial
You can try Trustfull before you pay anything.
Every new account includes a 15-day free trial and 50 € of credit. You can use this credit for any Trustfull lookup.
Each lookup deducts a small amount from your balance, so 50 € covers multiple lookups while you evaluate the service. Trial credit works like purchased credit across all integration methods on this page.
Before You Start
You need three things. No integration works without them.
| What you need | How to get it |
|---|---|
| A Trustfull account | You can open an account using the signup link or book a demo with our sales team. |
| An API key | Open the Dashboard and look under API Keys. It is also called an App Key. |
| Credit on your balance | A new account starts with 50 € of free credit. Every lookup spends a little of it. See Billing to add more. |
Keep your API key on your serverThe API key identifies your account. Anyone who holds it can spend your credit.
Never put the key in browser code. Never put it in a mobile app. Never put it in a public repository. Send every request from your own backend.
The Five Integration Methods
All five send Trustfull much the same kind of data. What changes between them is who does the sending, and how many records travel at a time.
| Method | Use it when | You need | Page |
|---|---|---|---|
| REST API | You want a score inside your own product, in real time. | A backend and an API key. | Your First API Call |
| Run Check | You want to check one person by hand. | The dashboard only. | Run Check |
| Uploads | You want to check many people at once. | A CSV file. | Uploads |
| MCP Server | You want an AI assistant to run the checks. | An MCP client. | MCP Server |
| JavaScript SDK | You want browser and device signals. | A page you can edit. | Session Integration |
REST API
This is the main integration method, and it is the one most customers build on. Your backend sends a request, and Trustfull sends a score back.
Every request goes to https://api.fido.id, with your key in the x-api-key header.
Start with Your First API Call. It shows a working request in cURL, Python, and Node.js. Then read the reference page for the product you want, such as Trustfull Phone or Trustfull Email.
Run Check
Run Check lives in the dashboard. You type in a phone number or an email address by hand, and Trustfull runs the check and shows you what comes back.
This is a real lookup rather than a preview, so it returns exactly what the API would return, and it costs the same credit.
It is the quickest way to see what Trustfull actually gives you, before you commit to writing any code. See Run Check.
Uploads
Uploads takes a CSV file and runs the same check on every row in it.
Use Uploads to score a list of records without calling the API for each one. A single file can hold up to 200,000 rows.
See Uploads for the file format and the rules.
MCP Server
The MCP Server connects an AI assistant to Trustfull so it can score a phone number, email address, or IP address during a conversation.
Use it for agent-led fraud workflows. See MCP Server.
JavaScript SDK
The other four integration methods submit data you already have. The JavaScript SDK collects additional browser and device signals.
Add the script to your page to collect these signals during a visit. Your backend then submits them to Trustfull for analysis.
Use the SDK to detect bots and automated signups. See Session Integration and the recipe Approve or reject a signup.
Your First Steps
Follow these five steps in order. They work for every integration method.
1. Get your API key
Open the Dashboard and look under API Keys.
If there is no key waiting for you there, click Ask AI in the dashboard header and say so. The assistant will get one issued for you.
Your 15-day trial begins when the account is created, and the 50 € credit is added automatically.
2. See a result before you write code
Open Run Check in the dashboard and run a single check by hand.
This result will help you understand the response format used in the next step.
3. Test without spending credit
Send your first requests to the Sandbox.
The sandbox costs nothing and returns made-up data. You choose which answer comes back by setting the customer_id field to high, good, moderate, bad or poor.
You can build and debug the integration without spending credit.
For a worked example, see Make a sandbox call.
4. Make one real call
Follow Your First API Call and send a single real request to https://api.fido.id.
Check that a score comes back, and that your own code reads it correctly. This one is paid for out of your free credit.
The recipe Assess the risk of a mobile phone number walks through the same call step by step.
5. Learn to read the answer
Use reason codes alongside the score to understand the result.
Read Understanding Scores and Reason Codes.
The recipe Understand a score decision using reason codes shows how to do this against a real response.
Which Integration Method Should I Choose?
| Your situation | Use this |
|---|---|
| I want a score during signup, in real time. | REST API |
| I want to score a list of past customers. | Uploads |
| I want to look at one suspicious person. | Run Check |
| I want to catch bots on my signup page. | JavaScript SDK |
| I want my AI agent to do the checking. | MCP Server |
| I only want to try Trustfull out. | Run Check, then the Sandbox. Your free credit covers the Run Check. |
You can combine methods. For example, use the REST API for live traffic and Uploads to process historical data.
Recipes
A recipe is a short worked example that you can follow from start to finish. Start with these recipes.
| Recipe | What it shows you |
|---|---|
| Make a sandbox call | Your first request, with no credit spent. |
| Assess the risk of a mobile phone number | A complete phone lookup, from request to answer. |
| Understand a score decision using reason codes | Why a score came out the way it did. |
| Approve or reject a signup | Turning a score into a yes or no at registration. |
| Create a custom scorecard | Scoring on your own rules rather than the standard ones. |
| Tune API latency with max_enrichment_time | Trading a little accuracy for a faster answer. |
| How to access a dataset | Downloading the bulk datasets from S3. |
FAQ
Is there a free trial?Yes. Every new account gets one, and it runs for 15 days.
Trustfull also adds 50 € of credit when the account opens, so you can start making real lookups immediately.
What can I spend the 50 € on?You can use it for any lookup through any integration method on this page. Trial credit works the same as purchased credit.
Does the trial cost me anything?No. Trustfull puts the 50 € on your account, and you are not charged for it.
If your free trial credit is missingIf the 50 € free trial credit does not appear in your dashboard balance, click Ask AI in the dashboard header. The assistant will help resolve the issue or create a support ticket for our team to investigate.
You do not need to contact support separately.
How do I get an API key?An API key is usually available in the Dashboard, under API Keys.
If there is no key, click Ask AI in the dashboard header. The assistant will issue one or forward the request to the appropriate team.
Can I try Trustfull without writing any code?Yes. Use Run Check in the dashboard. You type in the data by hand, and you get a full result back.
You still need an account, an API key and credit. A Run Check costs the same as an API call.
How do I authenticate?Put your API key in the
x-api-keyheader. Every request needs it.There is no login step and no token to refresh. The key is enough.
Can I use more than one integration method?Yes. They all use the same account, the same key and the same credit balance.
A common pattern is the REST API for live traffic, and Uploads for a backlog of past customers.
Which integration method is fastest?The REST API. It answers in real time, so you can use it while a user waits.
Uploads processes large batches in the background and does not return results in real time.
Do I need a separate key for each product?No. One API key covers every product your account is allowed to use.
If a product returns no data, it may not be enabled for your account. Click Ask AI in the dashboard header to check.
What happens if a request fails?The API returns an HTTP status code that explains the problem. See HTTP Status Codes.
Related
- Your First API Call — a working request, step by step.
- Sandbox — test without spending credit.
- Uploads — score many people from a CSV file.
- Understanding Scores — what the number means.
- Billing — how credit works.
- Make a sandbox call — a short worked example.
Updated 7 days ago