The leads we build for you, in your own systems and in Claude.
We build and run your leads. Pull them, and our records, into your own systems, or ask about them in Claude or any MCP client.
Use the REST API
Pull the leads we build for you, and our company records, into your own systems.
Start with the REST APIREST base URLhttps://app.dealport.com/api/v1Connect Claude
Ask Claude about your leads and our company records, in plain English. It works in any MCP client.
Connect ClaudeMCP connectorhttps://app.dealport.com/api/mcp
On this page
Getting started
New to Dealport? Request a demo. We set up your workspace and build your first Projects with you. Already a customer? Sign in at app.dealport.com.
Choose a workspace in the app. Your key works only in the workspace it was made in.
After your demo, your key is made in Settings → API and MCP, and shown once. Then make your first request:
New to Dealport? We set it up with you.Request demo
curl -G https://app.dealport.com/api/v1/companies \
-d state=IL \
-d care_type=home_health \
-d limit=1 \
-H "Authorization: Bearer dp_live_…"Authentication
Send your key with every request: Authorization: Bearer dp_live_…. Keep it out of shared code. If it leaks, revoke it in Settings → API and MCP.
A key acts for the workspace it was made in. It reads Dealport's records and that workspace's own Projects.
Credits and limits
Looking up Dealport's records uses credits, and each response shows how many in credits_charged. What each call uses, and your balance, are in the app.
Reading your Projects and their leads uses no credits. Pulling the same record again within 30 days uses none either.
| Call | Credits |
|---|---|
| Search companies | Credits:Used per company returned |
| Search NYC buildings | Credits:Used per building returned |
| Get a record | Credits:Used once; no credits to read it again within 30 days |
| Find an owner's contact | Credits:Used only when a phone or email is found |
| Research a company | Credits:Used once; no credits for the same company again within 30 days |
| Projects and leads, get research, balance | Credits:No credits |
Questions about credits? Request demo
Errors
| Status | Meaning |
|---|---|
| 401 | Meaning:The key is missing or revoked. |
| 400 bad_request | Meaning:Explains what is wrong with the request. |
| 402 insufficient_credits | Meaning:Not enough credits; includes balance and needed. |
| 404 not_found | Meaning:The key's workspace has no Project with that id. |
| 422 search_too_broad | Meaning:Add an industry, or a narrower revenue or headcount range. |
The endpoints
- Your ProjectsGET
/api/v1/projects - A Project’s leadsGET
/api/v1/projects/{project_id}/leads - Search companiesGET
/api/v1/companies - Get a recordGET
/api/v1/records/{id} - Search NYC buildingsGET
/api/v1/buildings - Find an owner’s contactPOST
/api/v1/contacts - Research a companyPOST
/api/v1/research - BalanceGET
/api/v1/balance
Your Projects
GET/api/v1/projectsNo credits
The Projects we run for your workspace. Each shows its status, how many records it has looked at, how many were qualified or disqualified or are awaiting_review, when it last ran, and a link to it in the app.
curl https://app.dealport.com/api/v1/projects \
-H "Authorization: Bearer dp_live_…"Response · show it
{
"data": [{
"project_id": "3f6a2d18-7c4e-4b09-8e15-6d2a9c0b7f41",
"name": "Illinois",
"goal": "Owner-operated companies to approach this year",
"solution": "Midwest mandate",
"status": "13 to review",
"records": 412, "qualified": 38, "disqualified": 361, "awaiting_review": 13,
"last_run": "2026-09-28T14:02:11.000Z",
"link": "https://app.dealport.com/projects/3f6a2d18-7c4e-4b09-8e15-6d2a9c0b7f41?workspace=…"
}]
}A Project’s leads
GET/api/v1/projects/{project_id}/leadsNo credits
A Project's leads ranked best first, as its Results tab ranks them. Each has its tier and score, its key answers in facts (who, phone, email, licence), its checks, and a link to it in the app.
Each check is a rule's label after how the lead did: Meets:, Not:, Unknown:, Flagged:, Bonus:, Needs review: or Fails:.
Get a record with the record_id for the company in full.
ParametersShow
| Parameter | What it does |
|---|---|
| show | What it does:qualified (the default), review for those awaiting review, or all. |
| limit, offset | What it does:Page size, 1 to 100 (25 by default), and how many leads to skip. |
curl -G \
https://app.dealport.com/api/v1/projects/3f6a2d18-7c4e-4b09-8e15-6d2a9c0b7f41/leads \
-d limit=10 \
-H "Authorization: Bearer dp_live_…"Response · show it
{
"data": {
"project": { "project_id": "3f6a2d18-7c4e-4b09-8e15-6d2a9c0b7f41", "name": "Illinois",
"solution": "Midwest mandate", "qualified": 38, "awaiting_review": 13,
"records": 412, "link": "…" },
"showing": "qualified", "total": 38, "offset": 0,
"leads": [{
"rank": 1,
"name": "LAKESIDE HOME HEALTH, LLC",
"record_id": "8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13",
"status": "qualified",
"tier": "A", "score": 91,
"facts": { "Owner": "CAROL MENDES, Owner", "Owner phone": "+16305550142",
"Owner email": "c.mendes@example.com" },
"checks": ["Meets: Owner-operated", "Meets: Founded before 2000",
"Unknown: Headcount 20 to 100"],
"link": "https://app.dealport.com/projects/…/runs/…?workspace=…"
}, …]
}
}Search companies
GET/api/v1/companiesUses credits, per company returned
A search needs a state or a name prefix (q). Pages hold up to 50; pass next_cursor as cursor to read the next.
ParametersShow
| Parameter | What it does |
|---|---|
| state | What it does:Two-letter state code, such as IL. |
| q | What it does:How the company's name starts. |
| naics | What it does:Comma-separated. Six digits match exactly; fewer match every code that starts with them, such as 6216. |
| min_revenue, max_revenue | What it does:Dollars; 1M and 250k also work. revenue=filed keeps only filed revenue. |
| min_employees, max_employees | What it does:Headcount range. |
| care_type | What it does:Healthcare organizations by NPI registration: home_care, home_health, hospice, nursing_home, assisted_living, behavioral_health, hospital, clinic, physician_practice, dental, therapy, pharmacy, laboratory, medical_equipment, ambulance, other. |
| licensed, medicare, owner_operated | What it does:true keeps organizations with an active state health license, enrolled in Medicare, or a Medicare agency its owners run. |
| owner_contact | What it does:true keeps companies with an owner's phone or email on file. |
| limit, cursor | What it does:Page size, at most 50, and the next_cursor from the last page. |
curl -G https://app.dealport.com/api/v1/companies \
-d state=IL \
-d care_type=home_health \
-d min_revenue=5M \
-d limit=1 \
-H "Authorization: Bearer dp_live_…"Response · show it
{
"data": [{
"id": "8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13",
"name": "LAKESIDE HOME HEALTH, LLC",
"city": "Naperville", "state": "IL", "zip": "60540",
"naics": ["621610"], "industry": ["home_health"],
"phone": "+16305550142", "website": null,
"revenue": { "value": 8200000, "low": 6000000, "high": 11000000, "basis": "estimate" },
"employees": { "value": null, "low": null, "high": null, "basis": null },
"owner": { "name": "CAROL MENDES", "role": "officer" },
"sources": 3
}],
"next_cursor": "1",
"credits_charged": …
}Get a record
GET/api/v1/records/{id}Uses credits
The full record for a company id, or for a building by its 10-digit NYC BBL. Every fact carries its basis (filed, observed or estimate) and its source.
Fields: id, kind, name, summary, address, naics, industry (building for a building), website, phone, facts, details, people, identifiers and sources.
curl https://app.dealport.com/api/v1/records/8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13 \
-H "Authorization: Bearer dp_live_…"Response · show it
{
"id": "8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13",
"kind": "company",
"name": "LAKESIDE HOME HEALTH, LLC",
"facts": [
{ "kind": "revenue", "value": 8200000, "low": 6000000, "high": 11000000,
"as_of": "…", "basis": "estimate",
"source": { "name": "Dealport estimate", "detail": "…", "url": null } },
…
],
"people": [
{ "name": "CAROL MENDES", "role": "administrator", "owner": true,
"phone": null, "email": null, "sources": [1] }
],
"identifiers": [{ "type": "npi", "values": ["…"] }],
"sources": [{ "name": "…", "url": "…", "used_for": ["…"], "latest": "…" }]
}Search NYC buildings
GET/api/v1/buildingsUses credits, per building returned
Each building's BBL, address, owner of record, units, class, year built, rent-stabilized units and its current loan. A loan's due year is an estimate from its date and holder.
Get a record with the bbl for the building in full.
ParametersShow
| Parameter | What it does |
|---|---|
| borough | What it does:Required: MN, BK, QN, BX or SI. |
| min_units | What it does:10 by default. |
| q | What it does:Part of the address or the owner's name. |
| loan_due_by | What it does:A year: buildings whose current loan likely comes due by then, soonest first. |
| loan_holder | What it does:agency (Fannie Mae or Freddie Mac), cmbs or bank. |
| signal | What it does:rent_stabilized, dob_penalties, housing_court, tax_lien or ll97. |
| limit, cursor | What it does:Page size and the next_cursor from the last page. |
curl -G https://app.dealport.com/api/v1/buildings \
-d borough=BK \
-d min_units=20 \
-d loan_due_by=2027 \
-H "Authorization: Bearer dp_live_…"Response · show it
{
"data": [{
"bbl": "3…", "address": "…, Brooklyn", "owner": "… LLC",
"units": 48, "class": "…", "year_built": 1931, "rent_stabilized_units": 36,
"loan": { "holder_type": "bank", "estimated_due_year": 2027 }
}],
"next_cursor": "…",
"credits_charged": …
}Find an owner’s contact
POST/api/v1/contactsUses credits, only when a phone or email is found
Looks up the owner Dealport's records name, or the person you pass. A contact is confirmed by name and place or employer, and phones on the Do Not Call list are withheld. It can take up to two minutes.
curl -X POST https://app.dealport.com/api/v1/contacts \
-H "Authorization: Bearer dp_live_…" \
-H "Content-Type: application/json" \
-d '{"company_id": "8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13"}'Response · show it
{
"company": "LAKESIDE HOME HEALTH, LLC",
"person": "CAROL MENDES",
"phone": "+16305550142",
"email": "c.mendes@example.com",
"sources": [ … ],
"credits_charged": …,
"note": "…"
}Research a company
POST/api/v1/researchUses credits; no credits for the same company again within 30 days
Starts from Dealport's record, researches public sources for what's missing, then finds the owner's direct phone and email. It returns at once with a research_id; a research takes a few minutes.
Read it with GET /api/v1/research/{research_id}, which uses no credits. status is running, done or failed. fields holds description, founded, headcount, revenue, ownership, owners, owner_phone, owner_email, website, location and legal_name, each with a label, a status (found, estimated or unknown), a value and its sources.
curl -X POST https://app.dealport.com/api/v1/research \
-H "Authorization: Bearer dp_live_…" \
-H "Content-Type: application/json" \
-d '{"company_id": "8c1e0f4a-3b7d-4e52-9a61-2f0d7c9b5e13"}'Response · show it
{ "research_id": "…", "status": "running" }
GET /api/v1/research/{research_id}
{
"research_id": "…",
"company": "LAKESIDE HOME HEALTH, LLC",
"status": "done",
"fields": {
"ownership": { "label": "Ownership", "status": "found",
"value": "Owner-operated", "sources": [1, 2] },
"revenue": { "label": "Revenue", "status": "estimated",
"value": "…", "sources": [3] },
…
},
"sources": [{ "n": 1, "url": "…", "title": "…" }, …]
}Balance
GET/api/v1/balanceNo credits
Your credits and what you've used. Billing is in the app.
curl https://app.dealport.com/api/v1/balance \
-H "Authorization: Bearer dp_live_…"{ "data": { "billing": "prepaid", "credits": …, "used": …, "rates": { … } } }Ask about your leads in Claude.
We connect Claude to your workspace. Sign in once, then ask in plain English.
The MCP connector
The connector is at https://app.dealport.com/api/mcp, over streamable HTTP. Claude and Claude Code connect by signing in with your Dealport account. An assistant that can't sign in sends an API key instead, as Authorization: Bearer dp_live_…. Keep keys in the Authorization header, never in a URL you might copy, share or log.
A connection uses only the workspace chosen when you sign in. To use another, connect again and choose it. The optional workspace field is only for a sign-in that didn't choose one.
Searching Dealport's records through a connector uses credits, as the API does.
The toolsShow
| Tool | What it does |
|---|---|
| list_projects | What it does:Your Projects, with how many qualified and how many await review. |
| project_leads | What it does:A Project's leads ranked best first, each with its tier, score, key answers and checks. The same show, limit and offset as the API; limit is 10 by default. |
| search_companies | What it does:The same filters as Search companies. |
| search_buildings | What it does:NYC buildings, with the same filters as Search NYC buildings. |
| get_record | What it does:A company or building in full. |
| find_contact | What it does:An owner's phone and email. |
| research_company, get_research | What it does:Start a research, then read it. |
| account_balance | What it does:Your credits. |
Connect Claude
On Team or Enterprise accounts, an organization owner may need to add the connector first. The connection reads only the workspace you choose at sign-in.
Keep unknown checks visible and verify each cited source against its claim. The walkthrough includes a copyable review prompt and exact tool arguments.
Review a Project in ClaudeAnthropic connector setup
In Claude, open Customize → Connectors, then Add → Add custom connector.
Name it Dealport, with the URL https://app.dealport.com/api/mcp, and add it.
Choose Connect and sign in with your Dealport email. If you're in more than one workspace, choose the one this connection uses.
Enable Dealport in the conversation. Ask it to list your Projects, then read one page of up to ten qualified leads from the Project you choose. Stop before allowing new searches or research.
Connect Claude Code
Add the connector, then type /mcp in Claude Code and sign in.
claude mcp add --transport http dealport https://app.dealport.com/api/mcp
Tell us the deal you’re after.
We open your workspace, build your first Projects with you and connect the API or Claude, so your team works the right leads and you close the deal.