List reference types
Lists the registered reference types one page at a time, ordered by name. Use it to discover the types a contract can declare.
Rules
- Both filters are optional and combine:
prefixmatches whole dotted segments (acme.ordersmatchesacme.ordersandacme.orders.order_id, neveracme.ordersx);correlationisexactornone. - An item does not list the contracts that use the type: to find them, call
listContractswithreferenceType(GET /v1/contracts?referenceType=acme.order_id). - 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.
Authorizations
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.
Query Parameters
Only types whose name is this dotted prefix or continues it after a dot (whole segments: acme.orders never matches acme.ordersx).
128"acme"
Only types of this correlation. Allowed values: exact, none.
exact, none Page size, from 1 to 100; defaults to 50.
1 <= x <= 100Opaque nextCursor of the previous page; omit it to read the first page.
256Response
One page of reference types ordered by name, empty when nothing matches; nextCursor is omitted on the last page.

