Hanzo
OpenapiMarketplace

Returns the listings the caller's own org has published — what this org is…

Returns the listings the caller's own org has published — what this org is offering, not what it can buy.

GET /v1/marketplace/listings

Addresshttps://api.hanzo.ai/v1/marketplace/listings
MethodGET
Operationget_marketplace_listings
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the listings the caller's own org has published — what this org is offering, not what it can buy. A publisher only ever sees its own rows.

Request

GET /v1/marketplace/listings takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200listingPageok

200 body — 12 fields.

FieldInTypeAlwaysDescription
listingsbodyListing[]Listings is every listing this org has published, private ones included (Public says which are discoverable by others).
listings[].categorybodystringCategory groups the listing in the shop window.
listings[].createdAtbodyintegerCreatedAt is when the listing was published, in Unix SECONDS, minted at insert.
listings[].currencybodystringCurrency is the ISO 4217 code Price is quoted in; Create defaults it to "USD" when the publisher names none.
listings[].descriptionbodystringDescription is the long copy.
listings[].idbodystringID is the listing's id, minted here as "lst_" + 16 hex characters. A publisher cannot choose it: Create overwrites whatever arrives.
listings[].pricebodyanyexact per-call price; 0 is free.
listings[].publicbodybooleanPublic is whether other orgs can discover the listing.
listings[].publisherOrgbodystringPublisherOrg is the org that published the listing, taken from the validated principal and never off the wire.
listings[].recipientbodystringseller payout WALLET ID, in PublisherOrg.
listings[].titlebodystringTitle is the shop-window name, required and refused past 200 bytes.
listings[].toolbodystringTool is the registry name of the offered capability, in the flat fleet-wide tool namespace.

Failure carries the platform error shape — see Errors.

Examples

hanzo marketplace listings list

Marketplace API · All Hanzo APIs · Interactive reference

How is this guide?

On this page