Introducing Open Referral’s data transformation toolkit

We’re excited to introduce a set of tools that make it easier to standardize resource data.

Community resource directory data (i.e., information about health, human, and social services available to people in need) is deceptively complex. In order to accurately represent the relationships between organizations, the services they provide, and the locations they are offered, Open Referral’s Human Service Data Specification (HSDS) calls for multiple tables, linked together — which can be challenging to work with. HSDS addressed this challenge by calling for a set of CSV files to be bundled together by a ‘datapackage’ which would specify the tables’ contents and relationships in a single machine-readable file.

Few of the members of our community, however, were familiar with datapackages and how to create them. So we’ve now made it easier to facilitate this complex approach to resource data sharing!

Thanks to the Open Knowledge Foundation, which developed the standard format for JSON datapackages, we’ve now upgraded our specification and associated tools to make it easier to produce, share, and read standardized resource data in the HSDS format, datapackage and all. Continue reading

Continue reading


AIRS Recommends Open Referral’s HSDS for Resource Database Interoperability

On behalf of the Alliance of Information and Referral Systems (AIRS), I am pleased to announce that the AIRS Board has moved to promote the adoption Open Referral’s Human Service Data Specification and API protocols as methods of establishing interoperability among resource databases and associated technologies.

Our aim is to create secure, controlled and affordable processes with which Information and Referral (I&R) organizations can securely share resource database records from their own software system with other systems — and Open Referral has demonstrated considerable success in helping this field move toward that goal.

AIRS is an international association of I&R service providers. Continue reading

Continue reading


Stone Souping Social Service Information with Airtable

The Sahana Software Foundation makes high quality, open source information management systems for emergency preparedness, response, recovery and resilience. We were recently awarded a microgrant by Open Referral (using funding from Stanford’s Digital Impact program, with fiscal sponsorship from the Alliance of Information and Referral Services) to develop and deploy an open source system for managing community resource data in the popular AirTable platform and making it accessible via Open Referral’s Human Services Data API. Continue reading

Continue reading


Hacking on Link With Optimizely And Benetech

Open Referral went to San Francisco on Wednesday August 9th to participate in a social good hack-day at Optimizely. In collaboration with our partner Benetech, Open Referral set up as one of the social good projects that 20+ employees worked on for the day.

 

Overall, our team was strong in front-end web and mobile developers, so we decided to “forward engineer” Zendesk’s Link-SF application so that it can be deployed on any Open Referral-compatible API. […]

You can find the updated Link source code in our Github repository. If you want to run this app locally, you can save a file as `config.js`and follow the instructions on the setup page. Continue reading

Continue reading


Version 1.1 of the Human Services Data API Specification

[This post is from Kin Lane, the API Evangelist, who is serving as Open Referral’s deputized Technical Lead for our OpenAPI specification project. Thanks Kin!]

Version 1.1 of the Human Services Data API specification (HSDA 1.1) is now available for review and comment.

This is an alpha implementation of our OpenAPI specification. It is built upon version 1.1 of Open Referral’s Human Services Data Specification (HSDS). Whereas HSDS is designed to facilitate raw exchange and bulk publication of resource directory data, the HSDA serves as a common protocol for resource directory APIs.

To facilitate testing, we’ve made the HSDA available in this demonstration portal. This portal is a redeployable (and forkable) reference implementation that provides guidance for working with the HSDA protocols. Implementers can use it to easily set up a “developers’ area” for their own API implementation.

Moving forward, we’ll collect feedback from stakeholders and reiterate this process twice more over the course of the summer. We’re setting a day/time for the next Open Referral Assembly now; if you’re interested, indicate your availability here. Continue reading

Continue reading


The Open Referral API project

The Open Referral Initiative’s next chapter starts now!

Open Referral has helped over a dozen community organizations find new ways to share resource directory information about the health, human, and social services available to people in need. Our Human Services Data Specification provides a common ‘machine language’ that any technology can be programmed to understand. This work has spurred a proliferation of ‘Application Programming Interfaces’ (APIs) — which publish machine-readable resource data for third-parties to query in real-time, so they can repurpose it in new ways.

So our newest mission is to establish interoperability across this new wave of resource directory APIs, so that machine-readable data about human services can be easily accessed and shared with a common protocol — regardless of technology, jurisdiction, organizational status, etc.

Thanks to Markets for Good for this opportunity!Toward this end, we’ve received funding from the Markets for Good program — which is now a part of the new Digital Impact initiative (digitalimpact.io) hosted by the Digital Society Lab at Stanford’s Center for Philanthropy and Civil Society!

Read Markets for Good’s announcement here. Continue reading

Continue reading


Open Referral in Oklahoma!

This is a guest post from Aaron Bean of Asemio. Welcome, Aaron!

We’re pleased to introduce the first iteration of the Oklahoma Open 2-1-1 project, which is leveraging the Ohana platform and the Open Referral format to make it easier for Oklahoma residents to find and share information about community resources that can help improve their lives.

This is just an initial demonstration of a major initiative that dates back several years. A wide range of stakeholders across many sectors in Tulsa and our surrounding region have been developing a shared assessment of the complex nature of our social problems, and we have recently coalesced around a common goal: to understand and reduce disparities in health outcomes by race, class, and gender through a holistic view of the various community systems that serve individuals and families. (See our whitepaper PDF here.)

Toward this goal, we seek to answer the question of how we can better align and integrate the various resources in our community that might help solve complex social problems. Continue reading

Continue reading