# Technical

**URL:** https://forum.openreferral.org/c/technical/7.md?page=1

[Latest](https://forum.openreferral.org/latest.md) · [Categories](https://forum.openreferral.org/categories.md) · [Tags](https://forum.openreferral.org/tags.md)

**Page:** 2

---

## [HSDS Validator Technical Requirements](https://forum.openreferral.org/t/hsds-validator-technical-requirements/736)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 4\
**Last updated:** [September 19, 2025, 1:38pm UTC](https://forum.openreferral.org/t/hsds-validator-technical-requirements/736 "2025-09-19T13:38:23Z")

</div>

Hi all, I’ve started work on a draft set of technical requirements for a HSDS Validator tool, which you can review in the following doc: HSDS Validator Requirements (GDoc) EDIT: Use this link to the requirements on th…

---

## [FYI: Draft Guidance for using general-purpose validation tools with HSDS](https://forum.openreferral.org/t/fyi-draft-guidance-for-using-general-purpose-validation-tools-with-hsds/737)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 0\
**Last updated:** [September 10, 2025, 7:43am UTC](https://forum.openreferral.org/t/fyi-draft-guidance-for-using-general-purpose-validation-tools-with-hsds/737 "2025-09-10T07:43:02Z")

</div>

I’ve drafted some guidance on using general purpose JSON Schema validation tools to validate HSDS data. We’ll be looking to add this to the non-normative guidance section of the docs site in due course, but Greg and I th…

---

## [Technical Report on OpenLineage](https://forum.openreferral.org/t/technical-report-on-openlineage/680)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 0\
**Last updated:** [August 7, 2025, 8:48am UTC](https://forum.openreferral.org/t/technical-report-on-openlineage/680 "2025-08-07T08:48:16Z")

</div>

Hi folks, Another technical report! This time based on the investigations I’ve been doing around OpenLineage. This was kicked off a few months ago after the Technical Committee Meeting where @klambacher discussed her ne…

---

## [A HSDS Mock API to test your tooling against](https://forum.openreferral.org/t/a-hsds-mock-api-to-test-your-tooling-against/662)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 2\
**Last updated:** [July 17, 2025, 7:29am UTC](https://forum.openreferral.org/t/a-hsds-mock-api-to-test-your-tooling-against/662 "2025-07-17T07:29:36Z")

</div>

Hi all, With all the talk of validator tooling and the need to test it, Greg and I talked about the possibility of having a “mock API” set up so that anyone doing anything that required and API to bounce things off of c…

---

## [Request for Comments: Data Guides for HSDS](https://forum.openreferral.org/t/request-for-comments-data-guides-for-hsds/643)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 3\
**Last updated:** [July 16, 2025, 7:53am UTC](https://forum.openreferral.org/t/request-for-comments-data-guides-for-hsds/643 "2025-07-16T07:53:27Z")

</div>

Hi folks, I’d like to present the start of some work to the to the community around producing some guidance for HSDS publishers to write Data Guides for their API feeds where appropriate. The document linked below conta…

---

## [Linking a service to app stores](https://forum.openreferral.org/t/linking-a-service-to-app-stores/658)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 4\
**Last updated:** [July 10, 2025, 12:20pm UTC](https://forum.openreferral.org/t/linking-a-service-to-app-stores/658 "2025-07-10T12:20:35Z")

</div>

I’ve had a query from a UK project that wants to do a proof of concept with an Open Referral UK API feed for services. (I’ll leave them to add further details if they wish.) The question is: How do I link a service to i…

---

## [Validation - absent fields, nulls and empty strings](https://forum.openreferral.org/t/validation-absent-fields-nulls-and-empty-strings/648)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 3\
**Last updated:** [June 11, 2025, 12:33pm UTC](https://forum.openreferral.org/t/validation-absent-fields-nulls-and-empty-strings/648 "2025-06-11T12:33:10Z")

</div>

When using the validator against Open Referral UK version 3, we reject/fail empty strings where the field format is checked. This applies to: service.url service.email organization.parent\_organization\_id and probably …

---

## [ORUK Validator Compatability](https://forum.openreferral.org/t/oruk-validator-compatability/642)

<div class="topic-metadata">

**Author:** [@IlesdTPX](https://forum.openreferral.org/u/IlesdTPX)\
**Replies:** 2\
**Last updated:** [June 4, 2025, 12:52pm UTC](https://forum.openreferral.org/t/oruk-validator-compatability/642 "2025-06-04T12:52:21Z")

</div>

Hey all, I am testing out updating the ORUK validator to be compatible with HSDS V3.0. Are there any openly available APIs using the standard that could be used for testing? Thanks, Dave

---

## [Validator and dashboard for HSDS / HSDA 3.0 and beyond](https://forum.openreferral.org/t/validator-and-dashboard-for-hsds-hsda-3-0-and-beyond/415)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 14\
**Last updated:** [June 4, 2025, 12:49pm UTC](https://forum.openreferral.org/t/validator-and-dashboard-for-hsds-hsda-3-0-and-beyond/415 "2025-06-04T12:49:48Z")

</div>

At @bloom’s request, I’ve drafted Por11474 - Open Referral Validator and Dashboard specification with my understanding of what’s needed for a validator for the API and how this should be used in a dashboard modelled on t…

---

## [When a data standard/specificaion is used for a given field, provide a way to define \_which\_ standard was used](https://forum.openreferral.org/t/when-a-data-standard-specificaion-is-used-for-a-given-field-provide-a-way-to-define-which-standard-was-used/598)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 1\
**Last updated:** [April 3, 2025, 10:34am UTC](https://forum.openreferral.org/t/when-a-data-standard-specificaion-is-used-for-a-given-field-provide-a-way-to-define-which-standard-was-used/598 "2025-04-03T10:34:35Z")

</div>

This discussion is migrated from a Github ticket: When a data standard/specificaion is used for a given field, provide a way to define \_which\_ standard was used. · Issue #286 · openreferral/specification · GitHub I have…

---

## [Deprecating the version 2 documentation](https://forum.openreferral.org/t/deprecating-the-version-2-documentation/617)

<div class="topic-metadata">

**Author:** [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Replies:** 2\
**Last updated:** [March 26, 2025, 3:16pm UTC](https://forum.openreferral.org/t/deprecating-the-version-2-documentation/617 "2025-03-26T15:16:27Z")

</div>

@bloom and I have been discussing removing v2.0 documentation from https://docs.openreferral.org/ I’ve been working on some changes to the documentation to clearly signpost to the latest version of the docs in response …

---

## [HSDS Schema Summary in Markdown for LLM Inference](https://forum.openreferral.org/t/hsds-schema-summary-in-markdown-for-llm-inference/627)

<div class="topic-metadata">

**Author:** [@CheetoBandito](https://forum.openreferral.org/u/CheetoBandito)\
**Replies:** 2\
**Last updated:** [March 21, 2025, 10:42pm UTC](https://forum.openreferral.org/t/hsds-schema-summary-in-markdown-for-llm-inference/627 "2025-03-21T22:42:21Z")

</div>

Hey all. I used a web scraper to take all the information on this page about HSDS which I found myself returning to frequently and build a TXT document. I find the greatest success when using markdown to reason with LLM…

---

## [Potential for using AirTable for small API feeds](https://forum.openreferral.org/t/potential-for-using-airtable-for-small-api-feeds/622)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 6\
**Last updated:** [March 18, 2025, 3:17pm UTC](https://forum.openreferral.org/t/potential-for-using-airtable-for-small-api-feeds/622 "2025-03-18T15:17:18Z")

</div>

I’d appreciate comments on the feasibility of using AirTable for small databases of services with associated HSDS data and providing from that an API feed compliant with HSDA. In the UK (or just England) we have a possi…

---

## [Publisher/source metadata at a record level](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625)

<div class="topic-metadata">

**Author:** [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Replies:** 2\
**Last updated:** [March 13, 2025, 1:25pm UTC](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625 "2025-03-13T13:25:20Z")

</div>

In the Technical Committee meeting today we discussed the potential need for record level publisher metadata (building from Proposal for 3.2 - Extra metadata with API feeds which provides feed level publisher data) This…

---

## [Demo of taxonomy/terminology alignment tool](https://forum.openreferral.org/t/demo-of-taxonomy-terminology-alignment-tool/604)

<div class="topic-metadata">

**Author:** [@bloom](https://forum.openreferral.org/u/bloom)\
**Replies:** 20\
**Last updated:** [March 11, 2025, 11:05am UTC](https://forum.openreferral.org/t/demo-of-taxonomy-terminology-alignment-tool/604 "2025-03-11T11:05:29Z")

</div>

Hi folks – welcome @MBiezunski to the group. Michel has experience developing tools in support of semantic interoperability among overlapping terminology value sets. This is a topic that’s technically out of scope of HS…

---

## [Handling confidential addresses in HSDS 3.0](https://forum.openreferral.org/t/handling-confidential-addresses-in-hsds-3-0/243)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 35\
**Last updated:** [February 27, 2025, 1:53pm UTC](https://forum.openreferral.org/t/handling-confidential-addresses-in-hsds-3-0/243 "2025-02-27T13:53:30Z")

</div>

While working on a couple transformation projects these past weeks, I was reminded of a fairly urgent need in the spec: the ability to denote when an address is confidential, or should otherwise be hidden from public vie…

---

## [Extra metadata with API feeds](https://forum.openreferral.org/t/extra-metadata-with-api-feeds/572)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 13\
**Last updated:** [February 26, 2025, 3:44pm UTC](https://forum.openreferral.org/t/extra-metadata-with-api-feeds/572 "2025-02-26T15:44:25Z")

</div>

I’d like to propose extra optional fields to be returned by the root/stub API endpoint. Specifically to allow the Dashboard (new version is under development) to be documented entirely from a feed under the publisher’s …

---

## [HSDS Go Types and Constructors](https://forum.openreferral.org/t/hsds-go-types-and-constructors/597)

<div class="topic-metadata">

**Author:** [@CheetoBandito](https://forum.openreferral.org/u/CheetoBandito)\
**Replies:** 2\
**Last updated:** [February 5, 2025, 10:58pm UTC](https://forum.openreferral.org/t/hsds-go-types-and-constructors/597 "2025-02-05T22:58:44Z")

</div>

I’ve developed a type system and constructors in Go for working with HSDS (Human Services Data Specification) data. This implementation makes it easy for organizations to transform their existing data into HSDS-compliant…

---

## [What might a stricter version of the standard look like?](https://forum.openreferral.org/t/what-might-a-stricter-version-of-the-standard-look-like/599)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 4\
**Last updated:** [January 10, 2025, 2:50pm UTC](https://forum.openreferral.org/t/what-might-a-stricter-version-of-the-standard-look-like/599 "2025-01-10T14:50:09Z")

</div>

I was recently struck by a comment made during a client call: “A standard isn’t a standard if you can drive a truck through it”. This rings a bell with me. One of the the strengths of HSDS is flexibility: I have been ab…

---

## [Data transformation toolkit](https://forum.openreferral.org/t/data-transformation-toolkit/586)

<div class="topic-metadata">

**Author:** [@MikeThacker-iStandUK](https://forum.openreferral.org/u/MikeThacker-iStandUK)\
**Replies:** 1\
**Last updated:** [December 10, 2024, 7:55pm UTC](https://forum.openreferral.org/t/data-transformation-toolkit/586 "2024-12-10T19:55:30Z")

</div>

The Open Referral website blog Introducing Open Referral’s data transformation toolkit includes the text: … which can be challenging to work with. HSDS addressed this challenge by calling for a set of CSV files to be b…

---

## [PATCH level release - 3.1.1](https://forum.openreferral.org/t/patch-level-release-3-1-1/583)

<div class="topic-metadata">

**Author:** [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Replies:** 0\
**Last updated:** [December 5, 2024, 4:15pm UTC](https://forum.openreferral.org/t/patch-level-release-3-1-1/583 "2024-12-05T16:15:16Z")

</div>

The branch 3.1.1-dev is staged for release See the docs for this branch This is a patch level update with these changes: Made Page.Empty a required field for API responses Fixed bad foreign keys and missing values in…

---

## [Changelog for 3.0](https://forum.openreferral.org/t/changelog-for-3-0/581)

<div class="topic-metadata">

**Author:** [@JonnyH](https://forum.openreferral.org/u/JonnyH)\
**Replies:** 1\
**Last updated:** [November 22, 2024, 1:26pm UTC](https://forum.openreferral.org/t/changelog-for-3-0/581 "2024-11-22T13:26:19Z")

</div>

Hey there… I got a message from LocalGov Drupal that there are changes for Open Referral UK 3.0. I can see the changelog, but I wanted to confirm when these are live when the docs will be updated here Open Referral UK …

---

## [PATCH: make Page.empty a required field](https://forum.openreferral.org/t/patch-make-page-empty-a-required-field/575)

<div class="topic-metadata">

**Author:** [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Replies:** 0\
**Last updated:** [November 1, 2024, 11:33am UTC](https://forum.openreferral.org/t/patch-make-page-empty-a-required-field/575 "2024-11-01T11:33:26Z")

</div>

Matt raised this issue before going on parental leave API: Responses using the \`Page\` schema are valid if empty · Issue #514 · openreferral/specification · GitHub I have made the proposed changes and made a pull request…

---

## [3.1-Dev Branch For Review](https://forum.openreferral.org/t/3-1-dev-branch-for-review/570)

<div class="topic-metadata">

**Author:** [@Dan-ODS](https://forum.openreferral.org/u/Dan-ODS)\
**Replies:** 5\
**Last updated:** [October 29, 2024, 10:24am UTC](https://forum.openreferral.org/t/3-1-dev-branch-for-review/570 "2024-10-29T10:24:12Z")

</div>

Please can we request the technical committee and wider community please review 3.1-dev. All being well, we plan to make this the main branch on the 25th of October giving ~10 working days for review. Any comments or f…

---

## [A working Proof of Concept HSDS API Validator in 163 lines of Python](https://forum.openreferral.org/t/a-working-proof-of-concept-hsds-api-validator-in-163-lines-of-python/567)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 1\
**Last updated:** [October 8, 2024, 4:03pm UTC](https://forum.openreferral.org/t/a-working-proof-of-concept-hsds-api-validator-in-163-lines-of-python/567 "2024-10-08T16:03:20Z")

</div>

Hi folks, I’m about to disappear on parental leave at the end of the week but I thought I’d leave you all with something. I wrote a very basic proof of concept HSDS API validator. It’s definitely not suitable for produ…

---

## [Overview of the upcoming HSDS 3.1](https://forum.openreferral.org/t/overview-of-the-upcoming-hsds-3-1/550)

<div class="topic-metadata">

**Author:** [@mrshll](https://forum.openreferral.org/u/mrshll)\
**Replies:** 0\
**Last updated:** [August 15, 2024, 8:12am UTC](https://forum.openreferral.org/t/overview-of-the-upcoming-hsds-3-1/550 "2024-08-15T08:12:12Z")

</div>

Howdy folks, I’d like to share the “HSDS 3.1 Overview” document with you. It’s a Google Doc, but it’s open so that everyone with the link can at least view it. Version 3.1 Overview doc The document is currently a liv…

---

## [3.1 Upgrade (next steps)](https://forum.openreferral.org/t/3-1-upgrade-next-steps/547)

<div class="topic-metadata">

**Author:** [@Dan-ODS](https://forum.openreferral.org/u/Dan-ODS)\
**Replies:** 0\
**Last updated:** [July 22, 2024, 9:32am UTC](https://forum.openreferral.org/t/3-1-upgrade-next-steps/547 "2024-07-22T09:32:27Z")

</div>

@bloom @SarahP @devin @skyleryoung @klambacher @MikeThacker, I just wanted to let you know that we plan to work on proposal docs (like the one we did for Adding Service Area to Service At Location) for the committee to …

---

## [Open Data Editor by OKFN?](https://forum.openreferral.org/t/open-data-editor-by-okfn/520)

<div class="topic-metadata">

**Author:** [@bloom](https://forum.openreferral.org/u/bloom)\
**Replies:** 1\
**Last updated:** [July 10, 2024, 3:38pm UTC](https://forum.openreferral.org/t/open-data-editor-by-okfn/520 "2024-07-10T15:38:35Z")

</div>

Check this out: Introducing Open Data Editor (beta): Towards a No-Code Data App for Everyone – Open Knowledge Foundation blog I’ve been reading through their updates here: Open Data Editor – Open Knowledge Foundation bl…

---

## [A use case for \`service\_area\` attached to \`service\_at\_location\`](https://forum.openreferral.org/t/a-use-case-for-service-area-attached-to-service-at-location/482)

<div class="topic-metadata">

**Author:** [@skyleryoung](https://forum.openreferral.org/u/skyleryoung)\
**Replies:** 8\
**Last updated:** [May 24, 2024, 2:49pm UTC](https://forum.openreferral.org/t/a-use-case-for-service-area-attached-to-service-at-location/482 "2024-05-24T14:49:20Z")

</div>

One of our resource directories in Hawaii may have just discovered a use case for attaching service\_area to service\_at\_location: A program is offered at two locations on two neighboring islands. Technically, the service…

---

## [Use case for the \`name\` field in \`language\`](https://forum.openreferral.org/t/use-case-for-the-name-field-in-language/492)

<div class="topic-metadata">

**Author:** [@ftravais-solinum](https://forum.openreferral.org/u/ftravais-solinum)\
**Replies:** 3\
**Last updated:** [May 15, 2024, 7:45am UTC](https://forum.openreferral.org/t/use-case-for-the-name-field-in-language/492 "2024-05-15T07:45:36Z")

</div>

I’m wandering why there’s a name field in language. Is it to comply with systems nota being able to provide the ISO code? To me the code is enough and more precise. Moreover the name has to be in a language, for exemple…

[Previous page](https://forum.openreferral.org/c/technical/7.md)

[Next page](https://forum.openreferral.org/c/technical/7.md?page=2)
