cURL

curl "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_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.searchOrganizationAffiliation({
  network: "Organization-ea579d05-454e-4359-8751-900c940a599a",
  _count: 2,
});
console.log(bundle.entry?.length ?? 0);

from haau3 import Haau3

client = Haau3()  # reads HAAU3_API_KEY
bundle = client.search_organization_affiliation(network="Organization-ea579d05-454e-4359-8751-900c940a599a", 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.SearchOrganizationAffiliation(ctx, haau3.SearchOrganizationAffiliationParams{Network: new("Organization-ea579d05-454e-4359-8751-900c940a599a"), 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/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_count=2"
    },
    {
      "relation": "next",
      "url": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRSFFVaE43NWhqL0RpZURPb1Y3b1lCRkFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTVY5SmxtMisyZzNZNWxtczJBZ0VRZ0R2WmtUK1k2dEhnSkVzZmpid2RNVmxsaWFnNGhUcmVXck54Q2NQQVFIQlBxV25PRisvNjcrRDU0MzY1OTIzczc4dFlFSTIvNWo5cWg4ZXU2dz09O6lhnDedPtaQSgXxE1mpybg5ZuW6Bg8a0GxRUshtbccMOKGc20OQY0VoHnQmdEkcc_ujkS5zaJGKeGnfdG99X4kqwYWB28EzQEFbW4lZktWA7N95LIMpplFREOzrh-HC8Kcvys84QycEvjWDcLfbL6Hdeva4zXEuTN3UOvV4mTsxvneZkCZ3myrjTKLJ8lpDIE1HjyEXTC_dTbhLMCmEe5tJXOKyUu87_xRxtA5C0Gv1mssjTlAZVYSR4CnOx8-Zq4LNY_Axf9G6E41mqe0rUOXZP7YjedeIpu7AeDcIWbzZpHs4CLpip-1hSQxXmuQemDbVLTrCMZPX2jnkAxFsFf_WHaJ248qpRyVV3zdG2xLrPOHjyPO4bHsAfaziMG2xJhzYoBHyccvWHaUB0Qmq5xUTRaA7KXBHAjniV8c7wmdRxbe3CVPWVXHaD2KocLSK6ajsn5qdr4_rujLVRvnIHA4OWfzHSWpAXXeKrrIxgJGEJ3oWCZhG90I50YgTYZ2iBpFV_yA0Ru3H5UhEOcYeKb_LLguhuWJcQd_wYKx3wG_rwkaaGLBhLOI6n4jGdvbpc73UclkFi3KI3eNwuWYs3gI2i3e2seeH_AKZJ2d-t_XVnz5qzSmbxSQms4tnpiXLYaVLuxv6EZGS3B13y_6mqrF28GHS4LclFbgEyvt8FX1HdCbjMov2R7H2-sH0ag-p5e-VdwFw2I__XWUE2IWT1T6DS8uT_eaBUuVSLuLr09Hh7OIS_ngJjCLCLUyjLAL8uYsow1YYqfZoFknKMb19n2Ze_sFZPgsAzUOdRMYOfGo7Lm3QbIQ0hFikMuePB75dwosqxgUET6Ts-nPKJlASOG7hRouXQjcufZuRnlA1xC2Y2MXYfbiWcpqNXIkIwm_1VBdLZ2SpwP41gQnF-W8WTfU8jBsJxY0ZrcG-Edl2-F834R48yXvNFuyIC3AlSvT2Fb3hT-sszQeCyOHeHqiiVeAgSXiXRTI55cU2mvxxt2xU7bNie0OkaKMpluB5NXjK3-OFrvN9p-8cYOxNfVqaXVE4CpEiY-yg"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation/OrganizationAffiliation-000cc9b9-738c-43cd-b923-03ac9ab4714d",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "OrganizationAffiliation-000cc9b9-738c-43cd-b923-03ac9ab4714d",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-14T21:12:38.183722348Z",
          "profile": [
            "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-OrganizationAffiliation"
          ]
        },
        "active": true,
        "organization": {
          "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
        },
        "participatingOrganization": {
          "reference": "Organization/Organization-1972503142"
        },
        "network": [
          {
            "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
          }
        ]
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation/OrganizationAffiliation-00143df2-30a6-454b-a82c-c3ea8a2d59ae",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "OrganizationAffiliation-00143df2-30a6-454b-a82c-c3ea8a2d59ae",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-14T21:12:37.946536507Z",
          "profile": [
            "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-OrganizationAffiliation"
          ]
        },
        "active": true,
        "organization": {
          "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
        },
        "participatingOrganization": {
          "reference": "Organization/Organization-1932757820"
        },
        "network": [
          {
            "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
          }
        ]
      },
      "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 the organizations in a network

Search OrganizationAffiliation: which organizations take part in which networks. network lists a network’s members; with participating-organization beside it, it asks whether the directory lists that organization in that network. The directory’s network data is sparse, so an organization a network’s records do not list is not shown to be out of network. For a network, the primary organization is the network itself.

GET

fhir

OrganizationAffiliation

cURL

curl "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_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.searchOrganizationAffiliation({
  network: "Organization-ea579d05-454e-4359-8751-900c940a599a",
  _count: 2,
});
console.log(bundle.entry?.length ?? 0);

from haau3 import Haau3

client = Haau3()  # reads HAAU3_API_KEY
bundle = client.search_organization_affiliation(network="Organization-ea579d05-454e-4359-8751-900c940a599a", 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.SearchOrganizationAffiliation(ctx, haau3.SearchOrganizationAffiliationParams{Network: new("Organization-ea579d05-454e-4359-8751-900c940a599a"), 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/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_count=2"
    },
    {
      "relation": "next",
      "url": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation?network=Organization-ea579d05-454e-4359-8751-900c940a599a&_count=2&page=AAMA-EFRSURBSGd2bzlHTkh2NkZNeXNGMkNKelNQaUp6aCtWTXNCNXh6R0owVG0xQ1RtRzZRSFFVaE43NWhqL0RpZURPb1Y3b1lCRkFBQUFmakI4QmdrcWhraUc5dzBCQndhZ2J6QnRBZ0VBTUdnR0NTcUdTSWIzRFFFSEFUQWVCZ2xnaGtnQlpRTUVBUzR3RVFRTVY5SmxtMisyZzNZNWxtczJBZ0VRZ0R2WmtUK1k2dEhnSkVzZmpid2RNVmxsaWFnNGhUcmVXck54Q2NQQVFIQlBxV25PRisvNjcrRDU0MzY1OTIzczc4dFlFSTIvNWo5cWg4ZXU2dz09O6lhnDedPtaQSgXxE1mpybg5ZuW6Bg8a0GxRUshtbccMOKGc20OQY0VoHnQmdEkcc_ujkS5zaJGKeGnfdG99X4kqwYWB28EzQEFbW4lZktWA7N95LIMpplFREOzrh-HC8Kcvys84QycEvjWDcLfbL6Hdeva4zXEuTN3UOvV4mTsxvneZkCZ3myrjTKLJ8lpDIE1HjyEXTC_dTbhLMCmEe5tJXOKyUu87_xRxtA5C0Gv1mssjTlAZVYSR4CnOx8-Zq4LNY_Axf9G6E41mqe0rUOXZP7YjedeIpu7AeDcIWbzZpHs4CLpip-1hSQxXmuQemDbVLTrCMZPX2jnkAxFsFf_WHaJ248qpRyVV3zdG2xLrPOHjyPO4bHsAfaziMG2xJhzYoBHyccvWHaUB0Qmq5xUTRaA7KXBHAjniV8c7wmdRxbe3CVPWVXHaD2KocLSK6ajsn5qdr4_rujLVRvnIHA4OWfzHSWpAXXeKrrIxgJGEJ3oWCZhG90I50YgTYZ2iBpFV_yA0Ru3H5UhEOcYeKb_LLguhuWJcQd_wYKx3wG_rwkaaGLBhLOI6n4jGdvbpc73UclkFi3KI3eNwuWYs3gI2i3e2seeH_AKZJ2d-t_XVnz5qzSmbxSQms4tnpiXLYaVLuxv6EZGS3B13y_6mqrF28GHS4LclFbgEyvt8FX1HdCbjMov2R7H2-sH0ag-p5e-VdwFw2I__XWUE2IWT1T6DS8uT_eaBUuVSLuLr09Hh7OIS_ngJjCLCLUyjLAL8uYsow1YYqfZoFknKMb19n2Ze_sFZPgsAzUOdRMYOfGo7Lm3QbIQ0hFikMuePB75dwosqxgUET6Ts-nPKJlASOG7hRouXQjcufZuRnlA1xC2Y2MXYfbiWcpqNXIkIwm_1VBdLZ2SpwP41gQnF-W8WTfU8jBsJxY0ZrcG-Edl2-F834R48yXvNFuyIC3AlSvT2Fb3hT-sszQeCyOHeHqiiVeAgSXiXRTI55cU2mvxxt2xU7bNie0OkaKMpluB5NXjK3-OFrvN9p-8cYOxNfVqaXVE4CpEiY-yg"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation/OrganizationAffiliation-000cc9b9-738c-43cd-b923-03ac9ab4714d",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "OrganizationAffiliation-000cc9b9-738c-43cd-b923-03ac9ab4714d",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-14T21:12:38.183722348Z",
          "profile": [
            "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-OrganizationAffiliation"
          ]
        },
        "active": true,
        "organization": {
          "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
        },
        "participatingOrganization": {
          "reference": "Organization/Organization-1972503142"
        },
        "network": [
          {
            "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
          }
        ]
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "https://api.haau3.com/v1/fhir/r4/OrganizationAffiliation/OrganizationAffiliation-00143df2-30a6-454b-a82c-c3ea8a2d59ae",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "OrganizationAffiliation-00143df2-30a6-454b-a82c-c3ea8a2d59ae",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-14T21:12:37.946536507Z",
          "profile": [
            "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-OrganizationAffiliation"
          ]
        },
        "active": true,
        "organization": {
          "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
        },
        "participatingOrganization": {
          "reference": "Organization/Organization-1932757820"
        },
        "network": [
          {
            "reference": "Organization/Organization-ea579d05-454e-4359-8751-900c940a599a"
          }
        ]
      },
      "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

Authorization

string

header

required

Your platform API key (haau3_sk_…), sent as Authorization: Bearer <key>.

Headers

X-Request-Id

string<uuid>

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

network

string

The affiliations the directory lists in one insurance network. An organization the network's records do not list is not shown to be out of network: the directory's network data is sparse. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.

Required string length: 1 - 256

primary-organization

string

The affiliations whose primary organization is this one. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.

Required string length: 1 - 256

participating-organization

string

The affiliations one organization participates in. Give a Organization id, Organization/{id}, or the fullUrl this service returned. An address on another server is refused.

Required string length: 1 - 256

active

enum<string>

true or false. Narrows a search; cannot be used on its own.

Available options:

true,

false

_include

enum<string>[]

Bring the organizations an affiliation names: OrganizationAffiliation:participating-organization, OrganizationAffiliation:primary-organization or OrganizationAffiliation:network. Repeat the parameter to include several. Included entries do not count toward _count.

Required array length: 1 - 16 elements

Available options:

OrganizationAffiliation:participating-organization,

OrganizationAffiliation:primary-organization,

OrganizationAffiliation:network

_id

string

A OrganizationAffiliation 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}$

_summary

enum<string>

count only: answers how many records match, as total, with no entries. Cannot be combined with _include, _revinclude, _count or page.

Available options:

count

_count

integer

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 <= 100

page

string

Continuation cursor. Opaque: follow the next link from a previous response, and never construct or modify it. Cursors expire.

Required string length: 1 - 8192

Response

A FHIR Bundle with type: searchset. total is present when the directory sends one.

A FHIR R4 Bundle.

resourceType

string

required

Allowed value: "Bundle"

type

string

entry

object[]

Get started

Build

Scheduling

Terminology

Provider directory

Questionnaires

Plan Benefits

MedList

API reference

Find the organizations in a network

Authorizations

Headers

Query Parameters

Response