402atlas.com

{
  "properties": {
    "confidence_summary": {
      "description": "Breakdown by evidence grade",
      "type": "object"
    },
    "free_resources": {
      "description": "Links to the free human-readable surfaces",
      "type": "object"
    },
    "meta": {
      "description": "Counts and the dataset cutoff date",
      "type": "object"
    },
    "reading_guide": {
      "description": "Read this first. Explains every field, including what we held back and why.",
      "type": "object"
    },
    "services_by_category": {
      "additionalProperties": {
        "items": {
          "properties": {
            "calls_kept_out_of_this_record": {
              "description": "Calls we paid for and did NOT publish, with the count and the reason. The omission is visible rather than silent.",
              "type": "object"
            },
            "coverage": {
              "description": "How much of that surface we bought — in both endpoint and capability-category terms.",
              "type": "object"
            },
            "declared_endpoints_that_could_not_be_paid": {
              "description": "Endpoints this host declares and prices but which would not take our payment. No receipt exists for these — that is the finding.",
              "items": {
                "type": "object"
              },
              "type": "array"
            },
            "domain": {
              "type": "string"
            },
            "endpoints_to_skip": {
              "description": "Present only when an endpoint on this otherwise-recommended host failed our check. Carries the endpoint, what went wrong and the receipt.",
              "items": {
                "type": "object"
              },
              "type": "array"
            },
            "evidence_grade": {
              "description": "Strength of OUR method, not a judgement of the service",
              "enum": [
                "A",
                "B",
                "C"
              ],
              "type": "string"
            },
            "health": {
              "description": "Per-record shortcut: problem count, whether the host was still answering payment challenges when we last measured, and a safe_default flag.",
              "type": "object"
            },
            "inference": {
              "description": "Present when our sample did not cover every capability category. Always states in words that the untested part is an inference, not a guarantee.",
              "type": "string"
            },
            "priceQuotedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "priceUsd": {
              "description": "Cheapest current quote across the tested endpoints, read off the seller own 402 challenge on priceQuotedAt. Null with a reason where no challenge answered.",
              "type": [
                "number",
                "null"
              ]
            },
            "result": {
              "description": "Mechanical roll-up over the published calls: ok / problem / transport_only.",
              "type": "object"
            },
            "surface": {
              "description": "How many payable endpoints this host declares, measured by us on as_of. total may be null with a reason; where it is, at_least gives a lower bound backed by receipts.",
              "type": "object"
            },
            "tested": {
              "description": "One element per endpoint we actually paid for. This is where the evidence lives.",
              "items": {
                "properties": {
                  "description": {
                    "description": "The seller's own description of THAT endpoint",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "description_source": {
                    "description": "Exact pointer into the seller document it came from",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "endpoint": {
                    "description": "Method + path as tested",
                    "type": "string"
                  },
                  "note": {
                    "description": "Why that verdict, in one sentence",
                    "type": "string"
                  },
                  "pay": {
                    "description": "network / asset / payTo / scheme, read off the seller own challenge",
                    "type": "object"
                  },
                  "priceUsd": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "request": {
                    "description": "The exact call that produced the response",
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "response": {
                    "description": "What came back. Full unless too large to reproduce, in which case response_excerpted appears alongside it.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "response_excerpted": {
                    "description": "Present only on oversized responses: excerpt size, original size, SHA-256 of the complete body, and either a link to the free public upstream it resells or the name of the file in our evidence archive.",
                    "type": "object"
                  },
                  "result": {
                    "description": "ok = delivered what it claimed; problem = paid and did not; transport-only = payment and shape verified but the content had no answer we could construct in advance",
                    "enum": [
                      "ok",
                      "problem",
                      "transport-only"
                    ],
                    "type": "string"
                  },
                  "tx": {
                    "description": "On-chain settlement hash for our payment",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "txUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "endpoint",
                  "result"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "verdict": {
              "description": "Every record here is verified by construction — a service that fails as a whole is absent. Filtering on this alone tells you nothing.",
              "enum": [
                "verified"
              ],
              "type": "string"
            }
          },
          "required": [
            "domain",
            "verdict",
            "tested",
            "result"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "description": "Category name → array of records. One record = one HOST.",
      "type": "object"
    },
    "total_services": {
      "description": "Number of hosts in this payload",
      "type": "integer"
    }
  },
  "required": [
    "reading_guide",
    "total_services",
    "services_by_category"
  ],
  "type": "object"
}