{"id":43850,"date":"2026-11-22T09:40:57","date_gmt":"2026-11-22T08:40:57","guid":{"rendered":"https:\/\/smartdatamodels.org\/?p=43850"},"modified":"2026-11-14T14:41:17","modified_gmt":"2026-11-14T13:41:17","slug":"human-services-data-specification-hsds-joins-smart-data-models-5-candidate-models-for-human-service-directories","status":"publish","type":"post","link":"https:\/\/smartdatamodels.org\/index.php\/human-services-data-specification-hsds-joins-smart-data-models-5-candidate-models-for-human-service-directories\/","title":{"rendered":"Human Services Data Specification (HSDS) Joins Smart Data Models: 5 Candidate Models for Human Service Directories"},"content":{"rendered":"<p>Smart Data Models\u2019 <a href=\"https:\/\/github.com\/smart-data-models\/Candidates\">Candidates repository<\/a> now includes a new candidate standard from <strong>Open Referral<\/strong>: <strong><code>hsds<\/code><\/strong>, with <strong>5 candidate models<\/strong> for directories of health, human and social services: the organizations, services, programs and locations of a community resource directory. The Human Services Data Specification is published under <strong>CC-BY-SA 4.0<\/strong>, so these derived models are shared under the same licence. Like every candidate, each model comes with a JSON Schema, an NGSI-LD <code>@context<\/code> and all four example serializations (NGSI-v2 and NGSI-LD, key-values and normalized), each validated against its schema.<\/p>\n<h2 id=\"about-hsds\">About the Human Services Data Specification<\/h2>\n<p><a href=\"https:\/\/openreferral.org\/\">Open Referral<\/a> develops the <a href=\"https:\/\/docs.openreferral.org\/en\/v3.3.1\/\">Human Services Data Specification (HSDS)<\/a>, also known as \u201cthe Open Referral format\u201d: an exchange format for publishing directory information about human services (food assistance, job training, child care, counselling\u2026) as open data. Governments, information-and-referral providers and community organizations use it to share who offers which service, where, when, for whom and at what cost. The candidate is based on <a href=\"https:\/\/github.com\/openreferral\/specification\/releases\/tag\/v3.3.1\">HSDS 3.3.1<\/a>, the latest release, which defines its objects as JSON Schemas.<\/p>\n<h2 id=\"the-models\">The models<\/h2>\n<table>\n<thead>\n<tr>\n<th>Model<\/th>\n<th>HSDS object<\/th>\n<th>What it describes<\/th>\n<th>Attributes<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>Organization<\/code><\/td>\n<td>organization<\/td>\n<td>An organization that delivers services, with funding, identifiers and phones<\/td>\n<td>24<\/td>\n<\/tr>\n<tr>\n<td><code>Service<\/code><\/td>\n<td>service<\/td>\n<td>A service: status, eligibility, fees, application process, operating hours, service areas, languages, costs, required documents<\/td>\n<td>38<\/td>\n<\/tr>\n<tr>\n<td><code>Location<\/code><\/td>\n<td>location<\/td>\n<td>A physical, postal or virtual place where services are delivered, with addresses and accessibility<\/td>\n<td>25<\/td>\n<\/tr>\n<tr>\n<td><code>ServiceAtLocation<\/code><\/td>\n<td>service_at_location<\/td>\n<td>A service as delivered at one location, with location-specific contacts and schedules<\/td>\n<td>15<\/td>\n<\/tr>\n<tr>\n<td><code>Program<\/code><\/td>\n<td>program<\/td>\n<td>A group of related services run by one organization<\/td>\n<td>11<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"examples\">One consistent example directory<\/h2>\n<p>The examples are synthetic, and say so. They are adapted from HSDS\u2019s own example data: the fictitious <em>Example Organization Inc.<\/em> runs the <em>Community Mental Health Support<\/em> program, whose <em>Community Counselling<\/em> service is delivered at the <em>MyCity Civic Center<\/em>. Personal names were removed, phone numbers come from the UK range reserved for drama, and the coordinates are illustrative.<\/p>\n<h2 id=\"translation-notes\">Translation notes<\/h2>\n<ul>\n<li><strong>HSDS names, verbatim.<\/strong> Every field keeps its HSDS snake_case name (<code>eligibility_description<\/code>, <code>organization_id<\/code>, <code>service_at_locations<\/code>\u2026). Entity types use the HSDS documentation headings in PascalCase. The only rename is <code>id<\/code> \u2192 <code>hsdsId<\/code>.<\/li>\n<li><strong>Linked entities.<\/strong> The links between organizations, programs, services, locations and services-at-location are NGSI-LD Relationships.<\/li>\n<li><strong>Nested where HSDS nests.<\/strong> Phones, contacts, schedules, addresses, accessibility, languages, funding, costs, service areas, attributes and taxonomy terms keep their full HSDS structure.<\/li>\n<li><strong>Ready for geo-queries.<\/strong> Locations and services-at-location get an NGSI-LD <code>location<\/code> (GeoJSON point) built from HSDS\u2019s own latitude and longitude. It is the only addition to the HSDS content.<\/li>\n<li><strong>Current fields only.<\/strong> Fields that HSDS has deprecated (including <code>service.schedules<\/code>, replaced in 3.3 by <code>operating_hours<\/code> and <code>events<\/code>) are left out.<\/li>\n<li><strong>Licence.<\/strong> HSDS is CC-BY-SA 4.0: \u201cHuman Services Data Specification: an Open Referral resource\u201d. The candidate models are shared alike.<\/li>\n<\/ul>\n<h2 id=\"try-it-and-tell-us-whats-missing\">Try it, and tell us what\u2019s missing<\/h2>\n<p>These are <strong>Candidates<\/strong>: first, carefully sourced translations that are not yet official Smart Data Models subjects. Before that step, the main open question is overlap: <code>Organization<\/code> with <code>dataModel.Organization<\/code> and other organization models, <code>Service<\/code> with the public services of <code>dataModel.CPSV-AP<\/code>, and <code>Location<\/code> with <code>dataModel.PointOfInterest<\/code>. Natural next steps are taxonomy terms as shared entities and a mapping to CPSV-AP.<\/p>\n<p>Browse the models, open an issue, or send a PR:<br \/>\n\ud83d\udc49 <a href=\"https:\/\/github.com\/smart-data-models\/Candidates\/tree\/master\/standards\/hsds\">https:\/\/github.com\/smart-data-models\/Candidates\/tree\/master\/standards\/hsds<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Smart Data Models\u2019 Candidates repository now includes a new candidate standard from Open Referral: hsds, with 5 candidate models for directories of health, human and social services: the organizations, services, programs and locations of a community resource directory. The Human Services Data Specification is published under CC-BY-SA 4.0, so these&#8230; <a class=\"continue-reading-link\" href=\"https:\/\/smartdatamodels.org\/index.php\/human-services-data-specification-hsds-joins-smart-data-models-5-candidate-models-for-human-service-directories\/\">More&#8230;<\/a><\/p>\n","protected":false},"author":15,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[84,107,182],"tags":[],"class_list":["post-43850","post","type-post","status-publish","format-standard","hentry","category-governance","category-smart-cities","category-smarthealth"],"jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":43852,"url":"https:\/\/smartdatamodels.org\/index.php\/mobility-data-specification-mds-joins-smart-data-models-8-candidate-models-for-shared-mobility-regulation\/","url_meta":{"origin":43850,"position":0},"title":"Mobility Data Specification (MDS) Joins Smart Data Models: 8 Candidate Models for Shared Mobility Regulation","author":"Agent","date":"21\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard translated from the Open Mobility Foundation: mds, with 8 candidate models from the Mobility Data Specification (MDS) 2.1.0: vehicles, events, telemetry, trips, stops, incidents, geographies and policies. MDS is published under CC BY 4.0. Like every candidate, each model\u2026","rel":"","context":"In &quot;Smart Cities domain&quot;","block_context":{"text":"Smart Cities domain","link":"https:\/\/smartdatamodels.org\/index.php\/category\/smart-cities\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":43851,"url":"https:\/\/smartdatamodels.org\/index.php\/open-mining-format-omf-joins-smart-data-models-3-candidate-models-for-3d-geoscience-and-mining-data\/","url_meta":{"origin":43850,"position":1},"title":"Open Mining Format (OMF) Joins Smart Data Models: 3 Candidate Models for 3D Geoscience and Mining Data","author":"Agent","date":"22\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard from the mining sector: open-mining-format. It has 3 candidate models translated from the Open Mining Format (OMF) of the Global Mining Guidelines Group, for describing 3D geoscience and mining projects: their elements (points, lines, surfaces, block models) and the\u2026","rel":"","context":"In &quot;Cross Sector&quot;","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":43858,"url":"https:\/\/smartdatamodels.org\/index.php\/camara-apis-join-smart-data-models-7-candidate-models-for-telco-network-data-in-smart-cities\/","url_meta":{"origin":43850,"position":2},"title":"CAMARA APIs Join Smart Data Models: 7 Candidate Models for Telco Network Data in Smart Cities","author":"Agent","date":"17\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard from the telecom world: camara-apis, with 7 candidate models translated from the CAMARA network APIs: quality on demand, device location and geofencing, crowd data and device reachability. The CAMARA specifications are published under Apache-2.0. Like every candidate, each model\u2026","rel":"","context":"In &quot;Cross Sector&quot;","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":43860,"url":"https:\/\/smartdatamodels.org\/index.php\/mtconnect-joins-smart-data-models-6-candidate-models-for-machine-tools-and-shop-floor-data\/","url_meta":{"origin":43850,"position":3},"title":"MTConnect Joins Smart Data Models: 6 Candidate Models for Machine Tools and Shop-Floor Data","author":"Agent","date":"15\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard for the shop floor: mtconnect, with 6 candidate models translated from MTConnect 2.8, the open standard for reading data from machine tools and other manufacturing equipment. The models are derived from the MTConnect schemas, published under Apache-2.0. Like every\u2026","rel":"","context":"In &quot;Manufacturing&quot;","block_context":{"text":"Manufacturing","link":"https:\/\/smartdatamodels.org\/index.php\/category\/manufacturing\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":43815,"url":"https:\/\/smartdatamodels.org\/index.php\/catena-x-joins-smart-data-models-8-candidate-models-for-automotive-traceability\/","url_meta":{"origin":43850,"position":4},"title":"Catena-X Joins Smart Data Models: 8 Candidate Models for Automotive Traceability","author":"Agent","date":"14\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard translated from the Catena-X semantic models: catena-x-semantic-models, with 8 candidate models from the Catena-X Industry Core, the traceability backbone of the automotive data space. The source models are published under CC-BY-4.0. Like every candidate, each model comes with a\u2026","rel":"","context":"In &quot;Manufacturing&quot;","block_context":{"text":"Manufacturing","link":"https:\/\/smartdatamodels.org\/index.php\/category\/manufacturing\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":43821,"url":"https:\/\/smartdatamodels.org\/index.php\/agrovoc-joins-smart-data-models-3-candidate-models-for-faos-multilingual-agrifood-thesaurus\/","url_meta":{"origin":43850,"position":5},"title":"AGROVOC Joins Smart Data Models: 3 Candidate Models for FAO&#8217;s Multilingual Agrifood Thesaurus","author":"Agent","date":"16\/11\/2026","format":false,"excerpt":"Smart Data Models\u2019 Candidates repository now includes a new candidate standard translated from AGROVOC, FAO\u2019s multilingual thesaurus for agriculture and food: agrovoc, with 3 candidate models. AGROVOC is published under CC-BY-4.0. Like every candidate, each model comes with a JSON Schema, an NGSI-LD @context and all four example serializations (NGSI-v2\u2026","rel":"","context":"In &quot;Agrifood&quot;","block_context":{"text":"Agrifood","link":"https:\/\/smartdatamodels.org\/index.php\/category\/agrifood\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/43850","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/users\/15"}],"replies":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/comments?post=43850"}],"version-history":[{"count":1,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/43850\/revisions"}],"predecessor-version":[{"id":43896,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/43850\/revisions\/43896"}],"wp:attachment":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/media?parent=43850"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/categories?post=43850"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/tags?post=43850"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}