Introduction

Welcome to the Exellius API. Our API provides comprehensive access to email, phone, and company enrichment data. Get started by reading the basics below and then dive into the specific endpoints you need.

API URL : https://api.exellius.com

API Structure

All API endpoints follow RESTful conventions and return JSON responses. Each request requires authentication via API key, passed as a Bearer token in the Authorization header.

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 20,
  "current_page": 1,
  "data": [ { ... } ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

success

Boolean indicating if the request completed successfully

data

Array of matching records for the request

total_count / per_page_count / current_page

Pagination details for list-based responses

credits_deducted / remaining_credits

Usage tracking for your API plan

Authentication

All requests require authentication using your API key. Include the key in the request header:

Authorization: Bearer YOUR_API_KEY

You can find your API key in your dashboard under Settings > API Keys.

Error Handling

Our API uses standard HTTP status codes to indicate the success or failure of an API request.

200 - OK

Request was successful

400 - Bad Request

Invalid request parameters

401 - Unauthorized

Authentication failed or missing

429 - Too Many Requests

Rate limit exceeded

500 - Server Error

Internal server error

Search People for Emails

Search for people matching a set of filters — industry, company, job title, location, and more — and return their verified email addresses.

Method

POST

Endpoint

/api/v1/people/search/email

Query Parameters

limit

The maximum number of results to return (e.g., 10)

Body Parameters

Parameter	Type	Values
includeIndustry Array of industries to include Optional	array
excludeIndustry Array of industries to exclude Optional	array
includeEmployeeCount Filter by company employee count range Optional	array
includeRevenue Filter by company annual revenue range Optional	object
includeManagementRole Filter by seniority or management level Optional	array
includeCompany Array of companies to include Optional	array
excludeCompany Array of companies to exclude Optional	array
includeDepartmentKeyword Filter by department keyword Optional	string
includePersonalCountry Array of countries to include Optional	array
excludePersonalCountry Array of countries to exclude Optional	array
includeCompanyLocation Array of company locations to include Optional	array
excludeCompanyLocation Array of company locations to exclude Optional	array
includeJobTitles Array of job titles to include Optional	array
excludeJobTitles Array of job titles to exclude Optional	array
includeTechnology Filter by technologies a company uses Optional	array
includeFirstName Filter by first name Optional	string
includeLastName Filter by last name Optional	string
search Free-text search across records Optional	string
funding Filter by company funding stage Optional	array
foundingYearOptions Filter by company founding year Optional	array
includeLinkedinUrl Filter by a specific LinkedIn profile URL Optional	string

Code Examples

cURL

curl -X POST "https://api.exellius.com/api/v1/people/search/email?limit=1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
    "includeIndustry": ["accounting"],
    "excludeIndustry": [],
    "includeEmployeeCount": null,
    "includeRevenue": null,
    "includeManagementRole": null,
    "includeCompany": [],
    "excludeCompany": [],
    "includeDepartmentKeyword": null,
    "includePersonalCountry": null,
    "excludePersonalCountry": null,
    "includeCompanyLocation": null,
    "excludeCompanyLocation": null,
    "includeJobTitles": null,
    "excludeJobTitles": null,
    "includeTechnology": null,
    "includeFirstName": null,
    "includeLastName": null,
    "search": null,
    "funding": null,
    "foundingYearOptions": null,
    "includeLinkedinUrl": null
  }'

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "all",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Example Request

POST /api/v1/people/search/email?limit=1

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "all",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Search People for Phones

Search for people matching a set of filters — industry, company, job title, location, and more — and return their phone contact details.

Method

POST

Endpoint

/api/v1/people/search/phone

Query Parameters

limit

The maximum number of results to return (e.g., 10)

Body Parameters

Parameter	Type	Values
includeIndustry Array of industries to include Optional	array
excludeIndustry Array of industries to exclude Optional	array
includeEmployeeCount Filter by company employee count range Optional	array
includeRevenue Filter by company annual revenue range Optional	object
includeManagementRole Filter by seniority or management level Optional	array
includeCompany Array of companies to include Optional	array
excludeCompany Array of companies to exclude Optional	array
includeDepartmentKeyword Filter by department keyword Optional	string
includePersonalCountry Array of countries to include Optional	array
excludePersonalCountry Array of countries to exclude Optional	array
includeCompanyLocation Array of company locations to include Optional	array
excludeCompanyLocation Array of company locations to exclude Optional	array
includeJobTitles Array of job titles to include Optional	array
excludeJobTitles Array of job titles to exclude Optional	array
includeTechnology Filter by technologies a company uses Optional	array
includeFirstName Filter by first name Optional	string
includeLastName Filter by last name Optional	string
search Free-text search across records Optional	string
funding Filter by company funding stage Optional	array
foundingYearOptions Filter by company founding year Optional	array
includeLinkedinUrl Filter by a specific LinkedIn profile URL Optional	string

Code Examples

cURL

curl -X POST "https://api.exellius.com/api/v1/people/search/phone?limit=1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
    "includeIndustry": ["accounting"],
    "excludeIndustry": [],
    "includeEmployeeCount": null,
    "includeRevenue": null,
    "includeManagementRole": null,
    "includeCompany": [],
    "excludeCompany": [],
    "includeDepartmentKeyword": null,
    "includePersonalCountry": null,
    "excludePersonalCountry": null,
    "includeCompanyLocation": null,
    "excludeCompanyLocation": null,
    "includeJobTitles": null,
    "excludeJobTitles": null,
    "includeTechnology": null,
    "includeFirstName": null,
    "includeLastName": null,
    "search": null,
    "funding": null,
    "foundingYearOptions": null,
    "includeLinkedinUrl": null
  }'

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "phone",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Example Request

POST /api/v1/people/search/phone

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "phone",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Search People

Search for people matching a set of filters — industry, company, job title, location, and more — and return both email addresses and phone numbers in a single call.

Method

POST

Endpoint

/api/v1/people/search

Query Parameters

limit

The maximum number of results to return (e.g., 10)

Body Parameters

Parameter	Type	Values
includeIndustry Array of industries to include Optional	array
excludeIndustry Array of industries to exclude Optional	array
includeEmployeeCount Filter by company employee count range Optional	array
includeRevenue Filter by company annual revenue range Optional	object
includeManagementRole Filter by seniority or management level Optional	array
includeCompany Array of companies to include Optional	array
excludeCompany Array of companies to exclude Optional	array
includeDepartmentKeyword Filter by department keyword Optional	string
includePersonalCountry Array of countries to include Optional	array
excludePersonalCountry Array of countries to exclude Optional	array
includeCompanyLocation Array of company locations to include Optional	array
excludeCompanyLocation Array of company locations to exclude Optional	array
includeJobTitles Array of job titles to include Optional	array
excludeJobTitles Array of job titles to exclude Optional	array
includeTechnology Filter by technologies a company uses Optional	array
includeFirstName Filter by first name Optional	string
includeLastName Filter by last name Optional	string
search Free-text search across records Optional	string
funding Filter by company funding stage Optional	array
foundingYearOptions Filter by company founding year Optional	array
includeLinkedinUrl Filter by a specific LinkedIn profile URL Optional	string

Code Examples

cURL

curl -X POST "https://api.exellius.com/api/v1/people/search?limit=1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
    "includeIndustry": ["accounting"]
  }'

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "all",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Example Request

POST /api/v1/people/search

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "accounting",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "all",
  "credits_deducted": 0,
  "remaining_credits": 57046
}

Find Person Email

Find professional email addresses for any person based on their name and company domain. This endpoint searches our extensive database to locate verified email addresses.

Method

GET

Endpoint

/api/v1/people/find/email

Query Parameters

domain

The company domain (e.g., exellius.com)

Required

first_name

First name of the person

Required

last_name

Last name of the person

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/find/email?domain=exellius.com&first_name=omkar&last_name=shinde&limit=1" \
  -H "Authorization: Bearer <api_key>"

Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 1,
    "per_page_count": 1,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "corporate_phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
    ],
    "lookup_type": "email",
    "credits_deducted": 1,
    "remaining_credits": 57054
}

Example Request

GET /api/v1/people/find/email?domain=exellius.com&first_name=sunil&last_name=patil

Example Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 1,
    "per_page_count": 1,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "corporate_phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
    ],
    "lookup_type": "email",
    "credits_deducted": 1,
    "remaining_credits": 57054
}

Find Emails by Company Domain

Search for information linked to a company domain, such as verified email addresses. This endpoint queries our database using the domain and the type of data you want returned.

Method

GET

Endpoint

/api/v1/people/search/domain/email

Query Parameters

domain

The company domain (e.g., exellius.com)

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/search/domain/email?domain=exellius.com&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 1,
    "per_page_count": 1,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "corporate_phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
    ],
    "lookup_type": "email",
    "credits_deducted": 1,
    "remaining_credits": 57054
}

Example Request

GET /api/v1/people/search/domain/email?domain=exellius.com

Example Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 1,
    "per_page_count": 1,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "corporate_phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
    ],
    "lookup_type": "email",
    "credits_deducted": 1,
    "remaining_credits": 57054
}

Find Email by Linkedin URL

Find contact details for a person using their LinkedIn profile URL. Specify the type of data you want returned, such as email or phone.

Method

GET

Endpoint

/api/v1/people/search/linkedin/email

Query Parameters

linkedin_handle

The full LinkedIn profile URL (e.g., http://www.linkedin.com/in/omkar-shinde-4ba76514a)

Required

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/search/linkedin/email?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/search/linkedin/email?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Verify Email

Verify whether an email address is valid, active, and deliverable. This endpoint checks the given email against our verification database.

Method

GET

Endpoint

/api/v1/people/verify/email

Query Parameters

The email address to verify (e.g., sunil.patil@exellius.com)

Required

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/verify/email?email=omkar.shinde@exellius.com&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
    "message": "Email validation result",
    "data": {
        "accept_all": false,
        "attributes": {
            "did_you_mean": null,
            "domain": "exellius.com",
            "is_free": "No",
            "provider": "Exellius Systems",
            "username": "omkar.shinde"
        },
        "block": false,
        "disposable": false,
        "email": "omkar.shinde@exellius.com",
        "final_status": "valid",
        "gibberish": false,
        "is_blocked": false,
        "is_connection_failure": false,
        "mx_records": [
            "mx1.exellius.com",
            "mx2.exellius.com",
            "mx3.exellius.com",
            "mx4.exellius.com",
            "mx5.exellius.com"
        ],
        "quality_check": {
            "can_receive_email": "Yes",
            "disposable_address": "No",
            "email_quality_score": "100%",
            "has_mx_records": "Yes",
            "not_a_catchall_address": "Yes",
            "not_a_generic_address": "Yes",
            "valid_domain": "Yes",
            "valid_format": "Yes"
        },
        "regexp": true,
        "score": 100,
        "smtp_check": true,
        "smtp_server": null,
        "status": "valid",
        "status_reason": "Email verified via SMTP",
        "timestamp": "2026-07-21T09:33:35.778245",
        "validation_method": "smtp_validation",
        "webmail": false
    }
}

Example Request

GET /api/v1/people/verify/email?email=sunil.patil@exellius.com

Example Response

{
    "message": "Email validation result",
    "data": {
        "accept_all": false,
        "attributes": {
            "did_you_mean": null,
            "domain": "exellius.com",
            "is_free": "No",
            "provider": "Exellius Systems",
            "username": "omkar.shinde"
        },
        "block": false,
        "disposable": false,
        "email": "omkar.shinde@exellius.com",
        "final_status": "valid",
        "gibberish": false,
        "is_blocked": false,
        "is_connection_failure": false,
        "mx_records": [
            "mx1.exellius.com",
            "mx2.exellius.com",
            "mx3.exellius.com",
            "mx4.exellius.com",
            "mx5.exellius.com"
        ],
        "quality_check": {
            "can_receive_email": "Yes",
            "disposable_address": "No",
            "email_quality_score": "100%",
            "has_mx_records": "Yes",
            "not_a_catchall_address": "Yes",
            "not_a_generic_address": "Yes",
            "valid_domain": "Yes",
            "valid_format": "Yes"
        },
        "regexp": true,
        "score": 100,
        "smtp_check": true,
        "smtp_server": null,
        "status": "valid",
        "status_reason": "Email verified via SMTP",
        "timestamp": "2026-07-21T09:33:35.778245",
        "validation_method": "smtp_validation",
        "webmail": false
    }
}

Find Person Phone

Find phone numbers and contact details for people at a company based on their name and domain. This endpoint searches our database and returns matching contact records.

Method

GET

Endpoint

/api/v1/people/find/phone

Query Parameters

domain

The company domain (e.g., exellius.com)

Required

first_name

First name of the person

Required

last_name

Last name of the person

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/find/phone?domain=exellius.com&first_name=omkar&last_name=shinde&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/find/phone?domain=exellius.com&first_name=sunil&last_name=patil

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Find Phones by Company Domain

Search for people and phone contact details linked to a company domain. This endpoint queries our database using the domain and returns a paginated list of matching records.

Method

GET

Endpoint

/api/v1/people/search/domain/phone

Query Parameters

domain

The company domain (e.g., exellius.com)

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/search/domain/phone?domain=exellius.com&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "phone",
  "credits_deducted": 0,
  "remaining_credits": null
}

Example Request

GET /api/v1/people/search/domain/phone?domain=exellius.com

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 6780,
  "per_page_count": 20,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
    // ...more results
  ],
  "lookup_type": "phone",
  "credits_deducted": 0,
  "remaining_credits": null
}

Find Phone by LinkedIn URL

Find a phone number for a person using their LinkedIn profile URL. Set the type parameter to phone to return contact numbers instead of email addresses.

Method

GET

Endpoint

/api/v1/people/search/linkedin/phone

Query Parameters

linkedin_handle

The full LinkedIn profile URL (e.g., http://www.linkedin.com/in/omkar-shinde-4ba76514a)

Required

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/search/linkedin/phone?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/search/linkedin/phone?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Enrich Person with Email

Enrich an email address with detailed profile and company data, including job title, seniority, department, industry, and contact details.

Method

GET

Endpoint

/api/v1/people/enrich/email

Query Parameters

The email address to enrich (e.g., omkar.shinde@exellius.com)

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/enrich/email?email=omkar.shinde@exellius.com&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "both",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/enrich/email?email=omkar.shinde@exellius.com

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "work_direct_phone": null,
      "mobile_phone": null,
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "both",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Enrich Person by LinkedIn URL

Enrich a LinkedIn profile URL with detailed contact and company data, including job title, seniority, department, industry, and email address and phone number.

Method

GET

Endpoint

/api/v1/people/enrich/linkedin

Query Parameters

linkedin_handle

The full LinkedIn profile URL (e.g., http://www.linkedin.com/in/omkar-shinde-4ba76514a)

Required

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/enrich/linkedin?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/enrich/linkedin?linkedin_handle=http://www.linkedin.com/in/omkar-shinde-4ba76514a

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 264,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "Omkar",
      "last_name": "Shinde",
      "title": "CEO",
      "company": "Exellius Systems",
      "email": "omkar.shinde@exellius.com",
      "email_status": "Valid",
      "seniority": "C-Team",
      "departments": "General Business & Management",
      "corporate_phone": null,
      "phone": null,
      "country": "India",
      "city": "Pune",
      "state": "Maharashtra",
      "company_address": "301-306 3rd Floor Centrum Plaza Golf Course Road",
      "company_city": "Dover",
      "company_state": "Delaware",
      "company_country": "United States",
      "industry": "Consumer Services",
      "num_employees": 17,
      "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
      "website": "http://www.exellius.com",
      "company_linkedin_url": "https://www.linkedin.com/company/exellius-systems",
      "keywords": "crowdsourcing;app discovery  engagement;content discovery",
      "domain": "exellius.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "email",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Enrich Company

Find detailed company data using a company domain, including industry, size, address, and social profiles.

Method

GET

Endpoint

/api/v1/companies/enrich

Query Parameters

company

The company domain (e.g., exellius)

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/companies/enrich?company=exellius&limit=1" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 263,
    "per_page_count": 7,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "work_direct_phone": null,
            "mobile_phone": null,
            "corporate_phone": null,
            "phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
  ],
  "lookup_type": "both",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/companies/enrich?company=exellius

Example Response

{
    "success": true,
    "message": "Data fetched successfully",
    "total_count": 263,
    "per_page_count": 7,
    "current_page": 1,
    "data": [
        {
            "id": 77065311,
            "first_name": "Omkar",
            "last_name": "Shinde",
            "title": "Marketing Communication Manager",
            "company": "Exellius Systems",
            "email": "omkar.shinde@exellius.com",
            "email_status": "Valid",
            "seniority": null,
            "departments": null,
            "work_direct_phone": null,
            "mobile_phone": null,
            "corporate_phone": null,
            "phone": null,
            "category": null,
            "organization": null,
            "position": null,
            "country": "India",
            "city": "Pune",
            "state": "Maharashtra",
            "company_address": null,
            "company_city": "Dover",
            "company_state": "Delaware",
            "company_country": "United States",
            "industry": "marketing & advertising",
            "num_employees": 17,
            "linkedin_url": "http://www.linkedin.com/in/omkar-shinde-4ba76514a",
            "website": "http://www.exellius.com",
            "company_linkedin_url": null,
            "facebook_url": null,
            "twitter_url": null,
            "keywords": "email marketing content development search engine optimization data services social media marketing lead generation paid advertising conversation rate optimization v website & mobile development",
            "technologies": null,
            "seo_description": null,
            "annual_revenue": null,
            "total_funding": null,
            "latest_funding": null,
            "latest_funding_amount": null,
            "last_raised_at": null,
            "num_retail_locations": null,
            "created_at": "2026-04-22T09:18:25.882Z",
            "updated_at": "2026-04-22T09:18:25.882Z",
            "domain": "exellius.com",
            "country_norm": null
        }
  ],
  "lookup_type": "both",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Enrich Person by Phone

Find contact and company details for a person using their phone number.

Method

GET

Endpoint

/api/v1/people/enrich/phone

Query Parameters

phone

The phone number to look up, including country code, digits only (e.g., 14056268593)

Required

limit

The maximum number of results to return (e.g., 10)

Code Examples

cURL

curl -X GET "https://api.exellius.com/api/v1/people/enrich/phone?phone=14056268593" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 1,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "John",
      "last_name": "Doe",
      "title": "Operations Manager",
      "company": "Example Corp",
      "email": "john.doe@example.com",
      "email_status": "Valid",
      "seniority": "Manager",
      "departments": "Operations",
      "corporate_phone": "14056268593",
      "phone": "14056268593",
      "country": "United States",
      "city": "Oklahoma City",
      "state": "Oklahoma",
      "company_address": "123 Main St",
      "company_city": "Oklahoma City",
      "company_state": "Oklahoma",
      "company_country": "United States",
      "industry": "Business Services",
      "num_employees": 42,
      "linkedin_url": "http://www.linkedin.com/in/john-doe",
      "website": "http://www.example.com",
      "company_linkedin_url": "https://www.linkedin.com/company/example-corp",
      "keywords": "operations;logistics;management",
      "domain": "example.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "phone",
  "credits_deducted": 1,
  "remaining_credits": 57046
}

Example Request

GET /api/v1/people/enrich/phone?phone=14056268593

Example Response

{
  "success": true,
  "message": "Data fetched successfully",
  "total_count": 1,
  "per_page_count": 1,
  "current_page": 1,
  "data": [
    {
      "id": 67987686,
      "first_name": "John",
      "last_name": "Doe",
      "title": "Operations Manager",
      "company": "Example Corp",
      "email": "john.doe@example.com",
      "email_status": "Valid",
      "seniority": "Manager",
      "departments": "Operations",
      "corporate_phone": "14056268593",
      "phone": "14056268593",
      "country": "United States",
      "city": "Oklahoma City",
      "state": "Oklahoma",
      "company_address": "123 Main St",
      "company_city": "Oklahoma City",
      "company_state": "Oklahoma",
      "company_country": "United States",
      "industry": "Business Services",
      "num_employees": 42,
      "linkedin_url": "http://www.linkedin.com/in/john-doe",
      "website": "http://www.example.com",
      "company_linkedin_url": "https://www.linkedin.com/company/example-corp",
      "keywords": "operations;logistics;management",
      "domain": "example.com",
      "created_at": "2026-04-07T09:28:28.990Z",
      "updated_at": "2026-04-07T09:28:28.990Z"
    }
  ],
  "lookup_type": "phone",
  "credits_deducted": 1,
  "remaining_credits": 57046
}