Introducing Version 3.0 of the Human Service Data Specifications

UPDATE: As of May 1st 2023, this upgrade is considered official! Thanks to our workgroup and all those in the community who contributed input. Read below for details.

[This post is from Dan Smith, Open Data Services Cooperative‘s Partnerships Lead for Health, Social and Physical Activity Data. Welcome, Dan!]

We are excited to share a proposal for version 3.0 of the Human Service Data Specifications – available now for a final period of review and comment by our community. 

We have been working toward this proposal for much of the past year, in a community-led process of gathering input about emerging and outstanding needs across our expanding network of human service informatics. … We are excited to share the fruits of this process with the broader community.

Request for Comment period for HSDS 3.0

This post marks the beginning of a final two-week Request for Comment period. During this time, our community can review and submit any final issues that may need to be addressed before HSDS 3.0 is formally approved by the working group.

We expect version 3.0 to be the last significant HSDS upgrade for a while, so if you have any questions or concerns about its suitability for your current or future potential use of HSDS, please raise them now.

How to provide feedback on HSDS 3.0

We encourage you to share feedback on the proposed version 3.0 in the following ways: Continue reading

Continue reading


Just Released: Toolkit for information exchange initiatives from the Office of the National Coordinator of Health IT at HHS

Diagram of the SDOH Information Exchange Foundational Elements: Community Readiness and Stewardship, Mission and Purpose, Values and Principles are all the baseline foundation. Then Policy, Legal, Measurement and Evaluation and Financing is built on top. Finally, Implementation services, Technical Infrastructure, and User Support and Learning Network are key elements. All tied together by Governance.

I’m excited to share with you this toolkit for information exchange initiatives that aim to address the social determinants of health – shared by the Office of the National Coordination for Health Information Technology at the US Department of Health and Human Services (known as ONC). The toolkit (PDF downloadable here) synthesizes subject matter expertise from across the health, human, and social service sectors to offer guidance on the design and implementation of initiatives to enable information exchange among healthcare and social care providers.

This toolkit largely addresses issues beyond resource directory information, and yet it reflects many of the lessons learned and strategic objectives of the Open Referral initiative. It may be helpful for communities that are working to improve their supply chain for resource directory information – as well as communities for which resource directory information is just one piece of a more complex strategic goal. I’ll offer some background context below:  Continue reading

Continue reading


Our 2022 Year in Review

Our 2022 Year in Review report is now available to review!

This annual practice of review and reflection is an opportunity for us to step back and assess our progress across multiple objectives as we work towards our shared goal: a future in which it’s easy to share, find, and use information about the resources available to people in need.

This year is especially notable for the range of ways in which we’ve helped governments, nonprofits, and private sector actors take action to modernize their resource directory information supply chains – on a local, statewide, and even national level.

The report shares stories of pilot projects across the U.S. in which Open Referral’s standards, tools, and strategies are enabling cooperation among organizations that previously struggled to work together in pursuit of their common goals.
Continue reading

Continue reading


Introducing the Whatcom County Resource Information Collaborative

This post is brought to us by Kristi Slette, Secretariat of the Whatcom Resource Information Collaborative in Washington state. Welcome, Kristi!

Washington state’s Whatcom County – the north western most county in continental U.S. – is a resourceful community with many collaborative community-based organizations that serve residents in need.

For many years, the leadership and staff from many of these organizations have voiced a desire to improve the accessibility and reliability of information about resources available in our community. In the past, this desire sparked several attempts to develop a centralized resource directory – but in each instance, our vision was hampered by the complexities of this challenge. We all shared the same goal, but different organizations had different needs and interests; when it came time to address all of them in one single website, we struggled to move forward together.

Learning from the past

In 2019, a series of community assessments and strategic planning sessions once again surfaced the need for a resource directory as a priority for Whatcom County, and a coalition of human and social service organizations convened to address this challenge with fresh eyes. This time, we sought to learn from previous efforts.

Through extensive dialogues with three different groups – social service providers who had been involved in the previous resource access initiatives, the conveners of those initiatives, and managers of current resource directories in our area – we perceived a set of key themes: the importance of leadership, human capacity, and buy-in from the community.

Through this reflection, we recognized that technology – which had previously been our primary focus – is actually only part of the solution. Rather than just designing a new tool, our new initiative would need to focus on building the capacities and relationships that will be needed to ensure that any such system is adaptive, sustainable, and trustworthy.

Building capacity for collaboration

In 2021, having made it a priority to improve access to resources for families with young children, the Whatcom County Health Department provided some seed funding to support our new initiative to establish a resource directory information system for the county. This time, we resolved to build a system that would be collectively “owned” by our community as a whole. Continue reading

Continue reading


Michigan 211’s new resource data infrastructure: providing social service information as a service

Since the onset of the pandemic in the spring of 2020, Michigan 211 has received an increasing number of requests for real-time access to our social service directory database from partners and collaborators across the state. We actively maintain over 40,000 service records offered throughout Michigan, verifying its accuracy on an ongoing basis – and carefully curating this information to connect community members to local services. When initiatives like one of Michigan’s new behavioral health services wanted to leverage our information to improve their ability to meet the needs of their callers, we wanted to ensure that this critical information can be available where and when they need it.

To address this emergent need, 211 made the strategic decision to develop a cloud-based service that securely provides direct access to our resource database for third-party partners – our “social service directory data service.” Toward this end, we partnered with Brightstreet Group as our technology consultants, and adopted Open Referral’s Human Service Data Specification as the technical blueprint for resource data service. 

By building this service on the foundation laid by Open Referral – from data exchange standards to an array of tools and strategic insights for new forms of resource data partnerships – we were able to focus our resources on meeting the unique needs of our partners and community at large. 

Continue reading

Continue reading


Upgrading the Human Service Data Specifications: 2022 development cycle underway

As Open Referral’s network grows – involving more stakeholders in the development of interoperable resource directory information supply chains – our tools and practices must evolve in kind to support more complex needs.

So we are excited to share that Open Referral has initiated a new development cycle to upgrade the Human Service Data Specifications. This cycle has kicked off with a specific objective to address a significant issue: our specifications need to be adapted across diverse contexts, to support different conventions in different places, while preserving a core of interoperability across our ecosystem.

To support this workgroup’s efforts, we are seeking feedback from a broad array of stakeholders across our network. For instance, this Friday (July 22nd) from 11a-1p, we will host an open “fishbowl” discussion in which workgroup members will review proposals line-by-line, at which any members of our community are welcome to observe and discuss by chat – invitations available by request. We encourage interested parties to comment on the documents above, or discuss in our issues queue on Github, or reach out directly via [email protected]
Continue reading

Continue reading


Progress Report 2021-22: Highlights from our Network

I’m excited to share Open Referral’s Progress Report for 2021-2022. You can download the report as a PDF here, and view the document online here. (All of our reports are accessible here.)

Unlike our usual Year in Review, this report really describes activity across a period of 18 months overall. This is 6 months later than planned, as the time I’d set aside to do our Year in Review for 2021 was interrupted by a Covid-19 infection. I’m fine (the delay of this report seems to have been the worst outcome of the experience for me) and I’m very grateful, not only for my own health but also for the network of people in our community who have helped make the past couple of years some of our most productive and exciting yet. Continue reading

Continue reading


Tackling Data Dilemmas in Social Care Coordination: A Whitepaper on Community Information Exchange

Last year – with sponsorship from Robert Wood Johnson Foundations’ DASH program, and in partnership with the Regional Data Alliance at University of Missouri St Louis – I co-authored a whitepaper that aggregated research and recommendations from across the emerging field of “social care coordination.”

This paper provides a strategic framework in which to understand Open Referral’s work in the context of human service directory data infrastructure and governance, and it also offers a broader view of the related but very different challenges of sharing information about people through coordination among service providers.

The whitepaper is available in PDF here – as well as in this ‘live’ version upon which we invite readers to share feedback. Having received significant positive feedback from experts in the field of healthcare informatics, I’m excited to share it here with the Open Referral community.
Continue reading

Continue reading


Improving access to legal aid by improving search results with schema.org

Despite the vast amounts of information on the Web, finding reliable information about legal services through internet searches is harder than many expect. Basic searches — for needs like assistance with evictions, help with public benefits, or protection from domestic violence — often turn bewildering as results on Google, among other search engines, typically seem unhelpful and untrustworthy.

Every U.S. state has legal aid organizations to help people who can’t afford private law firms. But these organizations rarely have the capacity to specialize in Search Engine Optimization that can compete with private firms and even scammy operations that tend to dominate search results.

Search results don’t have to be as hit-or-miss as they are today. One promising method of improving search results is by adding specialized tags – i.e. “web markup” – to legal aid websites that help web engines better identify and index their information.

Schema.org – which represents a coalition of the major web platforms – produces such web markup for smarter search results. With schema.org’s standardized vocabulary, websites can ‘mark up’ otherwise unstructured text into structured data that can be semantically ‘understood’ by search engines.

When Open Referral first began, we worked in collaboration with the team that developed the first version of the ‘Civic Services schema’ at schema.org. We were particularly motivated by their vision of a future in which anyone could use colloquial language in their searches and easily get reliable, richly detailed results. Finally, through partnership with legal aid providers in Florida and around the country, we now have our first glimpse of that future. Continue reading

Continue reading


Evolving the DC Community Resource Information Exchange’s Inventory Capabilities

In the District of Columbia, we’re developing a new approach to the very old problem of resource directory information management. Years ago we shared the story of the first phase of our work here on this blog, and we’re now excited to share results from our second phase. 

The DC Community Resource Information Exchange initiative (DC CoRIE) is an initiative to develop infrastructure and capacities to support coordination of care across health and social service sectors in the District of Columbia. Led through partnership among government agencies, community organizations, and technology providers – including the DC Department of Health Care Finance, the DC Primary Care Association and its DC-PACT coalition, and CRISP DC – DC CoRIE seeks to enable exchange of information about resources, and about people, across diverse organizational contexts and technology systems, in promotion of equitable health outcomes. 

One of DC CoRIE’s primary goals is to establish a sustainable supply of comprehensive, reliable information about the resources available to people in need. In 2019, we discussed this goal with a group of people who already maintain resource directories, and named the central challenge of this problem: resource directory information requires significant effort to reliably maintain, and at the same time, people want to use it not just in one “centralized” system but across an ecosystem of distributed contexts and technologies. In order to pursue this vision of a healthy information ecosystem, we resolved that our work should leverage the assets that are already in our community. (See the report from our participatory deliberation process here). Together, we identified three objectives for this phase: 

  1. Prototype resource directory information system that is designed for interoperability – such that the contents of the CRI could be accessed by any third party system.
  2. Develop a collaborative network of data stewards who will support this system by sharing data management responsibilities.
  3. Demonstrate the potential for this system to serve as a canonical source of open data about local human services.

In 2021, we accomplished each of these objectives – and we are now initiating our next phase, through which we will formalize this framework. Check out our final report for this phase here.

Below, we’ll provide more context for our project’s objectives and the path ahead.

Continue reading

Continue reading