Maxwell International Doctor API

The doctor API from Maxwell International — 6 operation(s) for doctor.

GitHub OpenAPI

Operations 6

GET /v1/doctor/blocked x402 Doctor for a block you hit (e.g. #
GET /v1/doctor/buy Test-buy any x402 endpoint (USDC on Base, seller price up to $1). #
GET /v1/doctor/checkup x402 Doctor checkup of any x402 endpoint, without buying: whether it answers… #
POST /v1/doctor/payment x402 Doctor: why a payment failed, in plain words: the cause, whose side it is… #
GET /v1/doctor/report Retrieve a stored x402 Doctor report again by its id ($0.01): the full report… #
GET /v1/doctor/seller x402 Doctor checkup of your own endpoint: payment request, prices, payTo and… #

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/maxwellinternational-ai:maxwellinternational-ai-doctor-api"
All apis
curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

maxwellinternational-ai-doctor-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maxwell International Data (x402) Doctor API
  version: 1.0.0
  description: Machine-only pay-per-call data API over x402. Prices are per request in USDC.
  x-guidance: 'Pay-per-call data for ski trips and public records, plus x402 Doctor, which tests other x402 endpoints for you. Ski: a directory of about 6,000 ski resorts worldwide, lift-ticket prices for the resorts listed at /v1/ski/coverage, a model forecast for every resort (station readings where one of 11 European met services has a station), lift status and snow reports only at about 50 resorts with their own feed (in Poland, Slovakia, Switzerland, Liechtenstein and Friuli in Italy; only while current), insider tips, and the Trip Wizard (a free map, then one paid call per trip step). Food: restaurants around ski resorts in every country listed at /v1/food/coverage (free, with per-country counts), with opening hours, website and contacts where known. Menus and prices only where read (withMenu): in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland from the restaurant’s own website or, where none is published, a delivery app; in every other country only where a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl) lists the restaurant, as restaurants’ own websites are read for menus only in those 16 countries. Public data: SEC EDGAR, government registers and legislation of 13 countries and the EU, OFAC SDN, NVD CVEs, openFDA, NOAA weather (US), ECB FX, FRED, npm, RDAP domain records, crypto market quotes, US court opinions, US patents. Paid operations are GET, except doctor.payment and llm.chat (POST with a JSON body). Call one without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (x402 v2): USDC on Base (eip155:8453) or Solana, settled through the Coinbase CDP facilitator. Send the same request again with a PAYMENT-SIGNATURE header. You are charged only for a 2xx answer. Missing or ambiguous parameters get a free 400 or 409 and a request with no data on file a free 404, both with charged:false. A search that runs and finds nothing is a 2xx answer (match:false) and is charged. Most routes check parameters before asking for payment. A bare path (directory probes), ski.prices without country, gov.de legislation and open data, and a POST without the fields it needs get the 402 first; after payment a request that cannot be answered still gets a free 400 (ski.prices answers if the resort id is unique). food.menu without restaurantId is a free 404. Paid answers that can look empty: a search with no matches (match:false), an RDAP lookup of an unregistered domain (registered:false) or of a registry without RDAP (rdapAvailable:false), and gov.de legislation or open data without q or id (the index of what is cached). doctor.buy and llm.chat collect the payment before they run: doctor.buy charges for the attempt, delivered or not; if the llm.chat model fails after payment, the answer (HTTP 503, llm_failed_after_payment) says charged:true and the payment is refunded by hand. A lookup of one item that is not cached yet (CVE, accession, company number, coordinates) is usually queued: retry after retryAfterSec. Priced per request (x-payment-info mode dynamic, with min and max where there is one): doctor.buy, llm.chat, trip.bundle; the 402 quotes the exact amount. Every other product has one price. Each response carries fetchedAt or generatedAt. Forecasts refresh every 6 hours, and lift status every 15 minutes where the resort has a feed. Hand-checked lift-ticket prices were read from official price lists on Oct 7-9, 2026 (rechecks from Nov 8); the others come from a weekly crawl of the resort''s price pages or from an earlier collection (operator shops, price pages); every row has its source link and read date. Public records refresh on each source''s schedule (age per family at /health). Free status and coverage endpoints are listed at /catalog.json; terms at /terms.json. Free samples: most products have one real request you can call free to check the data first (freeSampleUrl in /catalog.json, x-free-sample here, freeSample in every 402): the same answer a buyer of that request gets.'
  contact:
    name: Maxwell International
    email: accounts@maxwellinternational.ai
    url: https://api.maxwellinternational.ai/terms.json
  termsOfService: https://api.maxwellinternational.ai/terms.json
servers:
- url: https://api.maxwellinternational.ai
tags:
- name: doctor
paths:
  /v1/doctor/blocked:
    get:
      operationId: doctor_blocked
      summary: x402 Doctor for a block you hit (e.g.
      description: 'x402 Doctor for a block you hit (e.g. 403): we request the seller ourselves and say whether the block is on your path (IP, region, bot wall) or on the seller side, with what each of us saw. We never buy around a block.'
      tags:
      - doctor
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: The x402 endpoint to check
        example: https://www.x402scan.com/api/x402/resources
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: The HTTP status you got
        example: '403'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/doctor/blocked?url=https%3A%2F%2Fwww.x402scan.com%2Fapi%2Fx402%2Fresources&status=403&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  product:
                    type: string
                  verdict:
                    type: string
                  explanation:
                    type: string
                  youSaw:
                    type: object
                    properties:
                      status:
                        type: integer
                  weSaw:
                    type: object
                    properties:
                      product:
                        type: string
                      verdict:
                        type: string
                      url:
                        type: string
                      paywall:
                        type: object
                        properties:
                          state:
                            type: string
                          problems:
                            type: array
                          x402Version:
                            type: integer
                      price:
                        type: array
                        items:
                          type: object
                          properties:
                            usd:
                              type: number
                            network:
                              type: string
                            asset:
                              type: string
                            scheme:
                              type: string
                            amount:
                              type: string
                            payTo:
                              type: string
                      payTo:
                        type: array
                        items:
                          type: string
                      latencyMs:
                        type: integer
                      evidence:
                        type: object
                        properties:
                          httpStatus:
                            type: integer
                          bodySha256:
                            type: string
                      checkedAt:
                        type: string
                  checkedAt:
                    type: string
              example:
                product: x402 Doctor
                verdict: client_problem
                explanation: We received a normal payment request. Your 403 did not. The block is on your …
                youSaw:
                  status: 403
                weSaw:
                  product: x402 Doctor
                  verdict: seller_up
                  url: https://www.x402scan.com/api/x402/resources
                  paywall:
                    state: ok_402
                    problems: []
                    x402Version: 2
                  price: []
                  payTo: []
                  latencyMs: 565
                  evidence:
                    httpStatus: 402
                    bodySha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
                  checkedAt: '2026-10-05T09:44:33.011Z'
                checkedAt: '2026-10-05T09:44:33.011Z'
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/doctor/buy:
    get:
      operationId: doctor_buy
      summary: Test-buy any x402 endpoint (USDC on Base, seller price up to $1).
      description: 'Test-buy any x402 endpoint (USDC on Base, seller price up to $1). Pass url and the seller price: you pay price + $0.01 + 10% (e.g. $0.05 costs $0.065), charged per attempt, delivered or not. Seller asks less: we buy at its price and keep the rest. Asks more: nothing bought, payment kept. No price: $0.01 lookup returns the exact price. Returns the seller answer, both receipts, a verdict and a report id.'
      tags:
      - doctor
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: The x402 endpoint to test-buy
        example: https://api.maxwellinternational.ai/v1/nvd/cve?id=CVE-2021-44228
      - name: price
        in: query
        required: false
        schema:
          type: string
        description: The seller price in USD (USDC on Base). Leave out to pay $0.01 for a lookup of the exact price.
        example: '0.005'
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.01'
          max: '1.11'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                  disclosure:
                    type: string
              example:
                verdict: delivered
                disclosure: You pay for the attempt.
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/doctor/checkup:
    get:
      operationId: doctor_checkup
      summary: 'x402 Doctor checkup of any x402 endpoint, without buying: whether it answers…'
      description: 'x402 Doctor checkup of any x402 endpoint, without buying: whether it answers with a valid payment request, its x402 version and any problems in it, the prices and networks it asks for, its payTo wallets and response time.'
      tags:
      - doctor
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: The x402 endpoint to check
        example: https://www.x402scan.com/api/x402/resources
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/doctor/checkup?url=https%3A%2F%2Fwww.x402scan.com%2Fapi%2Fx402%2Fresources&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  product:
                    type: string
                  verdict:
                    type: string
                  url:
                    type: string
                  paywall:
                    type: object
                    properties:
                      state:
                        type: string
                      problems:
                        type: array
                      x402Version:
                        type: integer
                  price:
                    type: array
                    items:
                      type: object
                      properties:
                        usd:
                          type: number
                        network:
                          type: string
                        asset:
                          type: string
                        scheme:
                          type: string
                        amount:
                          type: string
                        payTo:
                          type: string
                  payTo:
                    type: array
                    items:
                      type: string
                  latencyMs:
                    type: integer
                  evidence:
                    type: object
                    properties:
                      httpStatus:
                        type: integer
                      bodySha256:
                        type: string
                  checkedAt:
                    type: string
              example:
                product: x402 Doctor
                verdict: seller_up
                url: https://www.x402scan.com/api/x402/resources
                paywall:
                  state: ok_402
                  problems: []
                  x402Version: 2
                price:
                - usd: 0.01
                  network: eip155:8453
                  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  scheme: exact
                  amount: '10000'
                  payTo: '0x2EC4545f96A24876764bF2B04D54E66A1351bE71'
                payTo:
                - '0x2EC4545f96A24876764bF2B04D54E66A1351bE71'
                latencyMs: 271
                evidence:
                  httpStatus: 402
                  bodySha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
                checkedAt: '2026-10-05T09:44:33.323Z'
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/doctor/payment:
    post:
      operationId: doctor_payment
      summary: 'x402 Doctor: why a payment failed, in plain words: the cause, whose side it is…'
      description: 'x402 Doctor: why a payment failed, in plain words: the cause, whose side it is on (your client, your wallet, the network, the seller or the facilitator) and how to fix it, from over 40 named causes (x402 and Coinbase facilitator codes, EVM and Solana, HTTP and network errors). Send the seller 402 as challenge and the error as response, by POST JSON or GET query. Unknown failures are reviewed nightly.'
      tags:
      - doctor
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: []
              properties: {}
            example:
              url: https://example.com/api
              challenge: '402'
              response: '{"invalidReason":"invalid_exact_evm_payload_signature"}'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
              example:
                verdict: client_problem
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/doctor/report:
    get:
      operationId: doctor_report
      summary: 'Retrieve a stored x402 Doctor report again by its id ($0.01): the full report…'
      description: 'Retrieve a stored x402 Doctor report again by its id ($0.01): the full report of a test purchase, price lookup or cached result, exactly as first delivered. Only the wallet that paid for the original call can retrieve it; reports are kept permanently.'
      tags:
      - doctor
      parameters:
      - name: id
        in: query
        required: true
        schema:
          type: string
        description: reportId from a Doctor report
        example: dr_00000000000000000000000000000000
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/doctor/seller:
    get:
      operationId: doctor_seller
      summary: 'x402 Doctor checkup of your own endpoint: payment request, prices, payTo and…'
      description: 'x402 Doctor checkup of your own endpoint: payment request, prices, payTo and response time; once you prove you own the host (publish the token from /v1/doctor/verify at /.well-known/x402-doctor.txt), also a leak check: does it serve data without payment.'
      tags:
      - doctor
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: The x402 endpoint to check
        example: https://api.maxwellinternational.ai/v1/nvd/cve?id=CVE-2021-44228
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  ownership:
                    type: string
              example:
                ownership: proved
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)