# ProviderSignal NPI Lookup

> ProviderSignal NPI Lookup is a paid API for AI agents from providersignal.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-14).

Returns a unified healthcare provider record by 10-digit NPI, including identity, specialty, DSO affiliation, CMS claims history, and federal exclusion status.

## Facts

- Endpoint: GET https://providersignal.com/api/v1/agent/lookup-by-npi
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/providersignal-npi-lookup-b16d67a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WaTM-g-FIRYHWlw6kIyk1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability providersignal-npi-lookup-b16d67a6
```

Example prompt: Pull the ProviderSignal record for NPI 1376155820 — I need their specialty, DSO affiliation, whether they have CMS claims, and if they're on the federal exclusion list.

## When to prefer this

Choose this endpoint when you have a specific 10-digit NPI and need a single authoritative, cited provider record combining identity, specialty, DSO status, CMS history, and federal exclusion signals in one call. Prefer it over general directory search when the NPI is already known, or when compliance verification (OIG LEIE, Medicaid exclusion) is required alongside basic demographics.

## Known failure modes

- Invalid NPI format (not 10 digits) returns a 400 validation error
- NPI not found in the database returns a data null with an error object containing code and message
- Expired or missing Bearer token / unpaid x402 returns 401 or 402
- Payment failure on x402 or MPP rail returns 402 with payment details
- Source data temporarily stale may result in outdated last_refresh timestamps in citation envelope

## How this service works

Healthcare market intelligence API. Unified provider directory + acquisition signals + license-events feed across all 50 US states, derived from NPI + state dental boards + CMS Medicare + OIG LEIE + state Medicaid + HRSA HPSA designations. All responses ship a citation envelope (`meta.envelope_version`, `meta.source_attribution`, `meta.request`) so agents can verify source freshness without out-of-band validation. Paid `/api/v1/agent/*` endpoints accept two per-call rails on a single 402: x402 (USDC on Base mainnet) and MPP (Stripe card via a Shared Payment Token), plus Bearer-token subscription auth for existing API keys. See [/docs/agent-payments](/docs/agent-payments) for the full flow. See [/docs/fields](/docs/fields) for the field glossary and [/llms.txt](/llms.txt) for the LLM crawler index.

## Output

A JSON object containing the provider's NPI, first and last name, city, state, specialty, credential type (e.g. DDS), DSO affiliation boolean, CMS Medicare claims boolean, federal exclusion boolean, plus a meta envelope with source attribution (NPI, CMS, OIG LEIE, etc.), last refresh timestamps, and request billing details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "npi"
     ],
     "properties": {
      "npi": {
       "type": "string",
       "pattern": "^\\d{10}$",
       "description": "10-digit National Provider Identifier"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "error",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "npi": {
         "type": "string"
        },
        "city": {
         "type": [
          "string",
          "null"
         ]
        },
        "state": {
         "type": [
          "string",
          "null"
         ]
        },
        "is_dso": {
         "type": "boolean"
        },
        "last_name": {
         "type": [
          "string",
          "null"
         ]
        },
        "specialty": {
         "type": [
          "string",
          "null"
         ]
        },
        "first_name": {
         "type": [
          "string",
          "null"
         ]
        },
        "has_cms_claims": {
         "type": "boolean"
        },
        "credential_type": {
         "type": [
          "string",
          "null"
         ]
        },
        "is_federally_excluded": {
         "type": "boolean"
        }
       },
       "description": "Full provider record. Representative fields below; see /openapi.json for the complete column list.",
       "additionalProperties": true
      },
      "meta": {
       "type": "object",
       "required": [
        "envelope_version"
       ],
       "properties": {
        "request": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "endpoint": {
           "type": "string"
          },
          "billed_credits": {
           "type": "integer"
          },
          "billing_method": {
           "enum": [
            "subscription
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "npi": "1376155820",
   "city": "BAYTOWN",
   "state": "TX",
   "is_dso": false,
   "last_name": "LEE",
   "specialty": "General Dentist",
   "first_name": "STACEY",
   "has_cms_claims": true,
   "credential_type": "DDS",
   "is_federally_excluded": false
  },
  "meta": {
   "request": {
    "endpoint": "/api/v1/agent/lookup-by-npi",
    "billed_credits": 1,
    "billing_method": "per_query"
   },
   "envelope_version": "1.0"
  },
  "error": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/providersignal-npi-lookup-b16d67a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from providersignal.com](https://www.zero.xyz/host/providersignal.com/llms.txt)