cURL
curl "https://api.haau3.com/v1/fhir/r4/Location?organization=Organization-1093090342&_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.searchLocation({ organization: "Organization-1093090342", _count: 2 });
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_location(organization="Organization-1093090342", 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.SearchLocation(ctx, haau3.SearchLocationParams{Organization: new("Organization-1093090342"), 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/Location?organization=Organization-1093090342&_count=2"
},
{
"relation": "next",
"url": "https://api.haau3.com/v1/fhir/r4/Location?organization=Organization-1093090342&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRSFYrVWVUaXNmMW1uT2R0blB3TzlaQUFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTVVSeGw1WmpNUHlzTHhwQkRBZ0VRZ0R1MDNCRmxyalc0ODhlRkhCUk5JS2xpcmtPSUlYeDZ6dWpnMnBGbFBBWEdwSy9ENTBtS3NWRk5BOXlycW5VK0FZc2htb1JxeFcwa2kvUk4wZz09Q3F5uM4EUvNqzomohLSqIkCV4eWlofCoKUy2qmGw20wX56X-dEkL05DRKciQwBgqF0un_m3MQXTUgcXiBaPYGxUgP_5KCbItOjprTWTPFlnno11u4b8cfr3AQ-vjNKAct5dPw7YBtd81XGSgavrT6KEqreKfbS_gHF1LQHcxVcPcngHry6Q1d9KN6nj7rXqNWZWK0NC6kNX2ANEgBWhAj_4g5A5E1RMMKoY2IW5GIb-aWDY1NrWqOBU2GXE4PgpueouEMBESe_Uw3Jx8N311Uh4SV08H2QLdXpLpWrgPYFrwizjb6eXygnWVpBRbzfMJrzJKH137w-jWQqyIe7kpZAqMIzFHokChI6uAifmsvZ1V0uq2WbkbK6qrghKuU1UNPAVpFkpnxUIx-FHTi5Z2WRJUFJJ3jflT1FrArVyU2hOspNbowsl0bulGhq05BY1WPfF_WmwwbeTyvH6W93vlVXr7nywckBi-jdSzO42mjgM07i5MGeiiZN9Yh2Jz4XJV6XhkO8Z2qwgL4xskdMczQBJnHAYY4uVF7chDZ1UqY_G71lXgqU1RdcmRQJ1EE1c96zf8kMZwOUeb3dpvEV2KFv-4dfQ-U172EiHW9zSJCaWNgpaN-N1jv-WOWUM67cT4kTjRa_zoFQKTKe9xIoIc4CG_K4iTFHdAzGw3P6i1VUsBReI3cm0rxqc_fdRiuadIhyb4OR8pE_yP-I0fCwEX7u9TeZ6iBrsyEc_feeuRj_oOX25aR4LwdvC6iBcpHy591XaZGY_yjHrapfe-pAWI3ndAEydpQ_KalQrihraoGGQEhc6Ka1_qxhMyQVEckm43J-GSXxeDe1QITwbAjQVXR778OznOf8RWYqyXOtl70XBWX5dM6IRtP_M5NrxtTKumqg_pDqYB47gYPnU0t8fA2AcDVjY5yHtkxgTwt3Plq0ZiwMImCOOyu62QxCYBdwNNGvyrX5WTd5gYjgHn4DqS4-owEvQgwiit1Wk6fXuqx8QM53cRYUzBxgwpTgaKwKqKWthKXw%3D%3D"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Location/Location-19ee3838-0fb8-4af1-a912-2906f6a315f7",
"resource": {
"resourceType": "Location",
"id": "Location-19ee3838-0fb8-4af1-a912-2906f6a315f7",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:57:02.131435914Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Location"
]
},
"status": "active",
"name": "7511 S Louise Ave",
"description": "7511 S Louise Ave",
"mode": "instance",
"telecom": [
{
"system": "fax",
"value": "6053353282",
"use": "work"
},
{
"system": "phone",
"value": "6053128700",
"use": "work"
},
{
"system": "phone",
"value": "6053345850",
"use": "work"
}
],
"address": {
"type": "physical",
"line": [
"7511 S Louise Ave"
],
"city": "Sioux Falls",
"state": "SD",
"postalCode": "57108",
"country": "US"
},
"position": {
"longitude": -96.76733,
"latitude": 43.47856
},
"managingOrganization": {
"reference": "Organization/Organization-1093090342"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Location/Location-1c36f608-52f8-4d45-8bac-158ef184882d",
"resource": {
"resourceType": "Location",
"id": "Location-1c36f608-52f8-4d45-8bac-158ef184882d",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:59:16.681817075Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Location"
]
},
"status": "active",
"name": "5920 E Madison St",
"description": "5920 E Madison St",
"mode": "instance",
"telecom": [
{
"system": "fax",
"value": "6053282957",
"use": "work"
},
{
"system": "fax",
"value": "6056100661",
"use": "work"
},
{
"system": "phone",
"value": "6053125000",
"use": "work"
}
],
"address": {
"type": "physical",
"line": [
"5920 E Madison St"
],
"city": "Sioux Falls",
"state": "SD",
"postalCode": "57110",
"country": "US"
},
"position": {
"longitude": -96.64536,
"latitude": 43.51173
},
"managingOrganization": {
"reference": "Organization/Organization-1093090342"
}
},
"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 practice locations
Search Location by managing organization or name; the address parameters and status narrow a search but cannot stand alone. A distance search (near) is refused because the directory does not apply it.
GET
/
v1
/
fhir
/
r4
/
Location
cURL
curl "https://api.haau3.com/v1/fhir/r4/Location?organization=Organization-1093090342&_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.searchLocation({ organization: "Organization-1093090342", _count: 2 });
console.log(bundle.entry?.length ?? 0);
from haau3 import Haau3
client = Haau3() # reads HAAU3_API_KEY
bundle = client.search_location(organization="Organization-1093090342", 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.SearchLocation(ctx, haau3.SearchLocationParams{Organization: new("Organization-1093090342"), 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/Location?organization=Organization-1093090342&_count=2"
},
{
"relation": "next",
"url": "https://api.haau3.com/v1/fhir/r4/Location?organization=Organization-1093090342&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRSFYrVWVUaXNmMW1uT2R0blB3TzlaQUFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTVVSeGw1WmpNUHlzTHhwQkRBZ0VRZ0R1MDNCRmxyalc0ODhlRkhCUk5JS2xpcmtPSUlYeDZ6dWpnMnBGbFBBWEdwSy9ENTBtS3NWRk5BOXlycW5VK0FZc2htb1JxeFcwa2kvUk4wZz09Q3F5uM4EUvNqzomohLSqIkCV4eWlofCoKUy2qmGw20wX56X-dEkL05DRKciQwBgqF0un_m3MQXTUgcXiBaPYGxUgP_5KCbItOjprTWTPFlnno11u4b8cfr3AQ-vjNKAct5dPw7YBtd81XGSgavrT6KEqreKfbS_gHF1LQHcxVcPcngHry6Q1d9KN6nj7rXqNWZWK0NC6kNX2ANEgBWhAj_4g5A5E1RMMKoY2IW5GIb-aWDY1NrWqOBU2GXE4PgpueouEMBESe_Uw3Jx8N311Uh4SV08H2QLdXpLpWrgPYFrwizjb6eXygnWVpBRbzfMJrzJKH137w-jWQqyIe7kpZAqMIzFHokChI6uAifmsvZ1V0uq2WbkbK6qrghKuU1UNPAVpFkpnxUIx-FHTi5Z2WRJUFJJ3jflT1FrArVyU2hOspNbowsl0bulGhq05BY1WPfF_WmwwbeTyvH6W93vlVXr7nywckBi-jdSzO42mjgM07i5MGeiiZN9Yh2Jz4XJV6XhkO8Z2qwgL4xskdMczQBJnHAYY4uVF7chDZ1UqY_G71lXgqU1RdcmRQJ1EE1c96zf8kMZwOUeb3dpvEV2KFv-4dfQ-U172EiHW9zSJCaWNgpaN-N1jv-WOWUM67cT4kTjRa_zoFQKTKe9xIoIc4CG_K4iTFHdAzGw3P6i1VUsBReI3cm0rxqc_fdRiuadIhyb4OR8pE_yP-I0fCwEX7u9TeZ6iBrsyEc_feeuRj_oOX25aR4LwdvC6iBcpHy591XaZGY_yjHrapfe-pAWI3ndAEydpQ_KalQrihraoGGQEhc6Ka1_qxhMyQVEckm43J-GSXxeDe1QITwbAjQVXR778OznOf8RWYqyXOtl70XBWX5dM6IRtP_M5NrxtTKumqg_pDqYB47gYPnU0t8fA2AcDVjY5yHtkxgTwt3Plq0ZiwMImCOOyu62QxCYBdwNNGvyrX5WTd5gYjgHn4DqS4-owEvQgwiit1Wk6fXuqx8QM53cRYUzBxgwpTgaKwKqKWthKXw%3D%3D"
}
],
"entry": [
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Location/Location-19ee3838-0fb8-4af1-a912-2906f6a315f7",
"resource": {
"resourceType": "Location",
"id": "Location-19ee3838-0fb8-4af1-a912-2906f6a315f7",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:57:02.131435914Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Location"
]
},
"status": "active",
"name": "7511 S Louise Ave",
"description": "7511 S Louise Ave",
"mode": "instance",
"telecom": [
{
"system": "fax",
"value": "6053353282",
"use": "work"
},
{
"system": "phone",
"value": "6053128700",
"use": "work"
},
{
"system": "phone",
"value": "6053345850",
"use": "work"
}
],
"address": {
"type": "physical",
"line": [
"7511 S Louise Ave"
],
"city": "Sioux Falls",
"state": "SD",
"postalCode": "57108",
"country": "US"
},
"position": {
"longitude": -96.76733,
"latitude": 43.47856
},
"managingOrganization": {
"reference": "Organization/Organization-1093090342"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://api.haau3.com/v1/fhir/r4/Location/Location-1c36f608-52f8-4d45-8bac-158ef184882d",
"resource": {
"resourceType": "Location",
"id": "Location-1c36f608-52f8-4d45-8bac-158ef184882d",
"meta": {
"versionId": "1",
"lastUpdated": "2026-10-14T20:59:16.681817075Z",
"profile": [
"http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Location"
]
},
"status": "active",
"name": "5920 E Madison St",
"description": "5920 E Madison St",
"mode": "instance",
"telecom": [
{
"system": "fax",
"value": "6053282957",
"use": "work"
},
{
"system": "fax",
"value": "6056100661",
"use": "work"
},
{
"system": "phone",
"value": "6053125000",
"use": "work"
}
],
"address": {
"type": "physical",
"line": [
"5920 E Madison St"
],
"city": "Sioux Falls",
"state": "SD",
"postalCode": "57110",
"country": "US"
},
"position": {
"longitude": -96.64536,
"latitude": 43.51173
},
"managingOrganization": {
"reference": "Organization/Organization-1093090342"
}
},
"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 locations one organization manages. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.
Required string length:
1 - 256Matches the location's name.
Required string length:
1 - 100Narrows a search by city; cannot be used on its own.
Required string length:
1 - 100Narrows a search by state; cannot be used on its own.
Required string length:
1 - 50Narrows a search by postal code; cannot be used on its own.
Required string length:
1 - 100active, suspended or inactive. Narrows a search; cannot be used on its own.
Required string length:
1 - 256Location:organization brings the organization that manages each location. Repeat the parameter to include several. Included entries do not count toward _count.
Required array length:
1 - 16 elementsAvailable options:
Location:organization PractitionerRole:location brings the roles held at each location. 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.
Required array length:
1 - 16 elementsAvailable options:
PractitionerRole:location A Location 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