API & Partnerships

Bring licensed-contractor data into your product.

The same catalog we ship as $19 CSVs (798,000+ active licenses across 17 trades and 28 states) is live now via REST API and MCP for partners and AI agents.

REST API

For CRMs and lead tools

JSON API. Pull verified-license leads into Salesforce, HubSpot, Pipedrive, or your custom prospecting tool. Authenticated via API key, prepaid balance, atomic per-record debit. Dry-run preview before every call so you always know the cost.

Status: live

/api/v1/docs →

MCP Server

For AI agents

Model Context Protocol server. Same catalog as the REST API, exposed as agent-callable tools (list_states, list_trades, count_contractors, search_contractors, get_usage). Same auth, same balance, shortfall errors include the exact top-up amount so agents can prompt the user.

Status: live

/mcp setup guide →

Custom Integration

Bulk feeds, exclusives, white-label

Daily or weekly bulk feeds, geographic or vertical exclusivity, white-label CSV delivery to your customers under your brand. Negotiated per partnership.

Tell us your shape:

[email protected]

Get started

Three steps from inquiry to first delivery.

Step 1

Get an API key

Self-serve on the MCP page. Key emailed in under a minute. For CRM-partner pricing, email [email protected].

Step 2

Top up your balance

POST /api/v1/topup returns a Stripe checkout URL. $50 minimum, $10,000 max per session.

Step 3

Preview, then call

Send dry_run: true first to confirm cost. Then drop the flag to deliver records and debit.

Already have a key? Open your dashboard →

Free coverage endpoint

Qualify a search before committing balance. No auth required.

Request:
GET https://contractorroster.com/api/v1/coverage?state=CA&trade=GC
Response (truncated):
{
  "state": "CA",
  "state_name": "California",
  "trade": "GC",
  "trade_name": "General Contractor",
  "total": 118454,
  "sample": [
    { "business_name": "ACME CONSTRUCTION", "city": "LOS ANGELES",
      "zip": "90001", "license_number": "..." },
    ...
  ],
  "available": true
}

Free, rate-limited at 60 req/min per IP. Useful for prospecting integrations or qualifying searches before partners commit balance.

Pricing

Per record, prepaid. Same price across REST and MCP.

Standard

$0.10

per record

Default rate for new partners. No commitment, no monthly minimum.

CRM partner

$0.07

per record

CRMs and lead-management platforms passing usage through to customers. Email us to qualify.

Top up

$50

minimum

One Stripe checkout, balance credited via webhook. Max $10,000 per session.

[email protected]