curl "https://api.haau3.com/v1/fhir/r4/InsurancePlan/H3359-038-000/\$in-network?npi=1518929058&npi=1992700001" \
-H "Authorization: Bearer $HAAU3_API_KEY"import { Haau3 } from "@haau3/sdk";
const haau3 = new Haau3(); // reads HAAU3_API_KEY
const parameters = await haau3.checkInsurancePlanNetwork("H3359-038-000", {
npi: ["1518929058", "1992700001"],
});
for (const parameter of parameters.parameter ?? []) console.log(parameter.name);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
parameters = client.check_insurance_plan_network("H3359-038-000", npi=["1518929058", "1992700001"])
for parameter in parameters.get("parameter", []):
print(parameter.get("name"))
package main
import (
"context"
"fmt"
"log"
"github.com/haau3/haau3-go"
)
func main() {
ctx := context.Background()
client, err := haau3.NewClient() // reads HAAU3_API_KEY
if err != nil {
log.Fatal(err)
}
parameters, err := client.CheckInsurancePlanNetwork(ctx, "H3359-038-000", haau3.CheckInsurancePlanNetworkParams{NPI: []string{"1518929058", "1992700001"}})
if err != nil {
log.Fatal(err)
}
for _, parameter := range parameters.Parameter {
if parameter.Name != nil {
fmt.Println(*parameter.Name)
}
}
}
{
"resourceType": "Parameters",
"parameter": [
{
"name": "plan",
"valueReference": {
"reference": "InsurancePlan/H3359-038-000"
}
},
{
"name": "data-date",
"valueDate": "2026-10-14"
},
{
"name": "network",
"part": [
{
"name": "network",
"valueReference": {
"reference": "Organization/Organization-ed682d9f-98da-4ada-a081-04b4f80fe9f3",
"display": "Healthfirst Medicare Network H3359"
}
},
{
"name": "organizations-listed",
"valueInteger": 0
}
]
},
{
"name": "provider",
"part": [
{
"name": "npi",
"valueIdentifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1518929058"
}
},
{
"name": "status",
"valueCoding": {
"system": "https://haau3.com/fhir/CodeSystem/plan-benefits-network-status",
"code": "in-network",
"display": "In network"
}
},
{
"name": "evidence",
"valueReference": {
"reference": "PractitionerRole/PractitionerRole-0000099c-a432-43eb-a399-61a936d5cc60"
}
}
]
},
{
"name": "provider",
"part": [
{
"name": "npi",
"valueIdentifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1992700001"
}
},
{
"name": "status",
"valueCoding": {
"system": "https://haau3.com/fhir/CodeSystem/plan-benefits-network-status",
"code": "not-in-directory",
"display": "Not in the directory"
}
}
]
},
{
"name": "source",
"valueString": "CMS National Provider Directory: https://directory.cms.gov/fhir"
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}Check providers against a plan's network
FHIR instance-level operation $in-network on InsurancePlan: for each NPI, whether the CMS National Provider Directory lists the provider in a network this plan names, for the plan’s year. The answer is a Parameters resource: the plan; the directory’s data-date; one network per network checked, with the number of organizations it lists; a reason when there is no network data; a Marketplace plan’s own directory; one provider per NPI, in the order sent, with its status (in-network, not-found, not-in-directory or no-network-data) and, when listed, evidence references to the directory’s records on this base; then a source when the directory was asked. not-found never means out of network: the directory’s network data is incomplete, and a listing is not a statement of a contract. All or nothing: a lookup that fails fails the whole answer. GET only. Defined by the haau3 implementation guide (https://haau3.com/fhir/OperationDefinition/InsurancePlan-in-network).
curl "https://api.haau3.com/v1/fhir/r4/InsurancePlan/H3359-038-000/\$in-network?npi=1518929058&npi=1992700001" \
-H "Authorization: Bearer $HAAU3_API_KEY"import { Haau3 } from "@haau3/sdk";
const haau3 = new Haau3(); // reads HAAU3_API_KEY
const parameters = await haau3.checkInsurancePlanNetwork("H3359-038-000", {
npi: ["1518929058", "1992700001"],
});
for (const parameter of parameters.parameter ?? []) console.log(parameter.name);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
parameters = client.check_insurance_plan_network("H3359-038-000", npi=["1518929058", "1992700001"])
for parameter in parameters.get("parameter", []):
print(parameter.get("name"))
package main
import (
"context"
"fmt"
"log"
"github.com/haau3/haau3-go"
)
func main() {
ctx := context.Background()
client, err := haau3.NewClient() // reads HAAU3_API_KEY
if err != nil {
log.Fatal(err)
}
parameters, err := client.CheckInsurancePlanNetwork(ctx, "H3359-038-000", haau3.CheckInsurancePlanNetworkParams{NPI: []string{"1518929058", "1992700001"}})
if err != nil {
log.Fatal(err)
}
for _, parameter := range parameters.Parameter {
if parameter.Name != nil {
fmt.Println(*parameter.Name)
}
}
}
{
"resourceType": "Parameters",
"parameter": [
{
"name": "plan",
"valueReference": {
"reference": "InsurancePlan/H3359-038-000"
}
},
{
"name": "data-date",
"valueDate": "2026-10-14"
},
{
"name": "network",
"part": [
{
"name": "network",
"valueReference": {
"reference": "Organization/Organization-ed682d9f-98da-4ada-a081-04b4f80fe9f3",
"display": "Healthfirst Medicare Network H3359"
}
},
{
"name": "organizations-listed",
"valueInteger": 0
}
]
},
{
"name": "provider",
"part": [
{
"name": "npi",
"valueIdentifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1518929058"
}
},
{
"name": "status",
"valueCoding": {
"system": "https://haau3.com/fhir/CodeSystem/plan-benefits-network-status",
"code": "in-network",
"display": "In network"
}
},
{
"name": "evidence",
"valueReference": {
"reference": "PractitionerRole/PractitionerRole-0000099c-a432-43eb-a399-61a936d5cc60"
}
}
]
},
{
"name": "provider",
"part": [
{
"name": "npi",
"valueIdentifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1992700001"
}
},
{
"name": "status",
"valueCoding": {
"system": "https://haau3.com/fhir/CodeSystem/plan-benefits-network-status",
"code": "not-in-directory",
"display": "Not in the directory"
}
}
]
},
{
"name": "source",
"valueString": "CMS National Provider Directory: https://directory.cms.gov/fhir"
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "fatal",
"code": "<string>",
"details": {
"text": "<string>"
},
"diagnostics": "<string>",
"expression": [
"<string>"
]
}
]
}Authorizations
Your platform API key (haau3_sk_…), sent as Authorization: Bearer <key>.
Headers
An id of your own for this request, as a UUID. It comes back in the X-Correlation-Id header and is kept with haau3's record of the request. Any value that is not a UUID is ignored. See https://docs.haau3.com/errors#request-ids.
Path Parameters
The plan's id: H2406-013-000 or 19898FL0340001-01.
^[A-Za-z0-9\-.]{1,64}$Query Parameters
Up to 20 NPIs, ten digits each, as repeated npi parameters or separated by commas: npi=1992700001&npi=1992700002 or npi=1992700001,1992700002. Duplicates count once.
1 - 20 elements^[0-9]{10}(,[0-9]{10})*$Response
A Parameters resource with each NPI's status, in the order sent.
A FHIR R4 Parameters.