Skip to content

Developer API

A read-only JSON API exposing our published organizations and taxonomy in an HSDS-compatible (Open Referral, Human Services Data Specification 3.x) profile. No key required.

Conformance, honestly: this is a partial HSDS profile. It exposes HSDS organization and taxonomy objects only. It does not expose service, location, service_at_location, schedule, or contactobjects, and has no geocoordinates — our data is organization-centric (taxonomy tags on organizations), not service-level. An organization's classifications are Open Eligibility and NTEE tags, not separately-described HSDS services.

Endpoints

  • GET /api/hsds/v3Self-describing root (profile, version, links).
  • GET /api/hsds/v3/organizationsPaginated published organizations.
  • GET /api/hsds/v3/organizations/{id}A single organization by id.
  • GET /api/hsds/v3/taxonomiesThe three taxonomies we publish.
  • GET /api/hsds/v3/taxonomy_termsTaxonomy terms; filter with ?taxonomy=.

Notes

  • Pagination: ?page= and ?per_page= (default 20, max 100); responses use the HSDS envelope (total_items, total_pages, contents, links).
  • HSDS id values are deterministic UUIDv5 derived from our native ids; the native id is also returned as external_identifier / code.
  • Responses are cached at the edge for ~5 minutes.