Contract link

A verified link from one of your projects to a public government contracting record.

Part of Contracts in the register catalog.

Register ID

contract_linkUse this name to ask for the register. The API calls it a shelf ID.

Each record is

A stateThe current value of something, replaced when it changes.

Status

DeclaredDefined, and fills when a source produces its first record.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Standards

This register holds records these standards and laws ask for. Holding them does not by itself certify compliance.

• OCDSOpen Contracting Data StandardInternational
• OC4IDSOpen Contracting for Infrastructure Data StandardInternational

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

13 fields: 8 required, 5 optional.

Required

Every record carries these fields.

project_entity_idWhole number

The tenant project the link anchors to (the fact subject)

Example: 8101

link_idWhole number

Stable identity of the link across pursuing → won → delivering → complete

Example: 1

ocidText

The public OCDS contracting-process identifier this project is linked to.

Example: vendorpanel_upcoming:https://www.vendorpanel.com.au/tsi.a…

link_stateText

Customer-declared lifecycle state of the seam.

Example: DELIVERING

verifiedTrue or false

Whether the link was human-confirmed rather than auto-asserted on a fuzzy match.

Example: true

created_atDate and timeISO 8601, with time zone

When the link was first established; carried verbatim across every refresh.

Example: 2026-06-05T02:00:00Z

updated_atDate and timeISO 8601, with time zone

When the link last changed state.

Example: 2026-06-10T02:00:00Z

source_systemText

Producing system of the fact (DEMITON for this shelf)

Example: DEMITON

Optional

Present when the source system records them.

platform_project_idWhole number

The platform-side project this OCID belongs to, when the hub has resolved one.

confidenceNumberUnit: ratio

The resolver's candidate-match score at link creation.

Example: 1

verified_by_user_idWhole number

The identity that confirmed the link.

link_methodText

How the link was established.

Example: manual

won_atDate and timeISO 8601, with time zone

When the win was declared (present only from won onward)

Example: 2026-06-05T02:00:00Z

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

contract_link.example.json

{
  "confidence": 1,
  "created_at": "2026-06-05T02:00:00Z",
  "link_id": 1,
  "link_method": "manual",
  "link_state": "DELIVERING",
  "ocid": "vendorpanel_upcoming:https://www.vendorpanel.com.au/tsi.axd?id=0592052ee9cf4fc78214477bf69400cfs508003s50c818bb80c044cab1c37a23ba39eee8s1554",
  "project_entity_id": 8101,
  "source_system": "DEMITON",
  "updated_at": "2026-06-10T02:00:00Z",
  "verified": true,
  "won_at": "2026-06-05T02:00:00Z"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/contract_link/v1.json

Show the full JSON Schema

Loading the schema…