Developers & AI clients

The Nexa coverage API, published as an OpenAPI 3.1 spec.

A read-only view of the Nexa Business Intelligence coverage book: which US states we cover, the government public-records datasets behind each one, headline collection totals, and anonymised state activity. Import the specification directly into ChatGPT, Claude, or any HTTP client.

Endpoints

GET https://leads.nexaofs.com/api/public/gpt/states

List every US state in the coverage book

Returns each covered state with its two-letter code, name, how many public-records sources have been researched, and how many of those already have a built connector.

GET https://leads.nexaofs.com/api/public/gpt/states/{state}

Get the public-records sources for one state

Describes each government dataset behind a state: dataset name, geographic coverage, collection method, refresh cadence, usage restrictions, whether a connector is built, and the official page to open.

GET https://leads.nexaofs.com/api/public/gpt/coverage

Headline coverage totals

Aggregate figures for the whole programme: states covered, businesses tracked, public-record signals collected, and how many sources are enabled. `countsLive` is false when live totals are temporarily unavailable.

GET https://leads.nexaofs.com/api/public/gpt/activity/{state}

Anonymised collection activity for one state

How much has been collected for a state, when the newest record landed, and anonymised example openings (city, vertical, opportunity score and signal age only). This API returns only coverage reference data and aggregate, anonymised activity. It never returns business names, street addresses, phone numbers, email addresses, owner names, customer accounts or billing figures.

Authentication

API key header

Every data endpoint requires an X-API-Key header. Keys are issued per client — ask us and we will provision one.

Fail closed

A missing or wrong key returns 401 with no data. Keys are compared in constant time and never appear in a response.

No contact data

The API returns coverage reference data and aggregate, anonymised activity only. No business names, addresses, phone numbers, emails, owner names or billing figures.

Connect a client

ChatGPT (GPT Action)

Create a GPT → Configure → Actions → Import from URL: https://leads.nexaofs.com/openapi.json. Set Authentication to API Key with custom header X-API-Key.

Claude, Cursor, Windsurf (MCP)

Add the MCP server at https://leads.nexaofs.com/mcp and sign in with your Nexa operator account. Same coverage tools, same answers.

Plain HTTP

curl -H "X-API-Key: <your key>" \
  https://leads.nexaofs.com/api/public/gpt/states

Discovery manifest: /.well-known/ai-plugin.json