Licensees as a prospect list (tier, county, recent activity), JSON or CSV up to 5,000 rows. Costs 30 credits per call (research); the response carries X-ATI-Credits-Charged and X-ATI-Credits-Remaining.

get/v1/prospects

Request

  • Base URL: https://api.americantradesindex.com
  • URL: https://api.americantradesindex.com/v1/prospects
  • Auth: HTTP bearer

Query parameters

statestring required

Two-letter state (TX) or a metro key (NYC)

tradestring

Trade key: electrical, plumbing, hvac, fire_sprinkler, sheet_metal, elevator, boiler, well_drilling, appliance, electrical_sign

countystring

County name, used with state when fips is not given

county_fipsstring

5-digit FIPS

metrostring

Metro name

min_tierinteger

0-9

activeinteger

1 = active only

since_daysinteger

Licensed/changed within N days

limitinteger

Rows to return (max 5000)

format'json' | 'csv'

json (default) or csv

Response

prospects[] (or CSV)

Changes

No recorded changes to this operation across all 1 revision of this API.