cURL
curl "https://api.haau3.com/v1/fhir/r4/HealthcareService?location=Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d&_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.searchHealthcareService({
location: "Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d",
_count: 2,
});
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_healthcare_service(location="Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d", 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.SearchHealthcareService(ctx, haau3.SearchHealthcareServiceParams{Location: new("Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d"), 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/HealthcareService?location=Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d&_count=2"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/HealthcareService/HealthcareService-0009bcae-631e-45c0-9d3c-5691acb4a05d",
"resource": {
"resourceType": "HealthcareService",
"id": "HealthcareService-0009bcae-631e-45c0-9d3c-5691acb4a05d",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T21:17:34.307230248Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-HealthcareService"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference",
"valueReference": {
"reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
}
}
],
"active": true,
"location": [
{
"reference": "Location/Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d"
}
]
},
"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>"
]
}
]
}Provider directory
Find healthcare services
Search HealthcareService by location, or by network beside a location. The directory’s service records name a network and, for a few, a location; none names an organization, so organization is refused rather than answered with nothing.
GET
/
v1
/
fhir
/
r4
/
HealthcareService
cURL
curl "https://api.haau3.com/v1/fhir/r4/HealthcareService?location=Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d&_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.searchHealthcareService({
location: "Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d",
_count: 2,
});
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_healthcare_service(location="Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d", 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.SearchHealthcareService(ctx, haau3.SearchHealthcareServiceParams{Location: new("Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d"), 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/HealthcareService?location=Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d&_count=2"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/HealthcareService/HealthcareService-0009bcae-631e-45c0-9d3c-5691acb4a05d",
"resource": {
"resourceType": "HealthcareService",
"id": "HealthcareService-0009bcae-631e-45c0-9d3c-5691acb4a05d",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T21:17:34.307230248Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-HealthcareService"
]
},
"extension": [
{
"url": "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference",
"valueReference": {
"reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
}
}
],
"active": true,
"location": [
{
"reference": "Location/Location-ba334cb2-a0f9-4147-ab31-1c5af4ab9a4d"
}
]
},
"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
The services offered at one location. Give a Location id, Location/{id}, or the fullUrl this service returned. An address on another server is refused.
Required string length:
1 - 256The services the directory lists in one insurance network. Cannot be used on its own: send it beside location. A search that breaks this rule is refused before the directory is asked. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.
Required string length:
1 - 256true or false. Narrows a search; cannot be used on its own.
Available options:
true, false A HealthcareService id. Searching by id rather than reading it lets one request also bring the records an _include or _revinclude names.
Pattern:
^[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.
Available options:
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.
Required range:
1 <= x <= 100Continuation cursor. Opaque: follow the next link from a previous response, and never construct or modify it. Cursors expire.
Required string length:
1 - 8192