---
title: "Developers | Observatory Protocol"
description: "Everything an implementer needs, in the order it is needed: the schemas, a checker that runs in your browser, quickstarts for validation and the conformance suite, and the wire binding of every plane. Code is licensed under Apache-2.0."
url: https://nexusobservatory.com/developers/
publisher: GCRI Canada
updated: 2026-11-18
---

1. [Observatory Protocol](https://nexusobservatory.com/)
2. Developers

# Build against open schemas.

Everything an implementer needs, in the order it is needed: the schemas, a checker that runs in your browser, quickstarts for validation and the conformance suite, and the wire binding of every plane. Code is licensed under Apache-2.0.

[Start a quickstart](https://nexusobservatory.com/sdk/)

[Check a document](https://nexusobservatory.com/conformance/checker/)

**Wire bindings**: 7
**Profiles**: 5
**Code**: Apache-2.0

Path

## From the first schema to a conformance claim.

1. [**Read the schemas** Every object as an open JSON schema, explored field by field.](https://nexusobservatory.com/schemas/)
2. [**Check a document** Check a document against its schema in your browser.](https://nexusobservatory.com/conformance/checker/)
3. [**Run the quickstarts** Validate, run the conformance suite, read the bindings.](https://nexusobservatory.com/sdk/)
4. [**Pick a profile** What each kind of implementation provides.](https://nexusobservatory.com/sdk/implementers/)
5. [**State your claim** Profiles, levels and the evidence each needs.](https://nexusobservatory.com/conformance/)

API reference

## The wire binding of every plane.

| Plane | Binding |
| --- | --- |
| Control | TLS 1.3 with mutual authentication; protobuf messages over gRPC or HTTP/2. |
| Data, in the field | MQTT 5 with Sparkplug B; connectors for LoRaWAN, OPC UA and instrument buses. |
| Data, site to upstream | At-least-once publication with repeat-safe keys over the control channel or NATS JetStream; QUIC MAY be used on lossy links. |
| Events | Event envelopes mapped to CloudEvents 1.0; channels described in AsyncAPI 3. |
| Exchange | OpenAPI 3.1; the OGC API family; SensorThings; STAC; WIS 2.0. |
| Evidence | DSSE-signed in-toto statements; SLSA provenance; SCITT transparency receipts. |
| Telemetry | OpenTelemetry OTLP. |

Profiles

## What each kind of implementation provides.

| Profile | Functions | For |
| --- | --- | --- |
| OBSP-NODE | Join, Describe, Time, Observe, Qualify, Orchestrate (apply), Exit | Node agents and devices |
| OBSP-SITE | OBSP-NODE plus Admit (local), Orchestrate (plan), Correct, Prove (verifier) | Site controllers |
| OBSP-GRID | OBSP-SITE plus Federate and Exchange | Cluster and grid control planes |
| OBSP-PROVIDER | Admit, Describe, Exit | Hardware, software, model and data providers |
| OBSP-CONSUMER | Exchange, Correct (subscribe) | Applications reading products |

Tools

## Tools that run in your browser and on your machine.

- [**Schemas** Every object as an open JSON schema, explored field by field.](https://nexusobservatory.com/schemas/)
- [**Conformance checker** Check a document against its schema in your browser.](https://nexusobservatory.com/conformance/checker/)
- [**SDK quickstarts** Validate, run the conformance suite, read the bindings.](https://nexusobservatory.com/sdk/)
- [**Reference scenes** The systems the protocol applies to, drawn to scale.](https://nexusobservatory.com/sdk/reference-designs/)

Schemas

## Every object of the protocol, as an open JSON schema.

- [attestation-evidence **AttestationEvidence** RATS (RFC 9334) evidence a node presents to a verifier during Join (OBSP 0.1 section 5.1): fresh verifier nonce, claims, measurement digests, root-of-trust class with its quote or certificate digests, and the time quality in force.](https://nexusobservatory.com/schemas/)
- [attestation-result **AttestationResult** Verifier appraisal of AttestationEvidence (RFC 9334 attestation result, AR4SI tiers), bound to the nonce and the evidence digest it appraised and valid only until expiresAt.](https://nexusobservatory.com/schemas/)
- [calibration-record **CalibrationRecord** One calibration of one observed property of a sensor (OBSP 0.1 section 5.3): reference standard, traceability chain, uncertainty with units, validity window, method and the role that performed it.](https://nexusobservatory.com/schemas/)
- [conformance-claim **ConformanceClaim** A participant's claim that one implementation version conforms to named OBSP profiles at named levels, with the evidence by digest (OBSP 0.1 section 10).](https://nexusobservatory.com/schemas/)
- [conformance-report **ConformanceReport** Output of a conformance suite run (conformance/README.md): the suite version, the profile tested, each case result, the requirement coverage and the digests of the evidence tested.](https://nexusobservatory.com/schemas/)
- [correction-notice **CorrectionNotice** Correction of one version of a record (OBSP 0.1 section 5.9): the corrected record and version, the state transition from the encoded transition table, the reason, the issuer role and every dependant it invalidates.](https://nexusobservatory.com/schemas/)
- [decommission-record **DecommissionRecord** Closing record for a node, site cell, cluster or provider integration (OBSP 0.1 section 5.12): identities revoked, keys wiped or returned, the owner's data exported in open formats with a digest-bound manifest, and final evidence.](https://nexusobservatory.com/schemas/)
- [error-problem **ErrorProblem** Canonical RFC 7807-shaped Observatory problem contract with bounded diagnostic disclosure.](https://nexusobservatory.com/schemas/)
- [event-envelope **EventEnvelope** Canonical Observatory event envelope.](https://nexusobservatory.com/schemas/)
- [fleet-projection **FleetProjection** Canonical Fleet Site Cell projection.](https://nexusobservatory.com/schemas/)
- [model-manifest **ModelManifest**](https://nexusobservatory.com/schemas/)
- [native-envelope **NativeEnvelope**](https://nexusobservatory.com/schemas/)
- [node-bootstrap-bundle **NodeBootstrapBundle** Bounded Node enrollment/assignment envelope referencing Plan, deployment, Site, policy and attestation requirements.](https://nexusobservatory.com/schemas/)
- [node-manifest **NodeManifest**](https://nexusobservatory.com/schemas/)
- [observation-record **ObservationRecord**](https://nexusobservatory.com/schemas/)
- [observed-state-receipt **ObservedStateReceipt** Canonical Node-emitted observed-state receipt for central deployment-state ingestion.](https://nexusobservatory.com/schemas/)
- [participant-manifest **ParticipantManifest** How an organisation enters the protocol community through a participant gateway: its class, the roles it takes, the gateways it uses, the profiles it intends to implement or operate and its jurisdiction.](https://nexusobservatory.com/schemas/)
- [plan **Plan** Immutable governed deployment proposal produced by the System Pack compiler.](https://nexusobservatory.com/schemas/)
- [product-manifest **ProductManifest**](https://nexusobservatory.com/schemas/)
- [proof-receipt **ProofReceipt**](https://nexusobservatory.com/schemas/)
- [provenance **Provenance** W3C PROV-O shaped provenance bundle (OBSP 0.1 section 5.6) that travels with observations and derived products: entities, activities and agents (by UNI and protocol role) with used, wasGeneratedBy, wasDerivedFrom, wasAssociatedWith, wasAttributedTo and actedOnBehalfOf relations.](https://nexusobservatory.com/schemas/)
- [provider-manifest **ProviderManifest**](https://nexusobservatory.com/schemas/)
- [qualification-record **QualificationRecord**](https://nexusobservatory.com/schemas/)
- [quality-flag **QualityFlag** One quality flag from the controlled vocabulary (OBSP 0.1 section 5.6) with the test and test version that set it.](https://nexusobservatory.com/schemas/)
- [reconciliation-assignment **ReconciliationAssignment**](https://nexusobservatory.com/schemas/)
- [reconciliation-receipt **ReconciliationReceipt**](https://nexusobservatory.com/schemas/)
- [replay-batch-result **ReplayBatchResult** Per-event dispositions for a ReplayBatch.](https://nexusobservatory.com/schemas/)
- [replay-batch **ReplayBatch** Node store-and-forward replay batch for reconnect catch-up.](https://nexusobservatory.com/schemas/)
- [request-context **RequestContext** Observatory Protocol request context (OBSP 0.1 section 4.3).](https://nexusobservatory.com/schemas/)
- [sensor-passport **SensorPassport** Versioned passport of one sensor (OBSP 0.1 section 5.3): device class, model, serial, firmware digest, mounting and exposure, sampling plan, observed properties with UCUM units and the calibration history.](https://nexusobservatory.com/schemas/)
- [source-manifest **SourceManifest**](https://nexusobservatory.com/schemas/)
- [source-release **SourceRelease**](https://nexusobservatory.com/schemas/)
- [supply-chain-receipt **SupplyChainReceipt** Supply-chain receipt for an admitted software artifact (OBSP 0.1 section 5.2): artifact digest, SBOM (SPDX or CycloneDX) reference and digest, SLSA provenance reference and build level, and an optional SCITT transparency receipt.](https://nexusobservatory.com/schemas/)
- [system-pack **SystemPack**](https://nexusobservatory.com/schemas/)
- [time-quality **TimeQuality** Time quality a node reports with its observations and receipts (OBSP 0.1 section 5.4): source class, offset bound, holdover and integrity flags.](https://nexusobservatory.com/schemas/)
