# Get provider coverage by plan and NPI

Returns a nested list of provider coverage results grouped by bid ID and NPI. Used to determine whether a provider participates in specific Medicare Advantage plans.


Endpoint: POST /providers/coverage
Version: 1.6.1
Security: bearerAuth

## Request fields (application/json):

  - `contractYear` (integer, required)
    Contract year to query (e.g., 2023)
    Example: 2023

  - `bidIds` (array, required)
    Medicare bid IDs for plan lookup
    Example: ["H1234_001_000"]

  - `npis` (array, required)
    List of NPIs and optional related location IDs

  - `npis.npi` (string, required)
    Example: "1234567890"

  - `npis.locationIds` (array)
    Example: ["loc_001","loc_002"]

## Response 200 fields (application/json):

  - `contractYear` (integer)
    Example: 2023

  - `bidId` (string)
    Example: "H1234_001_000"

  - `providers` (array)

  - `providers.provider` (object)

  - `providers.provider.id` (string)
    Example: "070851a5-9501-4801-9074-d84b88b8a804"

  - `providers.provider.npis` (array)
    Example: ["1234567890"]

  - `providers.provider.doingBusinessAs` (string,null)

  - `providers.provider.firstName` (string,null)
    Example: "Jane"

  - `providers.provider.lastName` (string,null)
    Example: "Smith"

  - `providers.provider.middleName` (string,null)
    Example: "Marie"

  - `providers.provider.prefix` (string,null)
    Example: "Dr."

  - `providers.provider.suffix` (string,null)
    Example: "Jr"

  - `providers.provider.gender` (string)
    Enum: "F", "M", "X"

  - `providers.provider.credentials` (array)
    Example: ["MD"]

  - `providers.provider.languages` (array)
    Example: ["English"]

  - `providers.provider.groupAffiliations` (array)
    Example: ["Vision Medical Group"]

  - `providers.provider.hospitalAffiliations` (array)
    Example: ["Rogue County Medical"]

  - `providers.networkStatus` (string)
    The provider's overall network status with this plan
    Enum: "in_network", "out_of_network"

  - `providers.locations` (array)

  - `providers.locations.id` (string)
    Provider location identifier
    Example: "loc_001"

  - `providers.locations.address` (object)

  - `providers.locations.address.streetLine1` (string)
    Primary street address line
    Example: "123 Main St"

  - `providers.locations.address.streetLine2` (string,null)
    Secondary street address line (apartment, suite, etc.)
    Example: "Suite 200"

  - `providers.locations.address.streetLine3` (string,null)
    Tertiary street address line
    Example: "Rm 22"

  - `providers.locations.address.city` (string)
    City name
    Example: "New York"

  - `providers.locations.address.state` (string)
    State abbreviation
    Example: "NY"

  - `providers.locations.address.zip` (string)
    ZIP code
    Example: "10001"

  - `providers.locations.address.fullAddress` (string)
    Complete formatted address string
    Example: "123 Main St Suite 200, New York, NY 10001"

  - `providers.locations.address.latitude` (number,null)
    Latitude coordinate (optional)
    Example: 40.7128

  - `providers.locations.address.longitude` (number,null)
    Longitude coordinate (optional)
    Example: -74.006

  - `providers.locations.phoneNumbers` (array)
    Example: ["+14155552671"]

  - `providers.locations.faxNumbers` (array)
    Example: ["+14155552671"]

  - `providers.locations.website` (string,null)
    Example: "https://www.example.com"

  - `providers.locations.email` (string,null)
    Example: "contact@example.com"

  - `providers.locations.groupAffiliations` (array)
    Groups affiliated with this location
    Example: ["Community Health Center"]

  - `providers.locations.hospitalAffiliations` (array)
    Hospitals affiliated with this location
    Example: ["Rogue County Medical"]

  - `providers.locations.pcpEligible` (boolean)
    Whether the provider may be eligible for PCP designation at this location

  - `providers.locations.networkStatus` (string)
    The provider's network status designation at this particular location.
    Enum: "in_network", "out_of_network"