SalesBridgeIQ API

Integrate B2B email finding and verification into any application.

Base URL

https://SalesBridgeIQ.io/api/v1

Authentication

All API requests require an API key passed in the Authorization header.

header

Authorization: Bearer piq_your_api_key_here

Get your API key fromSettings → API Keys

Email Finder

Find a professional email address by first name, last name, and company domain.

POST/api/v1/email-finder

Parameters

Name	Type	Required	Description
first_name	string	Required	Person's first name
last_name	string	Required	Person's last name
domain	string	Required	Company domain (e.g. apple.com)

Request Example

curl

curl -X POST https://SalesBridgeIQ.io/api/v1/email-finder \
  -H "Authorization: Bearer piq_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Tim",
    "last_name": "Cook",
    "domain": "apple.com"
  }'

Response

json

{
  "success": true,
  "data": {
    "email": "tcook@apple.com",
    "confidence": 94,
    "status": "found",
    "source": "bridgeiq",
    "first_name": "Tim",
    "last_name": "Cook",
    "domain": "apple.com"
  },
  "credits_used": 1,
  "credits_remaining": 449
}

Try it

first_name

last_name

domain

Email Verifier

Verify if an email address is valid, invalid, or catch-all.

POST/api/v1/email-verifier

Parameters

Name	Type	Required	Description
email	string	Required	Email address to verify

Request Example

curl

curl -X POST https://SalesBridgeIQ.io/api/v1/email-verifier \
  -H "Authorization: Bearer piq_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@company.com"}'

Response

json

{
  "success": true,
  "data": {
    "email": "john@company.com",
    "status": "valid",
    "score": 95,
    "details": {
      "mx_found": true,
      "smtp_valid": true,
      "disposable": false,
      "syntax_valid": true,
      "risk_level": "low"
    }
  },
  "credits_used": 1,
  "credits_remaining": 448
}

Try it

List Leads

Retrieve your leads with pagination and filtering.

GET/api/v1/leads

Parameters

Name	Type	Required	Description
page	number	Optional	Page number (default: 1)
limit	number	Optional	Results per page (max: 100, default: 25)
list_id	string	Optional	Filter by list ID
score_min	number	Optional	Minimum lead score

Request Example

curl

curl https://SalesBridgeIQ.io/api/v1/leads?page=1&limit=25 \
  -H "Authorization: Bearer piq_your_api_key"

Response

json

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@company.com",
      "title": "CTO",
      "company": "TechCorp",
      "score": 85
    }
  ],
  "total": 142,
  "page": 1,
  "has_more": true
}

Try it

List All Lists

Retrieve all your lead lists.

GET/api/v1/lists

Request Example

curl

curl https://SalesBridgeIQ.io/api/v1/lists \
  -H "Authorization: Bearer piq_your_api_key"

Response

json

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "Q1 Prospects",
      "description": "SaaS CTOs in India",
      "lead_count": 45,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Try it

Error Codes

All errors return a consistent JSON format with a descriptive message.

json

{
  "success": false,
  "error": {
    "message": "Description of what went wrong"
  }
}

Code	Meaning	How to Fix
400	Bad Request	Check required fields in your request body
401	Unauthorized	Check your API key is valid and included in headers
402	Insufficient Credits	Purchase more credits at /settings/billing
429	Rate Limit Exceeded	Slow down requests or upgrade your plan
500	Internal Error	Retry the request. Contact support if persistent

Rate Limits

Rate limits are applied per API key based on your plan. Limits reset every hour.

Plan	Requests / Hour	Monthly Credits
Free	60	100
Starter ($19/mo)	300	1,000
Growth ($49/mo)	1,000	5,000
Pro ($99/mo)	5,000	20,000

Rate limit headers

Every response includes these headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset: 2024-01-15T11:00:00Z