# OneShot Agent API – Person Health Provider Lookup

> OneShot Agent API – Person Health Provider Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Look up a US licensed healthcare provider by NPI number or by name and state, returning their credentials, specialties, addresses, and license details.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/person-health-provider?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-person-health-provider-lookup-48cae3bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YL6M6KUPmk3I7n_AjOJ6t

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 oneshot-agent-api-person-health-provider-lookup-48cae3bd -d '<json body>'
```

Example prompt: Can you look up the healthcare provider with NPI 1245319599 and tell me their specialty, license state, and practice address?

## When to prefer this

Use this endpoint when you need authoritative US healthcare provider data sourced from the NPPES registry — especially for verifying NPI numbers, checking provider credentials and specialties, or retrieving official practice and mailing addresses. Prefer this over general web search or person-enrichment endpoints when the subject is a licensed US health professional and you need structured, license-level detail. It accepts either a direct NPI lookup (fast, deterministic) or a name+state search (broader discovery).

## Known failure modes

- No matching provider found — returns empty providers array with total: 0
- Invalid NPI format (must be exactly 10 digits) — likely returns an error or empty result
- Both NPI and last name provided simultaneously — API documentation says never provide both; may return an error
- Missing required pairing (last name without state) — state is required when searching by name
- State code not recognized — must be a valid two-letter US code
- Payment failure via x402 — call not executed if USDC payment on Base cannot be settled

## How this service works

Look up a US individual health care provider by provider number, or by name and state.

## Output

Returns a JSON object with a total count and an array of matching provider records. Each record includes the provider's NPI, active status, name, credential (e.g. MD, DO, NP), specialties (with taxonomy code, description, license number and state), registration and last-updated dates, mailing address, and practice address with phone numbers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "npi": {
   "type": "string",
   "description": "The health provider number. Give this, or a last name and state, never both. A health provider number is exactly 10 digits."
  },
  "city": {
   "type": "string",
   "description": "A city, to narrow a name search. 1 to 100 characters."
  },
  "limit": {
   "type": "integer",
   "description": "Most providers to return from a name search. From 1 to 20. Defaults to `5`."
  },
  "state": {
   "type": "string",
   "description": "US state code. Needs last name. A state is two capital letters, such as TX."
  },
  "last_name": {
   "type": "string",
   "description": "Last name of the practitioner. Needs state. 1 to 100 characters."
  },
  "first_name": {
   "type": "string",
   "description": "First name of the practitioner, to narrow a name search. 1 to 100 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "providers": [
   {
    "npi": "1245319599",
    "active": true,
    "last_name": "SAMPLE",
    "credential": "MD",
    "first_name": "LAURA",
    "specialties": [
     {
      "code": "207Q00000X",
      "primary": true,
      "description": "Family Medicine",
      "license_state": "VA",
      "license_number": "0101244988"
     }
    ],
    "registered_on": "2006-11-06",
    "last_updated_on": "2025-10-17",
    "mailing_address": {
     "city": "PORTSMOUTH",
     "phone": "757-953-0831",
     "state": "VA",
     "street": "620 JOHN PAUL JONES CIR",
     "postal_code": "23708-2111"
    },
    "practice_address": {
     "city": "VIRGINIA BEACH",
     "phone": "757-395-6070",
     "state": "VA",
     "street": "1080 FIRST COLONIAL RD, SUITE 200",
     "postal_code": "23454-2406"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-person-health-provider-lookup-48cae3bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)