Get a catalog item
Returns one published catalog item. A hidden id and a missing id both answer 404. No bearer token needed: the catalog is the same for every caller.
GET
/v1/public-catalog/{catalogItemId}Path parameters
catalogItemIdstringrequiredThe catalog item id, as GET /v1/public-catalog returns it.
matches ^[a-z][a-z0-9_-]{2,127}$
Responses
200
Public catalog item
catalogItemIdstringrequiredmatches ^[a-z][a-z0-9_-]{2,127}$
revisionintegerrequiredmin 1 · max 9007199254740991
providerIdstringrequiredmatches ^[a-z][a-z0-9_-]{2,127}$
operationIdstringrequiredmatches ^[a-z][a-z0-9_-]{2,127}$
titlestringrequiredmin length 1 · max length 160
descriptionstringrequiredmin length 1 · max length 2000
categoriesstring[]requiredmin items 1 · max items 30
capabilitiesstring[]requiredmax items 30
inputSchemaDigeststringrequiredmatches ^sha256:[a-f0-9]{64}$
outputSchemaDigeststringrequiredmatches ^sha256:[a-f0-9]{64}$
methodstring | nullrequiredAllowed:
GETPOSTPUTPATCHDELETEnullpathTemplatestring | nullrequiredmin length 1 · max length 1024
parametersobject[]requiredmax items 100
Show propertiesHide properties
Array of
objectnamestringrequiredmin length 1 · max length 120
locationanyrequiredAllowed:
querypathheaderbodyrequiredbooleanrequireddescriptionstringmin length 1 · max length 500
schemaDigeststringmatches ^sha256:[a-f0-9]{64}$
verificationobjectrequiredShow propertiesHide properties
stateanyrequiredAllowed:
unverifiedfixture_verifiedauthenticated_verifiedstaleverifiedAtstring<date-time> | nullrequiredresponseCaptureobjectrequiredShow propertiesHide properties
availablebooleanrequireddigeststring | nullrequiredmatches ^sha256:[a-f0-9]{64}$
referencesobject[]requiredmax items 20
Show propertiesHide properties
Array of
objectkindanyrequiredAllowed:
documentationpricingurlstring<uri>requiredmax length 2048
pricePublicCatalogPricerequiredShow propertiesHide properties
One of:
object
stateanyrequiredamountMicrosintegerrequiredmin 0 · max 9007199254740991
currencystringrequiredmatches ^[A-Z]{3}$
unitstringrequiredmin length 1 · max length 80
effectiveAtstring<date-time>requiredcomparisonBasisobjectShow propertiesHide properties
canonicalMeterstringrequiredmatches ^[a-z][a-z0-9_-]{2,127}$
billingBasisanyrequiredAllowed:
per_callper_resultper_unittierstringrequiredmin length 1 · max length 80
minimumMicrosintegerrequiredmin 0 · max 9007199254740991
roundinganyrequiredAllowed:
exactceilfloorobject
stateanyrequiredAllowed:
unknownuncomputablereasonstringrequiredmin length 1 · max length 300
publishedAtstring<date-time>requireditemDigeststringrequiredmatches ^sha256:[a-f0-9]{64}$
provenanceTieranyrequiredAllowed:
officialverified_partnercommunityprivateunverified401
Only returned for a malformed request; no bearer token is required
403
Catalog read scope required
404
Catalog item not found