Skip to main content
Fetch one Catalog service by slug: its metadata and a requestShape block describing every callable endpoint. Read this before pay_service or quote_service. Discovery only — free, no credential, nothing charged. An unknown slug returns an error. Auth: free · Charges: nothing

Arguments

Returns

A large metadata object; the fields that matter for a call are protocol, priceLabel, network, healthStatus, and requestShape:
Working with requestShape.endpoints[]:
  • payServiceArgs is what to hand to pay_service or quote_service — send it as given; its path is already the one to use. It always carries slug / path / method, and for an endpoint with a verified (paid-run or challenge) example it also carries a pre-filled body (and may carry search / headers); don’t drop those and rebuild your own. When pathParams is non-empty and an example filled them, path already holds the example’s entity — not a {placeholder}, so there is nothing to “replace”; swap in the entity you actually want instead of paying for the example’s.
  • requestSchema is the merchant-declared JSON Schema of the request — sanitised, not verified (requestSchemaSource names its origin, e.g. openapi or merchant). In it, properties.query lists what goes in the search argument and properties.body what goes in body — so a query block belongs in search, not inside body. verificationStatus is separate: it reports whether Nevermined has confirmed the endpoint actually works (unverified until a check passes), so it speaks to the endpoint while the schema stays sanitised-not-verified. An endpoint may instead carry noParameters: true, or neither; build the request from the description or the provider’s docs when there’s no schema.
  • maxRequestBytes is a per-endpoint request-size cap (e.g. 8000). A request larger than it is refused with BCK.ROUTER.0027 before the unpaid probe — nothing is minted and no charge; shrink the request below the cap.
  • A checked invoke contract may add invokePath, requestExample, merchant-authored responseSchema / responseExample, and exampleEvidence: paid-run (a recorded paid response), challenge (proves the request shape only), or docs (unverified provider docs). Only paid-run and challenge examples are pre-filled into payServiceArgs; adopt a docs example deliberately.
  • An endpoint may carry a quote — the last merchant price the Catalog observed, with the routing fee excluded. Good for comparing services; for the live, fee-inclusive total of your exact call use quote_service.
  • endpointCheck records a dated unpaid failure, if any.
  • Subscription credits. Called with an API key, an endpoint that Nevermined credits can pay also carries subscription: { "estimatedCreditsPerCall": 216 }: an estimate of one call, from the last price seen. Credits follow each service’s live price, so quote_service gives the exact credits of your request. It describes the endpoint, not your account, so it shows whether or not you subscribe; read get_budget for your own credits. No subscription means credits can’t pay that endpoint, the call was anonymous, or the rates couldn’t be read this time.
  • An endpoint with auth: "siwx" is not paid: it is the result endpoint of an async service (a job or call poll), free only for the wallet that paid an earlier call to the same service. Call it with pay_service after that call, filling its pathParams with the id the paid response returned; the Router signs the wallet challenge and charges nothing. See Getting your results.

Try it

Ask your assistant:
Show the endpoints and price of the openweather-mpp service.
Call it directly (discovery is free — no credential needed):