Documentation

NPI API

MethodPathDescription
GET/v1/npi/:npiSingle NPI lookup
POST/v1/npi/_batchBatch NPI lookup (up to 100)
GET/v1/npi/shapesList available response shapes

Look up a healthcare provider by NPI

Request
curl -X GET "https://api.fhirfly.io/v1/npi/1679576722" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
JSON
{
  "data": {
    "entity_type": "individual",
    "enumeration_date": "2005-05-23",
    "is_active": true,
    "last_update_date": "2007-07-08",
    "name": {
      "credential_text": "M.D.",
      "first": "DAVID",
      "last": "WIEBE",
      "middle": "A",
      "prefix": "",
      "sex": "M",
      "suffix": ""
    },
    "npi": "1679576722",
    "organization_name": null,
    "practice_address": {
      "city": "KEARNEY",
      "country": "US",
      "fax": "3088652506",
      "line1": "3500 CENTRAL AVE",
      "line2": "",
      "phone": "3088652512",
      "postal": "688472944",
      "state": "NE"
    },
    "taxonomies": [
      {
        "classification": "Orthopaedic Surgery",
        "code": "207X00000X",
        "display_name": "Orthopaedic Surgery Physician",
        "grouping": "Allopathic & Osteopathic Physicians",
        "license_number": "12637",
        "license_state": "NE",
        "primary": true,
        "specialization": null
      }
    ]
  },
  "meta": {
    "legal": {
      "attribution_required": false,
      "citation": "CMS NPPES with NUCC Taxonomy. Accessed 2026-01-14 via FHIRfly.",
      "license": "public_domain",
      "source_name": "CMS NPPES with NUCC Taxonomy"
    }
  }
}
TypeDescription
individualIndividual healthcare provider (Type 1)
organizationHealthcare organization (Type 2)

Look up multiple providers

Request
curl -X POST "https://api.fhirfly.io/v1/npi/_batch" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "npis": [
      "1679576722",
      "1588667638",
      "1215930367"
    ]
  }'
Response
JSON
{
  "data": {
    "found": 3,
    "not_found": 0,
    "results": [
      {
        "npi": "1679576722",
        "data": {
          "entity_type": "individual",
          "name": {
            "first": "DAVID",
            "last": "WIEBE"
          },
          "taxonomies": [
            {
              "code": "207X00000X",
              "classification": "Orthopaedic Surgery"
            }
          ]
        }
      },
      {
        "npi": "1588667638",
        "data": {
          "entity_type": "individual",
          "name": {
            "first": "WILLIAM",
            "last": "PILCHER"
          },
          "taxonomies": [
            {
              "code": "208600000X",
              "classification": "Surgery"
            }
          ]
        }
      },
      {
        "npi": "1215930367",
        "data": {
          "entity_type": "individual",
          "name": {
            "first": "LAURENT",
            "last": "GRESSOT"
          },
          "taxonomies": [
            {
              "code": "207Q00000X",
              "classification": "Family Medicine"
            }
          ]
        }
      }
    ]
  }
}
ShapeDescription
compactMinimal data for lists and autocomplete
standardCore structured data (default)
fullComplete data with provenance for AI agents
# Minimal data
GET /v1/npi/1679576722?shape=compact

# Standard data (default)
GET /v1/npi/1679576722?shape=standard

# Full data with provenance
GET /v1/npi/1679576722?shape=full