Home › HSDS Open Referral
HSDS 3.0 Open Referral feed
Feed America publishes its full food-assistance directory in Human Services Data Specification 3.0 format — the standard adopted by Findhelp, United Way 211, Unite Us, and most academic SDOH research projects.
Endpoints
Base URL: https://feedam.org/hsds/v3/
| Entity | Path |
|---|---|
| Organizations | /hsds/v3/organizations |
| Services | /hsds/v3/services |
| Locations | /hsds/v3/locations |
| Service-at-Location | /hsds/v3/service_at_location |
| Phones | /hsds/v3/phones |
| Addresses | /hsds/v3/addresses |
| Schedules | /hsds/v3/schedules |
| Languages | /hsds/v3/languages |
| Taxonomy terms | /hsds/v3/taxonomy_terms |
| Attributes | /hsds/v3/attributes |
Format
- JSON (default) or CSV (
?format=csv) - Paginated 100/page (max 1000 via
?per_page=N) - Spec-compliant with HSDS 3.0
- Data package descriptor: /hsds/v3/datapackage.json
Use cases
- SDOH referral platforms (Findhelp, Unite Us, NowPow, Healthify) — ingest as a data source
- 211 networks — augment your local resource directory with cross-state data
- Academic researchers — peer-reviewed studies on food access have used our feed
- State agencies — emergency management + public-health agencies use our feed for planning
License
Creative Commons BY-SA 4.0. Federal source data is public domain. Attribution: "Data from Feed America, feedam.org, EIN 92-1761881."
Update cadence
Feed is regenerated on each upstream import (typically nightly). Cache-Control: 1 hour for the index, 24 hours for individual entity pages.
Support
Issues: info@feedam.org. We respond within 2 business days for spec compliance questions.