API Reference

Base URL

https://registry.siros.org/api/v1

GET /schemas

Returns all registered attestation schemas as unsigned JSON (or JWS compact serialization when signing is enabled).

curl https://registry.siros.org/api/v1/schemas.json

The response contains a data array of SchemaMeta objects, plus total, limit, and offset fields.

GET /schemas/{schemaId}

Returns a single SchemaMeta object by UUID.

curl https://registry.siros.org/api/v1/schemas/{uuid}.json

GET /orgs (SIROS extension — not part of TS11)

Not part of TS11 — the ETSI spec has no "organization" concept. Returns an index of the organizations contributing to this registry, each with a link to its organization-scoped schema list.

curl https://registry.siros.org/api/v1/orgs.json

GET /orgs/{org}/schemas (SIROS extension — not part of TS11)

Also not part of TS11. Returns the same shape as GET /schemas, filtered to TS11-compliant schemas contributed by one organization. Each schema object is identical to the one returned by the global list — filtering happens by which resource you request, not by a new field on SchemaMeta, so this has no effect on TS11 conformance.

curl https://registry.siros.org/api/v1/orgs/{org}/schemas.json

To filter to a set of organizations, fetch each organization's list separately and merge client-side — there's no static resource for an arbitrary combination of orgs.

GET /attributes

Returns the Catalogue of Attributes — a cross-cutting index of all claims defined across registered credentials (per TS11 §4.2).

curl https://registry.siros.org/api/v1/attributes.json

The response contains a data array of Attribute objects, plus total, limit, and offset fields.

Supports query parameters:

ParameterDescription
limitMaximum number of results (default: all)
offsetNumber of results to skip (default: 0)
nameSpaceFilter by namespace URI
identifierFilter by attribute identifier (substring match)

GET /attributes/{attrId}

Returns a single Attribute object by identifier.

curl https://registry.siros.org/api/v1/attributes/{identifier}.json

See the Catalogue of Attributes page for a browsable view.

Signature Verification

When signing is enabled, responses are also available as .jwt files (JWS compact serialization). Public keys are published as a JWKS at https://registry.siros.org/api/v1/.well-known/jwks.json.

OpenAPI Specification

Download OpenAPI 3.1 specification

Statistics

40 registered credential(s). Last built: 2026-09-10T06:15:35Z.