{"uid":"cap_YL6M6KUPmk3I7n_AjOJ6t","slug":"oneshot-agent-api-person-health-provider-lookup-48cae3bd","name":"OneShot Agent API – Person Health Provider Lookup","description":"Look up a US individual health care provider by provider number, or by name and state.","url":"https://win.oneshotagent.com/v1/tools/lookup/person-health-provider?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_smK3lSqjsXHpv02Sp5BoM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up a US licensed healthcare provider by NPI number or by name and state, returning their credentials, specialties, addresses, and license details.","exampleAgentPrompt":"Can you look up the healthcare provider with NPI 1245319599 and tell me their specialty, license state, and practice address?","exampleUseCases":[{"title":"Verify physician credentials before referral","prompt":"I need to verify Dr. Sarah Johnson's credentials — she's a physician in Texas. Can you find her NPI, specialty, and license number using her last name Johnson and state TX?"},{"title":"Find practice address for a known NPI","prompt":"Look up NPI 1245319599 for me and return the doctor's full practice address and phone number so I can direct a patient there."},{"title":"Search for a specialist by name and location","prompt":"Find me up to 5 cardiologists with the last name Patel in California — I need their NPI numbers, specialties, and whether they're currently active."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:30:21.883Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-person-health-provider-lookup-48cae3bd"}