Schema Catalogue

The credential type catalogue — type metadata and JSON Schemas for every `vct`. Static, public, no authentication.

Catalogue (shared by the real network and the sandbox)

https://schemas.tamga.network/v1

Authentication

None — public

Definition

OpenAPI 3.1 file · Guide

Every Tamga credential type has a URN (vct, e.g. urn:tamga:edu:DiplomaCredential:1). The catalogue maps each vct to its SD-JWT VC Type Metadata and JSON Schema (IETF SD-JWT VC registry resolution). The credential carries vct#integrity; compare it with the catalogue entry's content_hash before trusting the metadata. Files are versioned by path and never change once published; the trust lists anchor every schema's digest.

@tamga-network/schemas contains the same catalogue for offline use. The rules are in SPEC-SCHEMA-0001.

Endpoints

Endpoint	Description
GET /catalogue.json	Get the catalogue
GET /index.json	Get the plain index
GET /{domain}/{type}/{version}/metadata.json	Get a type's metadata
GET /{domain}/{type}/{version}/schema.json	Get a type's JSON Schema

Authentication

No authentication: every endpoint is public.

Catalogue

Find a credential type and its files.

Get the catalogue

GET/catalogue.json

Every credential type with its metadata and schema addresses, digests and status.

Authentication None — public

Responses

Status	Description
200	The catalogue.

Example

Request · curl

curl "https://schemas.tamga.network/v1/catalogue.json"

Response · 200

{
  "catalogue_version": 0,
  "generated_at": "2026-10-09T12:00:00Z",
  "base": "https://example.org",
  "entries": [
    {
      "vct": "urn:tamga:edu:StudentCredential:1",
      "schema_id": "…",
      "metadata_url": "https://example.org",
      "schema_url": "https://example.org",
      "content_hash": "…",
      "content_hashes": [
        "…"
      ],
      "version": "1.0.0",
      "layer": "NETWORK",
      "status": "ACTIVE"
    }
  ]
}

Get the plain index

GET/index.json

The catalogue entries as a plain array (no envelope).

Authentication None — public

Responses

Status	Description
200	Entries. Returns CatalogueEntry

Example

Request · curl

curl "https://schemas.tamga.network/v1/index.json"

Response · 200

[
  {
    "vct": "urn:tamga:edu:StudentCredential:1",
    "schema_id": "…",
    "metadata_url": "https://example.org",
    "schema_url": "https://example.org",
    "content_hash": "…",
    "content_hashes": [
      "…"
    ],
    "version": "1.0.0",
    "layer": "NETWORK",
    "status": "ACTIVE"
  }
]

Get a type's metadata

GET/{domain}/{type}/{version}/metadata.json

SD-JWT VC Type Metadata: display names in each language, the parent type (extends + extends#integrity), the schema address with schema_uri#integrity, and claim display rules. Use the metadata_url from the catalogue rather than building the path yourself.

Authentication None — public

Parameters

Name	In	Type	Description
domain required	path	string
type required	path	string
version required	path	string

Responses

Status	Description
200	Type Metadata.
404	Unknown type or version.

Example

Request · curl

curl "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/metadata.json"

Response · 200

{
  "vct": "urn:tamga:edu:StudentCredential:1",
  "version": "1.0.0",
  "name": "Tamga Student Credential",
  "extends": "urn:tamga:core:TamgaBaseCredential:1",
  "schema_uri": "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/schema.json",
  "display": [
    {
      "lang": "tr-TR",
      "name": "Öğrenci Belgesi"
    },
    {
      "lang": "en-US",
      "name": "Student Certificate"
    }
  ]
}

Get a type's JSON Schema

GET/{domain}/{type}/{version}/schema.json

The JSON Schema of the credential's claims (use the schema_url from the catalogue).

Authentication None — public

Parameters

Name	In	Type	Description
domain required	path	string
type required	path	string
version required	path	string

Responses

Status	Description
200	JSON Schema.
404	Unknown type or version.

Example

Request · curl

curl "https://schemas.tamga.network/v1/edu/StudentCredential/1.0.0/schema.json"

Response · 200

{}

Objects

CatalogueEntry

Field	Type	Description
vct	string
schema_id	string	keccak256(vct)
metadata_url	string (uri)
schema_url	string (uri)
content_hash	string	Digest of the current metadata — equals vct#integrity in the credential.
content_hashes	array<string>	Digests of the valid versions.
version	string
layer	string	One of: NETWORK · NATIONAL
status	string

---

Import the machine-readable definition into any OpenAPI tool to generate a client or send test requests: schema-catalogue.openapi.yaml.