API

FuseAI API Documentation

Uncover your website visitors and plug into a 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

{
  "message": "Data fetched successfully",
  "data": [
    {
      "id": UUID,
      "bulkListTitle": "My contacts",
      "enrichType": "all",
      "progress": 100,
      "creditsConsumed": 250,
      "completed": true,
      "createdAt": "2025-05-13T14:05:24.985Z",
      "completedAt": "2025-05-13T14:05:47.439Z",
      "numberOfContacts": 1
    },
    {
      "id": UUID,
      "bulkListTitle": "LinkedIn contacts",
      "enrichType": "all",
      "progress": 100,
      "creditsConsumed": 0,
      "completed": true,
      "createdAt": "2025-05-27T04:28:39.033Z",
      "completedAt": "2025-05-27T04:28:57.139Z",
      "numberOfContacts": 1
    }
  ]
}

GET /api/v1/bulk_enrichment/:bulkListId

Retrieve one bulk enrichment by id.

Request

curl https://api.tryfuse.ai/api/v1/bulk_enrichment/:bulkListId -H 'Authorization: Basic <TOKEN>'

Response

{
  "message": "Data fetched successfully",
  "data": {
    "id": UUID,
    "bulkListTitle": "My contacts",
    "enrichType": "all",
    "progress": 100,
    "creditsConsumed": 250,
    "completed": true,
    "createdAt": "2025-05-13T14:05:24.985Z",
    "completedAt": "2025-05-13T14:05:47.439Z",
    "contacts": [
      {
        "firstName": "imogen",
        "lastName": "low",
        "jobTitle": "co-founder & chief technology officer",
        "level": "cxo, owner",
        "department": null,
        "industry": "computer software",
        "location": "san francisco, california, united states",
        "linkedIn": "https://linkedin.com/in/imogen-low",
        "company": {
          "name": "fuseai",
          "industry": "computer software",
          "website": null,
          "domain": null,
          "location": true,
          "headCount": true,
          "revenue": true
        },
        "emails": [
          {
            "email": "imoger@test.com",
            "status": "work | personal | valid | invalid | do_not_mail | catch-all"
          }
        ],
        "phones": [
          {
            "phone_number": "+16319355935",
            "status": "valid | invalid"
          }
        ]
      }
    ]
  }
}

POST /api/v1/bulk_enrichment

Run bulk enrichment.

Body with LinkedIn URLs

{
          "bulkListTitle": "Example by LinkedIn",
          "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>'

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>'

Body with a list of contacts

{
          "bulkListTitle": "Example by person data",
          "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 enrich started, ETA: 2 mins call GET_ENRICH_URL",
  "data": {
    "bulkListid": UUID
  }
}

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
  }
}

Book a Demo