Router

Quote a call in subscription credits

Credits one call to a catalog endpoint costs with your Nevermined Subscription: the endpoint's current rate on Nevermined's rate card, whatever the merchant charges at the moment of the call. Rates change without notice; the rate in force when the call is made applies.

Answers from the rate card alone — the merchant is not contacted, nothing is reserved and nothing is charged. It refuses what POST /router/subscription/route would refuse before contacting the merchant (an ineligible or untariffed endpoint, no spendable subscription), but it does NOT check your credits left, the merchant's live price or Nevermined's treasury; the route checks those when the call is made. A url is refused (BCK.SUBSCRIPTION_ROUTER.0005).

Personal API keys only: the Nevermined Subscription belongs to a personal account, so call with a key that carries no organization tag and without X-Current-Org-Id. An OAuth-minted credential is refused (BCK.OAUTH.0030). Where the subscription is not available — on this deployment or to this account — it answers 404 BCK.SUBSCRIPTION_ACCESS.0001.

post/router/subscription/quote

Request

  • Base URL: https://api.sandbox.nevermined.app/api/v1
  • URL: https://api.sandbox.nevermined.app/api/v1/router/subscription/quote
  • Auth: HTTP bearer

Request body

slugstring required

Catalog slug of the service to call. Subscription credits pay catalog services only, addressed by slug; the Router resolves it to the merchant server-side.

pathstring

Subpath of the endpoint to price, as on the route (path segments only).

method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'

HTTP method of the call to price.

Example request

{
  "slug": "webscrape-pro",
  "path": "scrape"
}

Response

The credits one call to this endpoint costs, and the tariff version that sets it.

slugstring required

The catalog slug priced.

creditsinteger required

Credits one call to this endpoint costs: its current rate on Nevermined's rate card, whatever the merchant charges at the moment of the call.

tariffVersioninteger required

The tariff version that sets credits.

Example response

{
  "slug": "webscrape-pro",
  "credits": 3,
  "tariffVersion": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.