List contract versions
Lists registered contract versions across the whole catalog, one page at a time. Use it to discover fact types, or every contract that declares a reference type.
Rules
- Every filter is optional and they combine:
producer,namespace,type,status(ACTIVEorDEPRECATED; both by default) andreferenceType, which answers who uses this reference type by matching every version that declares it. - Items are ordered by producer, namespace, fact type and schema version compared as text, so
1.10.0sorts before1.9.0; uselistContractVersionsfor semantic version order within one fact type. - Items carry no payload schema: read it with
getContract. - Paged by an opaque cursor: pass a page’s
nextCursorto read the next page;nextCursoris omitted on the last page.limitis 1 to 100 (default 50).
Responses
200one page; an empty page when nothing matches.422SF-0092a bad filter value,limitor cursor.503SF-0094retry later.
Autorizaciones
JWT issued by the identity provider. A producer calls with a service credential issued for the tenant it sends facts for; a reader calls with a user token or a service credential. The tenant is always taken from the token, never from the request path, query or body.
Parámetros de consulta
Only contract versions of this producer.
64Only contract versions in this namespace.
128Only contract versions of this fact type.
128Only contract versions in this lifecycle status; every status by default. Allowed values: ACTIVE, DEPRECATED.
ACTIVE, DEPRECATED Only contract versions that declare this reference type ("who uses this type").
128"acme.order_id"
Page size, from 1 to 100; defaults to 50.
1 <= x <= 100Opaque nextCursor of the previous page; omit it to read the first page.
256Respuesta
One page of contract versions without their payload schemas, in text order, empty when nothing matches; nextCursor is omitted on the last page.
Contract versions of this page in cursor order, without their payload schemas; read one with getContract.
Page size applied to this request, after the maximum of 100.
Opaque cursor of the next page: send it back as cursor. Omitted on the last page.

