curl "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2" \
-H "Authorization: Bearer $HAAU3_API_KEY"import { Haau3 } from "@haau3/sdk";
const haau3 = new Haau3(); // reads HAAU3_API_KEY
const bundle = await haau3.searchOrganization({ type: "ntwk", _count: 2 });
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_organization(type="ntwk", count=2)
print(len(bundle.get("entry", [])))
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)
}
bundle, err := client.SearchOrganization(ctx, haau3.SearchOrganizationParams{Type: new("ntwk"), Count: new(2)})
if err != nil {
log.Fatal(err)
}
fmt.Println(len(bundle.Entry))
}
{
"resourceType": "Bundle",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2"
},
{
"relation": "next",
"url": "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRRlFsZHdrMHBleFdXNHJWUWdqdVFnUkFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTUcwNjZ1RHRDSHg2cmFmSjhBZ0VRZ0R2TlNZOHNEOC9Bdk1xQTR4ZG1PT3gzWGo5eTI2KzFFVm1ndnE0ZThIMllBVXU0bUlBL2NkaDd6NFg4dGNLWFFhWHBaTFBnNGdNZUp3Y1lHZz0983p39CwCUjpWSugnFrlXI6R_qkjtsw1vB86p5RVBZjMXTQbnDC-9W1MfBa0AXsABVevK4CtJA4sduYGsCDLx6RquJ7XNsC9I1aLOys1oap16pqiMZpy5SQQs_00NkQMjBC5aon49YGXY9w1ScGWcPNEYjj1JX6FTBlC0OQH21mLj5wDj_m3LL3e4Hp80rIx1D2IZfOJZhxS2eCXMxW8F4CUx-RXEdRkK9BxPhoDHiTTc8TzRRXghyeO7E5uamGV3gekBMm1IUxPJlS6Sn_Gzcy2W_gwcz3TdxMXwgcCrQ_JyeCHwTbuAgQz4vTCIXDaSVjVuNH_KbLdHet6OQ9UcFqtTJyZlldVz5Y-Q0yZvPZi4pKa6WUymNEmcH0hLYcPsAjBYlkKWkv3nr5_5nyP12QuIt0KKA5fOoX8UGf4SUtdIYFFPrNMOuAWLTGGrXRIvS_QSGiLAsVJjmq3QXd2Rjt_OOjuLJTiQGvRMljPahGyZuS2HrzDU7PIsENSF2w3ViieOKVEtbQPW3jtth4QdtJmx7s0m7gsv6xokEzfffObWlDirjnmmUVnvlxsC9YkHER-VpsRDF_Uk2jh9ufasN-INBU8jj2trOfMPsce2TVMlgp9Ei8W5ydEaZsj3959ErJ_k_bwbeOOJipZCNwBeyBRmCY5E0ZGGY-LeKP0z0dkTE1eLSZqMFKPEFcs_xhXe12JXJeAGzjxZ7D-jLZtKcUjLviLdblNE7VxfkcgeAquZPPzjVG83_KNkMswh4fZ479bRKLnRZvdT5yjJed-gDbfxXL5IOMM4BbranhQJf_9SzkZYZu8le-1i3kI_4FtP8VJYOdPopvDmXZLV8TJMbq_dp_imQh_6pk8XbTPegFYqrU1l3x4n3YZpOABK2VI9Qgj9-BYH3oUfqX6njGKyV9blC1VAsDIDac7BtwlN0dcWPactGT3NUae-lPiPgok8QmUwMyZPB0X_6pDGy3hrlWhhxBvq0Olz7lxJ9scXUN3IIudDrv90l-FTmFCoN2sWN-jq11fPwFUXyC3_"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Organization/Organization-0061f2ad-76fd-4eb3-906f-43bac6d6ea2b",
"resource": {
"resourceType": "Organization",
"id": "Organization-0061f2ad-76fd-4eb3-906f-43bac6d6ea2b",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:49:01.200431720Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status",
"valueCodeableConcept": {
"coding": [
{
"system": "http://hl7.org/fhir/us/ndh/CodeSystem/NdhVerificationStatusCS",
"code": "complete",
"display": "Complete"
}
]
}
}
],
"active": true,
"type": [
{
"text": "ntwk"
}
],
"name": "FAMILY HEALTH ALLIANCE MEDICAL GROUP"
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Organization/Organization-0379b9dd-f3f2-4680-aeee-402fcbcace00",
"resource": {
"resourceType": "Organization",
"id": "Organization-0379b9dd-f3f2-4680-aeee-402fcbcace00",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:49:01.202445008Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status",
"valueCodeableConcept": {
"coding": [
{
"system": "http://hl7.org/fhir/us/ndh/CodeSystem/NdhVerificationStatusCS",
"code": "complete",
"display": "Complete"
}
]
}
}
],
"active": true,
"type": [
{
"text": "ntwk"
}
],
"name": "ATLAS HEALTHCARE PHYSICIANS"
},
"search": {
"mode": "match"
}
}
]
}{
"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>"
]
}
]
}Find organizations, payers and networks
Search Organization by name, NPI, parent (partof) or type. type=ntwk lists the insurance networks the directory holds and type=pay its payers; any other type, active and the address parameters narrow a search but cannot stand alone.
The directory records networks by the text of their type rather than a code. This service searches that text for type=ntwk and confirms every answer is a network; if the directory changes how it records them, the search answers 502 rather than serve something else.
An NPI search can return a parent organization beside the practice, when the parent lists the NPI among several. _revinclude brings the roles, affiliations, locations and endpoints that point at each match, up to 100 per page.
curl "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2" \
-H "Authorization: Bearer $HAAU3_API_KEY"import { Haau3 } from "@haau3/sdk";
const haau3 = new Haau3(); // reads HAAU3_API_KEY
const bundle = await haau3.searchOrganization({ type: "ntwk", _count: 2 });
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_organization(type="ntwk", count=2)
print(len(bundle.get("entry", [])))
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)
}
bundle, err := client.SearchOrganization(ctx, haau3.SearchOrganizationParams{Type: new("ntwk"), Count: new(2)})
if err != nil {
log.Fatal(err)
}
fmt.Println(len(bundle.Entry))
}
{
"resourceType": "Bundle",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2"
},
{
"relation": "next",
"url": "https://api.haau3.com/v1/fhir/r4/Organization?type=ntwk&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRRlFsZHdrMHBleFdXNHJWUWdqdVFnUkFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTUcwNjZ1RHRDSHg2cmFmSjhBZ0VRZ0R2TlNZOHNEOC9Bdk1xQTR4ZG1PT3gzWGo5eTI2KzFFVm1ndnE0ZThIMllBVXU0bUlBL2NkaDd6NFg4dGNLWFFhWHBaTFBnNGdNZUp3Y1lHZz0983p39CwCUjpWSugnFrlXI6R_qkjtsw1vB86p5RVBZjMXTQbnDC-9W1MfBa0AXsABVevK4CtJA4sduYGsCDLx6RquJ7XNsC9I1aLOys1oap16pqiMZpy5SQQs_00NkQMjBC5aon49YGXY9w1ScGWcPNEYjj1JX6FTBlC0OQH21mLj5wDj_m3LL3e4Hp80rIx1D2IZfOJZhxS2eCXMxW8F4CUx-RXEdRkK9BxPhoDHiTTc8TzRRXghyeO7E5uamGV3gekBMm1IUxPJlS6Sn_Gzcy2W_gwcz3TdxMXwgcCrQ_JyeCHwTbuAgQz4vTCIXDaSVjVuNH_KbLdHet6OQ9UcFqtTJyZlldVz5Y-Q0yZvPZi4pKa6WUymNEmcH0hLYcPsAjBYlkKWkv3nr5_5nyP12QuIt0KKA5fOoX8UGf4SUtdIYFFPrNMOuAWLTGGrXRIvS_QSGiLAsVJjmq3QXd2Rjt_OOjuLJTiQGvRMljPahGyZuS2HrzDU7PIsENSF2w3ViieOKVEtbQPW3jtth4QdtJmx7s0m7gsv6xokEzfffObWlDirjnmmUVnvlxsC9YkHER-VpsRDF_Uk2jh9ufasN-INBU8jj2trOfMPsce2TVMlgp9Ei8W5ydEaZsj3959ErJ_k_bwbeOOJipZCNwBeyBRmCY5E0ZGGY-LeKP0z0dkTE1eLSZqMFKPEFcs_xhXe12JXJeAGzjxZ7D-jLZtKcUjLviLdblNE7VxfkcgeAquZPPzjVG83_KNkMswh4fZ479bRKLnRZvdT5yjJed-gDbfxXL5IOMM4BbranhQJf_9SzkZYZu8le-1i3kI_4FtP8VJYOdPopvDmXZLV8TJMbq_dp_imQh_6pk8XbTPegFYqrU1l3x4n3YZpOABK2VI9Qgj9-BYH3oUfqX6njGKyV9blC1VAsDIDac7BtwlN0dcWPactGT3NUae-lPiPgok8QmUwMyZPB0X_6pDGy3hrlWhhxBvq0Olz7lxJ9scXUN3IIudDrv90l-FTmFCoN2sWN-jq11fPwFUXyC3_"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Organization/Organization-0061f2ad-76fd-4eb3-906f-43bac6d6ea2b",
"resource": {
"resourceType": "Organization",
"id": "Organization-0061f2ad-76fd-4eb3-906f-43bac6d6ea2b",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:49:01.200431720Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status",
"valueCodeableConcept": {
"coding": [
{
"system": "http://hl7.org/fhir/us/ndh/CodeSystem/NdhVerificationStatusCS",
"code": "complete",
"display": "Complete"
}
]
}
}
],
"active": true,
"type": [
{
"text": "ntwk"
}
],
"name": "FAMILY HEALTH ALLIANCE MEDICAL GROUP"
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Organization/Organization-0379b9dd-f3f2-4680-aeee-402fcbcace00",
"resource": {
"resourceType": "Organization",
"id": "Organization-0379b9dd-f3f2-4680-aeee-402fcbcace00",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:49:01.202445008Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status",
"valueCodeableConcept": {
"coding": [
{
"system": "http://hl7.org/fhir/us/ndh/CodeSystem/NdhVerificationStatusCS",
"code": "complete",
"display": "Complete"
}
]
}
}
],
"active": true,
"type": [
{
"text": "ntwk"
}
],
"name": "ATLAS HEALTHCARE PHYSICIANS"
},
"search": {
"mode": "match"
}
}
]
}{
"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.
Query Parameters
Matches the organization's name.
1 - 100An organization's NPI, as {system}|{npi} or a bare 10-digit value, under the same systems Practitioner accepts. An NPI search can return more than the practice that holds the NPI: a parent organization that lists it among several NPIs is a match too, because it carries the NPI as an NPI.
1 - 256The organizations that are part of one organization. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.
1 - 256An organization type from http://terminology.hl7.org/CodeSystem/organization-type, bare or with that system: prov for healthcare providers, pay for payers, ntwk for insurance networks. ntwk is also accepted under Plan-Net's http://hl7.org/fhir/us/davinci-pdex-plan-net/CodeSystem/OrgTypeCS. type=ntwk and type=pay may stand alone, to list every network or every payer; any other type narrows a search. The directory records networks by the text of their type rather than a code; this service searches that text and confirms each answer is a network, and answers 502 rather than serve one that is not.
1 - 256true or false. Narrows a search; cannot be used on its own.
true, false Narrows a search by city; cannot be used on its own. Matches any of the organization's addresses, so a result can still list addresses in another city.
1 - 100Narrows a search by state; cannot be used on its own. Matches any of the organization's addresses, so a result can still list addresses in another state.
1 - 50Narrows a search by postal code; cannot be used on its own. Matches any of the organization's addresses, so a result can still list addresses in another postal code.
1 - 100Organization:partof brings the organization each match is part of. Repeat the parameter to include several. Included entries do not count toward _count.
1 - 16 elementsOrganization:partof Bring the records that point at each match: PractitionerRole:organization, OrganizationAffiliation:primary-organization, OrganizationAffiliation:participating-organization, Location:organization, Endpoint:organization or Organization:partof. Repeat the parameter to include several. Included entries do not count toward _count. The directory returns at most 100 included records per page; a page with more is refused with a 502 rather than served short.
1 - 16 elementsPractitionerRole:organization, OrganizationAffiliation:primary-organization, OrganizationAffiliation:participating-organization, Location:organization, Endpoint:organization, Organization:partof A Organization id. Searching by id rather than reading it lets one request also bring the records an _include or _revinclude names.
^[A-Za-z0-9\-.]{1,64}$count only: answers how many records match, as total, with no entries. Cannot be combined with _include, _revinclude, _count or page.
count Results are paged. _count sets the page size (1 to 100); a larger value is refused rather than quietly reduced. Follow link with relation next to continue. The cursor it carries is opaque and must not be constructed or modified.
1 <= x <= 100Continuation cursor. Opaque: follow the next link from a previous response, and never construct or modify it. Cursors expire.
1 - 8192