API
API
FuseAI API Documentation
Plug into a real-time contact database of 700M+ contacts with 100% verified email and phone data
🔐 API Rate Limits
FuseAI API enforces a rate limit on POST requests: 50 per minute and 2000 per day.
🔐 Authentication
This API uses Basic Authentication. Each request must include the Authorization header with your token.
Authorization: Basic <TOKEN>'📦 Base URL
FuseAI API enforces a rate limit on POST requests: 50 per minute and 2000 per day.
https://api.tryfuse.ai📄 Endpoints
GET /api/v1/bulk_enrichment
Retrieve a list of bulk enrichments.
Request
curl https://api.tryfuse.ai/api/v1/bulk_enrichment -H 'Authorization: Basic <TOKEN>'Response
{
"code": 200,
"message": "List Fetched Successfully",
"data": {
"lists": [
{
"_id": "687f32e66dfb1c3242b26212",
"name": "Custom Contacts",
"entityType": "contactList",
"status": "public",
"isDynamic": false,
"completionStatus": "complete",
"companies": 0,
"contacts": 4,
"createdBy": "6613b22c91999bd165ef1111",
"isArchived": false,
"customColumns": [],
"exaList": [],
"createdAt": "2025-07-22T06:38:30.759Z",
"updatedAt": "2025-07-22T06:39:34.415Z"
},
]
"createdByData": {
"6613b22c91999bd165ef1111": [
{
"_id": "6613b22c91999bd165ef1111",
"userName": "Test User"
}
],
},
"totalRecords": 1,
"totalPages": 1
}
}GET /api/v1/bulk_enrichment/:bulkListId
Retrieve one bulk enrichment by id.
Request
// supports pagination query params: limit, pageNum, sortBy, sortOrder
curl https://api.tryfuse.ai/api/v1/bulk_enrichment/:bulkListId -H 'Authorization: Basic <TOKEN>'Response
{
"code": 200,
"message": "List Fetched Successfully",
"data": {
"listTitle": "Bulk list 1",
"listData": [
{
"_id": "6885db06b06cbb2ab8dba87e",
"firstName": "test",
"lastName": "test",
"linkedIn": "linkedin.com/in/test",
"jobTitle": "co-founder",
"company": {
"_id": "67c6172067726915f3445ff3",
"name": "test",
"domain": "test.com",
"industry": "computer software",
"address": {
"city": "san jose",
"state": "california",
"country": "united states"
}
},
"address": {
"city": "sydney",
"state": "new south wales",
"country": "australia"
},
"level": "owner",
"industry": "computer software",
"department": "operations",
"subDepartment": "executive",
"createdAt": "2025-08-08T11:09:58.971Z",
"updatedAt": "2025-08-08T11:15:19.150Z",
"isCustom": false,
"emails": [
{
"email": "test@test.com",
"status": "catch-all",
},
],
"phones": [
{
"phoneNumber": "+18587777777",
"status": "valid",
}
],
"primaryEmail": "test@test.com",
"primaryPhone": "+18587777777",
"lastPhoneEnrichment": "2025-08-08T11:15:17.813Z",
"lastEmailEnrichment": "2025-08-08T11:15:17.813Z",
"campaignStatus": "Never contacted"
}
],
"totalRecords": 1,
"totalPages": 1,
"pageNum": 1
}
}POST /api/v1/bulk_enrichment
Run bulk enrichment.
Body with LinkedIn URLs
{
"bulkListTitle": "Example by LinkedIn",
// supported values for enrichType: all, email, phone
"enrichType": "all" ,
"inputs": [
{ "url": "https://linkedin.com/in/imogen-low" },
{ "url": "https://www.linkedin.com/in/maikal-yamauchi/" }
]
}Request:
curl 'https://api.tryfuse.ai/api/v1/bulk_enrichment' --data-raw '{"bulkListTitle":"New list","inputs":[{"url":"https://linkedin.com/in/imogen-low"},{"url":"https://www.linkedin.com/in/maikal-yamauchi/"}],"enrichType":"all"}' -H 'Authorization: Basic <TOKEN>'Response:
{
message: "Bulk enrichment triggered successfully, estimated waiting time: 3 minutes",
data: { listIds: ["6854103f722564a69c4e3b16"], enrichType: "all" },
}Body with a list of contacts
{
"bulkListTitle": "Example by person data",
// supported values for enrichType: all, email, phone
"enrichType": "all",
"inputs": [
{ "name": "Imogen Low", "company": "KompassAI", "location": "San Francisco" },
{ "name": "Saurav Bubber", "company": "Stealth Startup", "location": "San Francisco" }
]
}Request:
curl 'https://api.tryfuse.ai/api/v1/bulk_enrichment' --data-raw '{"bulkListTitle":"New list","inputs":[{"name":"Imogen Low","company":"KompassAI","location":"San Francisco"},{"name":"Saurav Bubber","company":"Stealth Startup","location":"San Francisco"}],"enrichType":"all"}' -H 'Authorization: Basic <TOKEN>'Response:
{
message: "Bulk enrichment triggered successfully, estimated waiting time: 3 minutes",
data: { listIds: ["6854103f722564a69c4e3b16"], enrichType: "all" },
}GET /api/v1/email_validation
Returns all email validation results.
Request
curl https://api.tryfuse.ai/api/v1/email_validation/:emailsListId -H 'Authorization: Basic <TOKEN>'Response:
{
"message": "Data fetched successfully",
"data": {
"id": UUID,
"completed": true,
"progress": 100,
"userId": UUID,
"emailsListTitle": "Verify1",
"createdAt": "2025-05-27T04:22:30.707Z",
"completedAt": "2025-05-27T04:22:47.995Z",
"creditsConsumed": 15,
"emails": [
{
"email": "disposable@example.com",
"status": "do_not_mail"
},
{
"email": "invalid@example.com",
"status": "invalid"
},
{
"email": "valid@example.com",
"status": "valid"
}
]
}
}GET /api/v1/email_validation/:emailsListId
Retrieve one emails list validation by id.
Request
curl https://api.tryfuse.ai/api/v1/email_validation/:emailsListId -H 'Authorization: Basic <TOKEN>'Response:
{
"message": "Data fetched successfully",
"data": {
"id": UUID,
"completed": true,
"progress": 100,
"userId": UUID,
"emailsListTitle": "Verify1",
"createdAt": "2025-05-27T04:22:30.707Z",
"completedAt": "2025-05-27T04:22:47.995Z",
"creditsConsumed": 15,
"emails": [
{
"email": "disposable@example.com",
"status": "do_not_mail"
},
{
"email": "invalid@example.com",
"status": "invalid"
},
{
"email": "valid@example.com",
"status": "valid"
}
]
}
}POST /api/v1/email_validation
Trigger validation list of emails.
Request
Body:
{
"emails"*: [
{ "email": "valid@example.com" }
],
"emailsListTitle"*: "Validate emails"
}
curl https://api.tryfuse.ai/api/v1/email_validation -X 'POST' --data-raw '{"emails":[{"email":"valid@example.com"}],"emailsListTitle":"Validate emails"}' -H 'Authorization: Basic <Token>'Response:
{
"message": "Email validation started.",
"data": {
"emailsListId": UUID
}
}