Skip to content

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.

    REST base URL
    https://app.dealport.com/api/v1
    Start with the REST API
  • Connect Claude

    Ask Claude about your leads and our company records, in plain English. It works in any MCP client.

    MCP connector
    https://app.dealport.com/api/mcp
    Connect Claude

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

Command
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.

CallCredits
Search companiesCredits:Used per company returned
Search NYC buildingsCredits:Used per building returned
Get a recordCredits:Used once; no credits to read it again within 30 days
Find an owner's contactCredits:Used only when a phone or email is found
Research a companyCredits:Used once; no credits for the same company again within 30 days
Projects and leads, get research, balanceCredits:No credits

Questions about credits? Request demo

Errors

StatusMeaning
401Meaning:The key is missing or revoked.
400 bad_requestMeaning:Explains what is wrong with the request.
402 insufficient_creditsMeaning:Not enough credits; includes balance and needed.
404 not_foundMeaning:The key's workspace has no Project with that id.
422 search_too_broadMeaning:Add an industry, or a narrower revenue or headcount range.

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.

Request
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
ParameterWhat it does
showWhat it does:qualified (the default), review for those awaiting review, or all.
limit, offsetWhat it does:Page size, 1 to 100 (25 by default), and how many leads to skip.
Request
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
ParameterWhat it does
stateWhat it does:Two-letter state code, such as IL.
qWhat it does:How the company's name starts.
naicsWhat it does:Comma-separated. Six digits match exactly; fewer match every code that starts with them, such as 6216.
min_revenue, max_revenueWhat it does:Dollars; 1M and 250k also work. revenue=filed keeps only filed revenue.
min_employees, max_employeesWhat it does:Headcount range.
care_typeWhat 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_operatedWhat it does:true keeps organizations with an active state health license, enrolled in Medicare, or a Medicare agency its owners run.
owner_contactWhat it does:true keeps companies with an owner's phone or email on file.
limit, cursorWhat it does:Page size, at most 50, and the next_cursor from the last page.
Request
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.

Request
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
ParameterWhat it does
boroughWhat it does:Required: MN, BK, QN, BX or SI.
min_unitsWhat it does:10 by default.
qWhat it does:Part of the address or the owner's name.
loan_due_byWhat it does:A year: buildings whose current loan likely comes due by then, soonest first.
loan_holderWhat it does:agency (Fannie Mae or Freddie Mac), cmbs or bank.
signalWhat it does:rent_stabilized, dob_penalties, housing_court, tax_lien or ll97.
limit, cursorWhat it does:Page size and the next_cursor from the last page.
Request
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.

Request
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.

Request
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.

Request
curl https://app.dealport.com/api/v1/balance \
  -H "Authorization: Bearer dp_live_…"
Response
{ "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
ToolWhat it does
list_projectsWhat it does:Your Projects, with how many qualified and how many await review.
project_leadsWhat 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_companiesWhat it does:The same filters as Search companies.
search_buildingsWhat it does:NYC buildings, with the same filters as Search NYC buildings.
get_recordWhat it does:A company or building in full.
find_contactWhat it does:An owner's phone and email.
research_company, get_researchWhat it does:Start a research, then read it.
account_balanceWhat 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.

Command
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.