Properties
| Name | Type | Description |
|---|---|---|
| receiveBuyerIdentity | boolean | Whether this seller accepts buyer-consented Router identity claims. |
| id | string | |
| slug | string | |
| title | string | |
| provider | stringnull | |
| category | string | |
| subCategory | stringnull | Granular sub-category under `category`; null for the generic top bucket. |
| shortDescription | string | |
| longDescription | stringnull | Markdown overview shown on the detail page. |
| protocol | string | |
| invokeUrl | string | Opaque Router invoke URL for this service. POST here with a Nevermined API key + delegation to pay-through; the Router calls the merchant and the real upstream URL is never exposed. Address the servic |
| priceLabel | stringnull | |
| headlinePriceLabel | stringnull | USD headline summarising published endpoint prices. "from $X" is the lowest labelled paid endpoint price; free and unlabelled endpoints are left out, so some calls may cost less. Null when no endpoint |
| network | stringnull | |
| logoUrl | stringnull | Logo URL when the listing has one that names no upstream host; null otherwise (render an initials avatar). |
| endpoints | array | |
| verificationStatus | string | Aggregate verification across the service endpoints. degraded: at least one endpoint is failing its probe, including one hidden from endpoints after repeated failures. verified-by-canary: at least one |
| verifiedAt | stringnull | The most recent verifiedAt among this service's verified-by-canary endpoints. Null unless verificationStatus is verified-by-canary, and null when no verified endpoint has a recorded success time. |
| successRate | numbernull | Settled calls as a percentage of settled plus charged-not-delivered service calls. Null when no attributable outcome exists. |
| lastSuccessfulCallAt | stringnull | When the service last had a settled call through its opaque catalog slug. |
| recipients | array | Observed payment recipients. |
| provenance | object | |
| features | array | |
| tags | array | |
| isListed | boolean | Public gate. Unlike the public API, this can be false for an unlisted listing. |
| tier | number | Curation tier (1 = top). The default listing orders by tier, then by editorial `sortWeight` descending, tier-neutral rankScore descending, then a time-seeded shuffle among ties. |
| sortWeight | number | Editorial weight, higher first. The default view uses tier + sortWeight + tier-neutral rankScore, then rotates exact ties. Use `tier` to band a service. |
| partner | boolean | Nevermined Partner trust badge (Nevermined-granted). |
| featured | boolean | Featured badge (Nevermined-granted) — drives the Featured shelf. |
| official | boolean | Official owner badge — true when the provider has verified ownership of this service. Derived from the claim; the claimer identity and proven domain are never published. |
| integration | string | gateway when a third-party reseller gateway sells this listing: the gateway is the merchant of record and its price includes the gateway fee. first-party otherwise. Present on list and detail rows; th |
| freeAfterPurchasePaths | array | Result-path prefixes this service relays FREE after YOUR OWN paid call on it, within the follow-up window (e.g. a job or result poll reached with an id the paid call returned). A declared prefix is dr |
| rankScore | numbernull | The Nevermined ranking value (#3473) — higher = recommended first; sort DESC. Treat as an OPAQUE quality metric, NOT a 0–1 percentage: it has no documented ceiling and MAY exceed 1. It is independent |
| readinessScore | numbernull | Readiness score (0–100): how complete this listing is — metadata, pricing, documented endpoints. Present on the public catalog read (null until scored); absent on owner endpoints. Sort DESC with ?sort |
| readinessBand | stringnull | Readiness band for `readinessScore`. Present on the public read (null until scored). |
| healthStatus | stringnull | Liveness status from the catalog-monitor agent — currently one of operational / degraded / unavailable / unverified (unverified = cannot be probed, no signal, NOT "down"). Treat as an OPEN string and |
| healthConfidence | numbernull | Monitor-reported confidence (0–1): liveness is min(uptime-or-baseline liveness, confidence). Null means no cap was reported, so legacy liveness scoring is uncapped. Describes monitor evidence and may |
| uptime7d | numbernull | Uptime % over the trailing 7 days (conclusive probes); null when no coverage, or while the listing has paid calls from several buyers and none settled in 30 days. |
| uptime30d | numbernull | Uptime % over the trailing 30 days (conclusive probes); null when no coverage, or while the listing has paid calls from several buyers and none settled in 30 days. |
| latencyP50Ms | numbernull | p50 of the liveness probe round-trip (ms) — gateway/manifest response time, NOT the AI service's inference latency. null until observed. |
| latencyP95Ms | numbernull | p95 of the liveness probe round-trip (ms) — gateway response time, not inference. |
| lastCheckedAt | stringnull | When the monitor last probed this service. |
| lastHealthyAt | stringnull | When the monitor last saw this service healthy; null while the listing has paid calls from several buyers and none settled in 30 days. |
| lastSettledAt | stringnull | When this service last had a Settled router-payment (30-day window). null = no recent settlement / never observed. Liveness only — no traction volume, no upstream identity. |
| distinctPayers30d | numbernull | Distinct payers over the trailing 30 days (traction). null when there is no recent settlement signal. SELF-REPORTED: counts distinct buyer wallets on self-attested settlements, not on-chain-verified p |
| stale | boolean | Display-only "no traction in ≥30 days" flag, derived from lastSettledAt. Never auto-delists. A quiet listing surfaces as lastSettledAt=null (stale=false), NOT stale=true. |
| settledPriceLabel | stringnull | Coarse USD-equivalent of the true settled price. On this owner surface it is always shown (no public distinct-payer floor applies) — null means the rollup produced no price yet, not "withheld". |
| displayPriceLabel | stringnull | Single display price: the settled price when public-eligible, else the advertised quoted (402) price. null when neither is known. Coarse `$`, asset/network withheld. Use displayPriceSource to label it |
| displayPriceSource | stringnull | Provenance of displayPriceLabel: "settled" (real payments) or "quoted" (advertised 402 price, not yet settled — render as "quoted, not settled"); null when no price. |
| createdAt | string | |
| updatedAt | string | |
| agentDid | stringnull | |
| orgId | stringnull | |
| submittedBy | stringnull | Member who published the listing. |
| moderationStatus | stringnull | |
| listedAt | stringnull | |
| pendingSince | stringnull | When the listing last entered validation — the clock the 24h sweep measures from. |
| unlistedReason | stringnull | Why the listing is unlisted. |
| moderatorHold | boolean | True when Nevermined moderation (not the owner) unlisted this listing. While set, Re-submit and endpoint edits are refused (403 BCK.CATALOG.0010) — the owner cannot self-relist. |
| validationStatus | stringnull | |
| validationReasonCode | stringnull | |
| validationMessage | stringnull | Sanitized validation feedback. |
| validationRetryable | booleannull | |
| validationHttpStatus | numbernull | |
| validationLatencyMs | numbernull | |
| validationAttempts | number | |
| validationStartedAt | stringnull | |
| validationCompletedAt | stringnull | |
| validationNextAttemptAt | stringnull | |
| validationVersion | stringnull | |
| validationDetails | object | Bounded, sanitized validator diagnostics. Never contains an upstream body. |
| freeFollowupPaths | array | Subpath prefixes whose free (non-402) response body the Router may relay after a paid invocation of this service — the free-follow-up gate allowlist. The RAW column is stripped from every public proje |
| freeAlwaysPaths | array | Subpath prefixes declared to serve free with no prior payment (C2 always-free / teaser endpoints); the Router relays a matching 2xx with no payment, bounded by an abuse quota. The RAW column is stripp |
| paymentCount30d | numbernull | |
| activeDays30d | numbernull | |
| settledPriceAtomic | stringnull | True settled price in atomic units of settledPriceAsset (owner-only, wei-precision). |
| settledPriceAsset | stringnull | |
| settledPriceNetwork | stringnull | |
| signalsUpdatedAt | stringnull | When this listing's rollup last CHANGED. An unchanged recompute is skipped, so this can be older than the last sweep — it is not an as-of/freshness timestamp. |
| quotedPriceAtomic | stringnull | Advertised 402 price in atomic units (owner-only, wei-precision). |
| quotedPriceAsset | stringnull | |
| quotedPriceNetwork | stringnull | |
| quotedPriceUpdatedAt | stringnull | |
| featuredLevel | number | Editorial Nevermined Featured level 0..5 (0 = not featured). Internal; owner/admin only. |
| qualityScore | numbernull | Measured composite quality 0..1 (no Featured). Internal; owner/admin only — never published, so editorial promotion cannot be told from measured quality. null until first scored. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/nevermined-app/json-schema/nevermined-app-owner-catalog-listing-dto-schema.json",
"title": "OwnerCatalogListingDto",
"x-generated": "2026-11-20",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/nevermined-app-openapi.json#/components/schemas/OwnerCatalogListingDto",
"type": "object",
"properties": {
"receiveBuyerIdentity": {
"type": "boolean",
"description": "Whether this seller accepts buyer-consented Router identity claims.",
"default": false
},
"id": {
"type": "string",
"format": "uuid"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"provider": {
"type": [
"string",
"null"
]
},
"category": {
"type": "string",
"enum": [
"Data & Enrichment",
"Sales & Business Intelligence",
"Web Scraping & Automation",
"Search & Research",
"Crypto & Blockchain",
"Finance & Markets",
"AI & Media",
"Communication & Voice",
"Social & Creator",
"Identity & Compliance",
"Infrastructure & Compute",
"Weather",
"Travel"
]
},
"subCategory": {
"type": [
"string",
"null"
],
"description": "Granular sub-category under `category`; null for the generic top bucket."
},
"shortDescription": {
"type": "string"
},
"longDescription": {
"type": [
"string",
"null"
],
"description": "Markdown overview shown on the detail page."
},
"protocol": {
"type": "string",
"enum": [
"x402",
"mpp",
"rest",
"a2a",
"other"
]
},
"invokeUrl": {
"type": "string",
"description": "Opaque Router invoke URL for this service. POST here with a Nevermined API key + delegation to pay-through; the Router calls the merchant and the real upstream URL is never exposed. Address the service by this alias (or its slug), never a raw upstream host."
},
"priceLabel": {
"type": [
"string",
"null"
]
},
"headlinePriceLabel": {
"type": [
"string",
"null"
],
"description": "USD headline summarising published endpoint prices. \"from $X\" is the lowest labelled paid endpoint price; free and unlabelled endpoints are left out, so some calls may cost less. Null when no endpoint is labelled, a labelled price is not a supported USD amount, or paid endpoints use different units. Budget per endpoint before calling."
},
"network": {
"type": [
"string",
"null"
]
},
"logoUrl": {
"type": [
"string",
"null"
],
"description": "Logo URL when the listing has one that names no upstream host; null otherwise (render an initials avatar)."
},
"endpoints": {
"type": "array",
"items": {
"$ref": "#/$defs/CatalogEndpointDto"
}
},
"verificationStatus": {
"type": "string",
"enum": [
"verified-by-canary",
"unverified",
"degraded"
],
"description": "Aggregate verification across the service endpoints. degraded: at least one endpoint is failing its probe, including one hidden from endpoints after repeated failures. verified-by-canary: at least one endpoint is verified-by-canary, and every other endpoint with a probe verdict answered live (a payment challenge, a request-validation error or a success), none failing or inconclusive; an endpoint with no probe verdict for the current targetUrl does not count against it. It does not mean every endpoint is verified: read each endpoint verificationStatus for that. unverified: otherwise."
},
"verifiedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "The most recent verifiedAt among this service's verified-by-canary endpoints. Null unless verificationStatus is verified-by-canary, and null when no verified endpoint has a recorded success time."
},
"successRate": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 100,
"description": "Settled calls as a percentage of settled plus charged-not-delivered service calls. Null when no attributable outcome exists."
},
"lastSuccessfulCallAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When the service last had a settled call through its opaque catalog slug."
},
"recipients": {
"description": "Observed payment recipients.",
"type": "array",
"items": {
"$ref": "#/$defs/CatalogRecipientDto"
}
},
"provenance": {
"$ref": "#/$defs/CatalogProvenanceDto"
},
"features": {
"type": "array",
"items": {
"$ref": "#/$defs/CatalogFeatureDto"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"isListed": {
"type": "boolean",
"description": "Public gate. Unlike the public API, this can be false for an unlisted listing."
},
"tier": {
"type": "number",
"description": "Curation tier (1 = top). The default listing orders by tier, then by editorial `sortWeight` descending, tier-neutral rankScore descending, then a time-seeded shuffle among ties."
},
"sortWeight": {
"type": "number",
"description": "Editorial weight, higher first. The default view uses tier + sortWeight + tier-neutral rankScore, then rotates exact ties. Use `tier` to band a service."
},
"partner": {
"type": "boolean",
"description": "Nevermined Partner trust badge (Nevermined-granted)."
},
"featured": {
"type": "boolean",
"description": "Featured badge (Nevermined-granted) — drives the Featured shelf."
},
"official": {
"type": "boolean",
"description": "Official owner badge — true when the provider has verified ownership of this service. Derived from the claim; the claimer identity and proven domain are never published."
},
"integration": {
"type": "string",
"enum": [
"first-party",
"gateway"
],
"description": "gateway when a third-party reseller gateway sells this listing: the gateway is the merchant of record and its price includes the gateway fee. first-party otherwise. Present on list and detail rows; the same value as provenance.integration."
},
"freeAfterPurchasePaths": {
"description": "Result-path prefixes this service relays FREE after YOUR OWN paid call on it, within the follow-up window (e.g. a job or result poll reached with an id the paid call returned). A declared prefix is dropped when any SERVED endpoint under it is NOT declared free (paid is the default — the paid submit that 402s often shares the prefix), so what remains is the genuinely free-to-poll result paths (the shape with no listed endpoint of its own). NOTE a 402 under any of these prefixes is STILL PAID — the relay frees only a 2xx after your paid call. Omitted on the owner read, which shows the raw declaration.",
"type": "array",
"items": {
"type": "string"
}
},
"rankScore": {
"type": [
"number",
"null"
],
"description": "The Nevermined ranking value (#3473) — higher = recommended first; sort DESC. Treat as an OPAQUE quality metric, NOT a 0–1 percentage: it has no documented ceiling and MAY exceed 1. It is independent of the seller organization subscription tier. The measured inputs and the editorial Featured level that produce it are internal. null until first scored."
},
"readinessScore": {
"type": [
"number",
"null"
],
"description": "Readiness score (0–100): how complete this listing is — metadata, pricing, documented endpoints. Present on the public catalog read (null until scored); absent on owner endpoints. Sort DESC with ?sortBy=readinessScore (unscored last). Advisory: it does NOT affect rankScore/qualityScore or the default order beyond breaking ties."
},
"readinessBand": {
"type": [
"string",
"null"
],
"enum": [
"excellent",
"ready",
"almost-there",
"getting-started"
],
"description": "Readiness band for `readinessScore`. Present on the public read (null until scored)."
},
"healthStatus": {
"type": [
"string",
"null"
],
"description": "Liveness status from the catalog-monitor agent — currently one of operational / degraded / unavailable / unverified (unverified = cannot be probed, no signal, NOT \"down\"). Treat as an OPEN string and tolerate unknown values: the set may grow. null until first observed. The monitor probes WITHOUT paying, so an `operational` status is withheld (null) while a listing has paid calls from several buyers and none settled in 30 days."
},
"healthConfidence": {
"type": [
"number",
"null"
],
"description": "Monitor-reported confidence (0–1): liveness is min(uptime-or-baseline liveness, confidence). Null means no cap was reported, so legacy liveness scoring is uncapped. Describes monitor evidence and may accompany degraded status when the latest probe succeeded after a recent incident."
},
"uptime7d": {
"type": [
"number",
"null"
],
"description": "Uptime % over the trailing 7 days (conclusive probes); null when no coverage, or while the listing has paid calls from several buyers and none settled in 30 days."
},
"uptime30d": {
"type": [
"number",
"null"
],
"description": "Uptime % over the trailing 30 days (conclusive probes); null when no coverage, or while the listing has paid calls from several buyers and none settled in 30 days."
},
"latencyP50Ms": {
"type": [
"number",
"null"
],
"description": "p50 of the liveness probe round-trip (ms) — gateway/manifest response time, NOT the AI service's inference latency. null until observed."
},
"latencyP95Ms": {
"type": [
"number",
"null"
],
"description": "p95 of the liveness probe round-trip (ms) — gateway response time, not inference."
},
"lastCheckedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When the monitor last probed this service."
},
"lastHealthyAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When the monitor last saw this service healthy; null while the listing has paid calls from several buyers and none settled in 30 days."
},
"lastSettledAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When this service last had a Settled router-payment (30-day window). null = no recent settlement / never observed. Liveness only — no traction volume, no upstream identity."
},
"distinctPayers30d": {
"type": [
"number",
"null"
],
"description": "Distinct payers over the trailing 30 days (traction). null when there is no recent settlement signal. SELF-REPORTED: counts distinct buyer wallets on self-attested settlements, not on-chain-verified payments — a wallet can be rotated, so treat it as an unverified traction hint, not proof. Published unfloored by design (a low count is itself informative)."
},
"stale": {
"type": "boolean",
"description": "Display-only \"no traction in ≥30 days\" flag, derived from lastSettledAt. Never auto-delists. A quiet listing surfaces as lastSettledAt=null (stale=false), NOT stale=true."
},
"settledPriceLabel": {
"type": [
"string",
"null"
],
"description": "Coarse USD-equivalent of the true settled price. On this owner surface it is always shown (no public distinct-payer floor applies) — null means the rollup produced no price yet, not \"withheld\"."
},
"displayPriceLabel": {
"type": [
"string",
"null"
],
"description": "Single display price: the settled price when public-eligible, else the advertised quoted (402) price. null when neither is known. Coarse `$`, asset/network withheld. Use displayPriceSource to label it."
},
"displayPriceSource": {
"type": [
"string",
"null"
],
"enum": [
"settled",
"quoted"
],
"description": "Provenance of displayPriceLabel: \"settled\" (real payments) or \"quoted\" (advertised 402 price, not yet settled — render as \"quoted, not settled\"); null when no price."
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"agentDid": {
"type": [
"string",
"null"
]
},
"orgId": {
"type": [
"string",
"null"
]
},
"submittedBy": {
"type": [
"string",
"null"
],
"description": "Member who published the listing."
},
"moderationStatus": {
"type": [
"string",
"null"
],
"enum": [
"pending",
"live",
"failed",
"degraded",
"removed"
]
},
"listedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"pendingSince": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When the listing last entered validation — the clock the 24h sweep measures from."
},
"unlistedReason": {
"type": [
"string",
"null"
],
"description": "Why the listing is unlisted."
},
"moderatorHold": {
"type": "boolean",
"description": "True when Nevermined moderation (not the owner) unlisted this listing. While set, Re-submit and endpoint edits are refused (403 BCK.CATALOG.0010) — the owner cannot self-relist."
},
"validationStatus": {
"type": [
"string",
"null"
],
"enum": [
"pending",
"running",
"valid",
"invalid",
"inconclusive"
]
},
"validationReasonCode": {
"type": [
"string",
"null"
]
},
"validationMessage": {
"type": [
"string",
"null"
],
"description": "Sanitized validation feedback."
},
"validationRetryable": {
"type": [
"boolean",
"null"
]
},
"validationHttpStatus": {
"type": [
"number",
"null"
]
},
"validationLatencyMs": {
"type": [
"number",
"null"
]
},
"validationAttempts": {
"type": "number"
},
"validationStartedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"validationCompletedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"validationNextAttemptAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"validationVersion": {
"type": [
"string",
"null"
]
},
"validationDetails": {
"nullable": true,
"allOf": [
{
"type": "object",
"additionalProperties": true
}
],
"description": "Bounded, sanitized validator diagnostics. Never contains an upstream body."
},
"freeFollowupPaths": {
"description": "Subpath prefixes whose free (non-402) response body the Router may relay after a paid invocation of this service — the free-follow-up gate allowlist. The RAW column is stripped from every public projection and shown only here; where the free-follow-up relay is enabled a DERIVED `freeAfterPurchasePaths` annotation of these prefixes (minus any a served endpoint not declared free falls under; a 402 under a surfaced prefix is still paid) IS published to buyers.",
"type": "array",
"items": {
"type": "string"
}
},
"freeAlwaysPaths": {
"description": "Subpath prefixes declared to serve free with no prior payment (C2 always-free / teaser endpoints); the Router relays a matching 2xx with no payment, bounded by an abuse quota. The RAW column is stripped from every public projection and shown only here; a matching listed (non-templated, unpriced) endpoint IS published to buyers with an `access: \"free\"` label.",
"type": "array",
"items": {
"type": "string"
}
},
"paymentCount30d": {
"type": [
"number",
"null"
]
},
"activeDays30d": {
"type": [
"number",
"null"
]
},
"settledPriceAtomic": {
"type": [
"string",
"null"
],
"description": "True settled price in atomic units of settledPriceAsset (owner-only, wei-precision)."
},
"settledPriceAsset": {
"type": [
"string",
"null"
]
},
"settledPriceNetwork": {
"type": [
"string",
"null"
]
},
"signalsUpdatedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When this listing's rollup last CHANGED. An unchanged recompute is skipped, so this can be older than the last sweep — it is not an as-of/freshness timestamp."
},
"quotedPriceAtomic": {
"type": [
"string",
"null"
],
"description": "Advertised 402 price in atomic units (owner-only, wei-precision)."
},
"quotedPriceAsset": {
"type": [
"string",
"null"
]
},
"quotedPriceNetwork": {
"type": [
"string",
"null"
]
},
"quotedPriceUpdatedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"featuredLevel": {
"type": "number",
"description": "Editorial Nevermined Featured level 0..5 (0 = not featured). Internal; owner/admin only."
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Measured composite quality 0..1 (no Featured). Internal; owner/admin only — never published, so editorial promotion cannot be told from measured quality. null until first scored."
}
},
"required": [
"id",
"slug",
"title",
"category",
"shortDescription",
"protocol",
"invokeUrl",
"logoUrl",
"endpoints",
"features",
"tags",
"isListed",
"tier",
"sortWeight",
"partner",
"featured",
"official",
"integration",
"rankScore",
"lastSettledAt",
"distinctPayers30d",
"stale",
"settledPriceLabel",
"displayPriceLabel",
"displayPriceSource",
"createdAt",
"updatedAt",
"agentDid",
"orgId",
"submittedBy",
"moderationStatus",
"listedAt",
"pendingSince",
"unlistedReason",
"moderatorHold",
"validationStatus",
"validationReasonCode",
"validationMessage",
"validationRetryable",
"validationHttpStatus",
"validationLatencyMs",
"validationAttempts",
"validationStartedAt",
"validationCompletedAt",
"validationNextAttemptAt",
"validationVersion",
"validationDetails",
"freeFollowupPaths",
"freeAlwaysPaths",
"paymentCount30d",
"activeDays30d",
"settledPriceAtomic",
"settledPriceAsset",
"settledPriceNetwork",
"signalsUpdatedAt",
"quotedPriceAtomic",
"quotedPriceAsset",
"quotedPriceNetwork",
"quotedPriceUpdatedAt",
"featuredLevel",
"qualityScore"
],
"$defs": {
"CatalogEndpointDto": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"method": {
"type": "string"
},
"verificationStatus": {
"type": "string",
"enum": [
"verified-by-canary",
"unverified",
"degraded"
],
"description": "Current endpoint verification from continuous canary observations."
},
"verifiedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When the endpoint most recently passed its verified canary request."
},
"description": {
"type": "string"
},
"priceLabel": {
"type": "string"
},
"auth": {
"type": "string",
"enum": [
"siwx"
],
"description": "Set when the endpoint is not paid but wallet-authenticated (the merchant OpenAPI security scheme). siwx: free, only for the wallet that paid an earlier call to this service, e.g. a job or result poll. Call it through the Router with the id that paid call returned; the Router signs the wallet challenge. Absent for paid endpoints."
},
"access": {
"type": "string",
"enum": [
"free",
"free-after-purchase"
],
"description": "Set when the endpoint is free. free: the Router relays it with no payment on a plain-key or crypto (commerce) call; a call funded from subscription credits is not relayed free. free-after-purchase: free to call after YOUR OWN paid call to this service, within the follow-up window (e.g. a result poll). This label is an auth: siwx result poll, readable only by the same wallet that paid, so a call funded from a card, an organization wallet or subscription credits cannot collect it free. Absent for a normal paid endpoint."
},
"invokePath": {
"type": "string",
"description": "Suffix for the Router slug route, not the upstream path above. Empty means the advertised endpoint is already the slug base. Use this as the route body path or /svc subpath."
},
"requestExample": {
"type": "object",
"description": "Redacted payable-wrapper input, sent verbatim by pay_service. Check exampleEvidence: paid-run was observed in a successful invocation, challenge proves the request shape only, docs is unverified."
},
"responseSchema": {
"type": "object",
"description": "Sanitised merchant-authored JSON Schema for the response. Present on detail surfaces only."
},
"responseSchemaSource": {
"type": "string",
"enum": [
"x402-output-example",
"openapi-responses",
"paid-run"
],
"description": "Where the response schema was declared or observed."
},
"responseExample": {
"type": "object",
"description": "Sanitised merchant-authored example response. Harvested examples appear only after schema validation."
},
"responseExampleEvidence": {
"type": "string",
"enum": [
"paid-run",
"challenge",
"docs"
]
},
"responseExampleVerifiedAt": {
"type": "string",
"format": "date-time"
},
"contractEvidence": {
"type": "string",
"enum": [
"paid-run",
"fixture"
],
"description": "Evidence for the endpoint example, kept for compatibility: paid-run, or fixture for anything short of a paid run. Read exampleEvidence for the finer grade. Service-level operational health alone does not verify an endpoint."
},
"exampleEvidence": {
"type": "string",
"enum": [
"paid-run",
"challenge",
"docs"
],
"description": "How requestExample was verified: paid-run (a bounded paid call returned the response shape), challenge (the example drew a payment challenge from a gateway shown to validate the request before pricing it; proves the request shape, not the response), or docs (from provider documentation, unverified)."
},
"requestExampleQuality": {
"type": "string",
"enum": [
"proven",
"docs",
"no-input",
"none"
],
"description": "How well this endpoint publishes the way to call it. It grades the published EXAMPLE and is NOT a callability verdict. proven: a usable example earned against the real endpoint (paid-run or challenge) — a body/query example, or a concrete invokePath filling a templated path (e.g. /v1/apex/:id). docs: a usable example from documentation only, unverified. no-input: the endpoint takes no request input (noParameters) and is callable as-is. none: no stored example — if requestSchema is published, form the request from it (requestSchema is detail-only, but this grade reflects it). Present on list and detail alike."
},
"exampleVerifiedAt": {
"type": "string",
"format": "date",
"description": "For paid-run and challenge, the date that evidence was observed; for docs, the date the example was recorded from its source (it was never verified)."
},
"endpointCheck": {
"type": "object",
"description": "Dated endpoint observation when a listed invocation is known to fail; separate from the service-level health badge."
},
"maxRequestBytes": {
"type": "integer",
"minimum": 1,
"description": "Largest request body, in UTF-8 bytes, this endpoint accepts. The Router refuses a larger body before paying (BCK.ROUTER.0027), and service selection skips the endpoint for it. Absent when no limit is known."
},
"quote": {
"description": "The merchant's live price for one call, on the rail and network the Router pays it on (a personal crypto delegation). Present while fresh (48 h); priceLabel then shows this price. It EXCLUDES the Router's routing fee, which the delegation cap is also charged: for the total a call reserves, or a price specific to your delegation, use POST /api/v1/router/quote.",
"allOf": [
{
"$ref": "#/$defs/CatalogEndpointQuoteDto"
}
]
},
"requestSchema": {
"type": "object",
"description": "JSON Schema of the request, as the merchant declares it: `properties.query` describes the query parameters (sent as `search`), `properties.body` the JSON body. Merchant-authored and sanitised by Nevermined (a keyword allow-list, size bounds, no upstream host or URL in any string), NOT verified: read `requestSchemaSource`. Present on a service's detail only."
},
"requestSchemaSource": {
"type": "string",
"enum": [
"orthogonal-input",
"x402-bazaar",
"x402-output-schema",
"openapi",
"docs"
],
"description": "Where requestSchema came from: orthogonal-input (the field list the gateway declares in its unpaid 400 input block or its 402 MPP challenge), x402-bazaar (the x402 v2 bazaar extension), x402-output-schema (an x402 v1 accepts[].outputSchema), openapi (the merchant's OpenAPI document), docs. Always merchant-declared, never Nevermined-verified."
},
"noParameters": {
"type": "boolean",
"enum": [
true
],
"description": "Present (true) when the endpoint takes no parameters: a bare request drew a payment challenge from a gateway shown to reject a request missing a required parameter. Present on a service's detail only."
}
},
"required": [
"path"
]
},
"CatalogEndpointQuoteDto": {
"type": "object",
"properties": {
"rail": {
"type": "string",
"enum": [
"x402",
"mpp"
],
"description": "The rail the Router pays this endpoint on for a personal crypto delegation: its own choice for the live 402 (MPP first; a 402 offering both rails whose MPP challenge's terms the Router does not accept is listed on its x402 offer)."
},
"intent": {
"type": [
"string",
"null"
],
"description": "The settlement scheme: x402 `exact`, MPP `charge`."
},
"network": {
"type": "string",
"description": "The settlement network."
},
"asset": {
"type": [
"string",
"null"
],
"description": "The asset: a symbol, or the token address where the rail names no symbol."
},
"amountAtomic": {
"type": "string",
"description": "The merchant's price per call, in atomic units. It EXCLUDES the Router's routing fee, which the delegation cap is also charged; POST /api/v1/router/quote returns the total."
},
"decimals": {
"type": [
"number",
"null"
]
},
"observedAt": {
"type": "string",
"format": "date-time",
"description": "When the 402 this quote was read from was observed. Shown for 48 h."
},
"variable": {
"type": "boolean",
"description": "The price depends on the request; see range and driver."
},
"range": {
"$ref": "#/$defs/CatalogEndpointQuoteRangeDto"
},
"driver": {
"type": "string",
"description": "The request field that drives a variable price."
},
"offers": {
"description": "OWNER READ ONLY (GET /api/v1/catalog/mine): every rail and network the 402 offered, the selected one marked. Never present on a public read.",
"type": "array",
"items": {
"$ref": "#/$defs/CatalogEndpointQuoteOfferDto"
}
}
},
"required": [
"rail",
"intent",
"network",
"asset",
"amountAtomic",
"decimals",
"observedAt",
"variable"
]
},
"CatalogEndpointQuoteOfferDto": {
"type": "object",
"properties": {
"rail": {
"type": "string",
"enum": [
"x402",
"mpp"
]
},
"network": {
"type": "string"
},
"intent": {
"type": "string"
},
"asset": {
"type": "string"
},
"amountAtomic": {
"type": "string"
},
"selected": {
"type": "boolean",
"description": "Present (true) on the offer the Router would pay."
}
},
"required": [
"rail",
"network"
]
},
"CatalogEndpointQuoteRangeDto": {
"type": "object",
"properties": {
"minAtomic": {
"type": "string"
},
"maxAtomic": {
"type": "string"
}
},
"required": [
"minAtomic",
"maxAtomic"
]
},
"CatalogFeatureDto": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"title"
]
},
"CatalogProvenanceDto": {
"type": "object",
"properties": {
"sourceRefs": {
"type": "array",
"description": "Where this listing came from. `mercator` is reserved (never emitted by this API yet).",
"items": {
"type": "string",
"enum": [
"bazaar",
"mpp.dev",
"seller",
"curated",
"mercator"
]
}
},
"integration": {
"type": "string",
"enum": [
"first-party",
"gateway"
]
}
},
"required": [
"sourceRefs",
"integration"
]
},
"CatalogRecipientDto": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"network": {
"type": "string"
# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/nevermined-app/json-schema/nevermined-app-owner-catalog-listing-dto-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/nevermined-app-owner-catalog-listing-dto"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.