ColdIQ API
Official vendor OpenAPI document · agent-readyData EnrichmentContact Enrichmentbearer748 EndpointsREST
For Agents
Search and enrich people and companies, verify and find email addresses, and check your credit balance across ColdIQ's integrated prospecting data providers.
Use for: Enrich a contact with their work email and company, Verify an email address before adding it to a campaign, Find the email for a person at a given company, Search for people matching a job title and industry
Not supported: Does not send emails, run outreach sequences, or manage a CRM. Use for ColdIQ contact search, enrichment, and email verification only.
The ColdIQ API is a unified interface to sales-prospecting and contact-enrichment providers: it runs people and company searches, enriches contacts and organizations, verifies and finds email addresses, and reports your credit balance, all behind one bearer-authenticated API. Use it to enrich leads and build prospect lists from many data sources through a single integration.
Install Jentic One Beta
Connect the ColdIQ API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ColdIQ API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcoldiq.com%2Fcoldiq" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcoldiq.com%2Fcoldiq" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with ColdIQ API.
Run web and people searches through providers such as Exa, Apollo, and Findymail
Enrich a person or company record with contact and firmographic data
Verify an email address to reduce bounces before sending
Find email addresses from a name, domain, or business profile
Bulk-enrich lists of contacts in a single request
Check your remaining ColdIQ credit balance
Use Cases
Patterns agents use ColdIQ API for, with concrete tasks.
★ AI agent lead enrichment
An AI agent takes an inbound lead, enriches the person and their company with contact and firmographic data, and verifies the email before it enters a campaign. Through Jentic the agent finds the right provider operation by intent and calls it with the stored token, without choosing among hundreds of provider-specific endpoints itself.
Enrich the contact jane@acme.com with her job title and company, and verify the email is deliverable
Prospect list building
A sales team builds a targeted prospect list by searching people who match a job title and industry, then enriching each with a verified email. The API spans multiple search providers so the list can be assembled and deduplicated from the source with the best coverage.
Search for heads of sales at software companies and return each with a verified work email
Email verification at scale
Before a large send, a deliverability workflow verifies every address to remove likely bounces. The API exposes verification endpoints so a batch of emails can be checked and scored, protecting sender reputation ahead of the campaign.
Verify a list of email addresses and drop the ones flagged as likely to bounce
Key Endpoints
748 endpoints — the coldiq api is a unified interface to sales-prospecting and contact-enrichment providers: it runs people and company searches, enriches contacts and organizations, verifies and finds email addresses, and reports your credit balance, all behind one bearer-authenticated api.
METHOD
PATH
DESCRIPTION
GET
/v1/me/credits
Get the remaining credit balance
POST
/v1/exa/search
Run an Exa web search
POST
/v1/fullenrich/contact/enrich/bulk
Bulk-enrich contacts via FullEnrich
POST
/v1/findymail/verify
Verify an email for potential bounce
POST
/v1/apollo/people/search
Search people via Apollo
POST
/v1/limadata/enrich/person
Enrich a person via LimaData
GET
/v1/me/credits
Get the remaining credit balance
POST
/v1/exa/search
Run an Exa web search
POST
/v1/fullenrich/contact/enrich/bulk
Bulk-enrich contacts via FullEnrich
POST
/v1/findymail/verify
Verify an email for potential bounce
POST
/v1/apollo/people/search
Search people via Apollo
POST
/v1/limadata/enrich/person
Enrich a person via LimaData
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Calling the ColdIQ API by hand means holding a bearer token, choosing among hundreds of provider-specific endpoints, and normalizing each provider's response shape. Through Jentic you install once, import ColdIQ from the API Directory, store the token once, and your agent calls the operation it needs.
Permission scoping
You choose which of ColdIQ's operations your agent may call, so you can allow single-record enrichment and verification while leaving credit-spending bulk jobs out. Every call is logged, so an expensive bulk search the agent should not run is simply absent from its allowed set.
Credential isolation
Your ColdIQ API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'verify an email' or 'enrich a company', and Jentic returns the matching ColdIQ operation with its input schema, so the agent picks the right provider endpoint out of hundreds without reading the reference.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using ColdIQ API through Jentic.
Is there a ColdIQ MCP server?
You don't need an MCP server to connect your agent to the ColdIQ API. Jentic connects it directly from the API Directory: import ColdIQ, store your API token once, and your agent searches, enriches, and verifies contacts on demand.
Can I limit what my agent is allowed to do with the ColdIQ API?
Yes. Write a rule that allows only the single-record enrichment and email-verification operations, so the agent can enrich contacts without launching credit-heavy bulk jobs. You pick which of the hundreds of ColdIQ operations it may call, and every call is logged.
What authentication does the ColdIQ API use?
The ColdIQ API authenticates with a bearer token, per its OpenAPI spec. Through Jentic the token is stored once by your self-hosted instance and injected at call time, so it never reaches the agent's context.
Can I verify an email address with the ColdIQ API?
Yes. Send the email to a verification endpoint such as Findymail's verify operation, and ColdIQ returns whether it is likely to bounce. You can also find missing emails from a name and company before verifying them.
What are the rate limits for the ColdIQ API?
The OpenAPI spec does not specify rate limits. ColdIQ meters usage in credits per provider call, so check your credit balance before running large enrichment jobs.
How do I connect the ColdIQ API to my AI agent?
Search the Jentic API Directory for the ColdIQ operation you need, such as enriching a person, and import it. To run it on your own infrastructure, install Jentic One from its GitHub repo, then your agent calls the API with your token injected at execution time.
GET STARTED