# Publisher/source metadata at a record level

**URL:** <https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625>\
**Category:** Technical\
**Tags:** datastructure\
**Created:** [March 12, 2025, 5:16pm UTC](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625 "2025-03-12T17:16:38Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![kathrynods](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/kathrynods/32/147_2.png) [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Post date:** [March 12, 2025, 5:16pm UTC](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625/1 "2025-03-12T17:16:38Z")

</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](https://forum.openreferral.org/t/proposal-for-3-2-extra-metadata-with-api-feeds/616) which provides feed level publisher data)

This would create potentially 2 levels of “publisher” the original source of each record and the collator of a group of records which are published as a feed.

In [BODS at the statement level](https://standard.openownership.org/en/latest/standard/schema-browser.html#statements-array) when looking at beneficial ownership declarations we distinguish these as the “publisher” (e.g. Companies House publishing a dataset) and the “source” (e.g. the business owner submitting their information)

For HSDS this discussion is concerned wiith the “source” level of data. This is potentially something we could incorporate into the metadata object or this could be a new “publisher” or “source” object.

What information would be useful here? name, contact info (including where to raise corrections)

---

<div class="post-metadata">

**Author:** ![kathrynods](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/kathrynods/32/147_2.png) [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Post date:** [March 13, 2025, 1:21pm UTC](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625/2 "2025-03-13T13:21:30Z")

</div>

copying over @bloom comments about possible field names

> Yeah i mean these should be subject to further consideration, but i think there’s publisher of the aggregated dataset, steward of individual records, and then there should be a term for a representative of the organization that the record is about (maybe that’s `source` tho in other contexts i use `registrant` or `representative` )

---

<div class="post-metadata">

**Author:** ![kathrynods](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.openreferral.org/kathrynods/32/147_2.png) [@kathrynods](https://forum.openreferral.org/u/kathrynods)\
**Post date:** [March 13, 2025, 1:25pm UTC](https://forum.openreferral.org/t/publisher-source-metadata-at-a-record-level/625/3 "2025-03-13T13:25:20Z")

</div>

In [the BODS schema](https://standard.openownership.org/en/latest/standard/schema-browser.html) we have something a bit like what @bloom is describing (although each of these are held at the record level rather than any being aggregated to a higher level).

- publisher (as above)
- source - this is an object which is kind of a 2 in 1 for what we could describe here as a `steward` or `representative` - it includes `source.type` for whether it’s a self declaration, third party information, or from an official register. `source.assertedBy` is the name of the agent making the assertion. So this object could be used for a person declaring their own interests or an official register declaring their interests. It doesn’t include contact information beyond just a URL though.

I don’t think this approach would transfer directly to OR but might be useful to have as a reference
