{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aspern-org/json-schema/aspern-org-service-data-schema.json",
  "title": "ServiceData",
  "description": "Observed, not designed. This shape was derived by calling the operation and recording what came back, and it is re-derived and compared on every deploy. Types are what was seen. Fields listed under `required` are the ones this API commits to returning, declared by hand rather than inferred — everything else is what was observed, and an absent measurement is a real answer here rather than a fault. Required means present, never non-null.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aspern-org-openapi.json#/components/schemas/ServiceData",
  "type": "object",
  "required": [
    "data",
    "meta",
    "warnings"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "endpoint": {
          "type": "string"
        },
        "host": {
          "type": "string"
        },
        "declaredBy": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "owner": {
                "type": "string"
              },
              "agentId": {
                "type": "string"
              },
              "chain": {
                "type": "string"
              },
              "protocol": {
                "type": "string"
              },
              "declaredTools": {
                "type": "array"
              }
            }
          }
        },
        "latest": {
          "type": "object",
          "properties": {
            "day": {
              "type": "string"
            },
            "outcome": {
              "type": "string"
            },
            "latencyMs": {
              "type": "number",
              "x-unit": "seconds"
            },
            "httpStatus": {
              "type": "number"
            },
            "name": {
              "type": "string"
            },
            "version": {
              "type": "string"
            },
            "protocolVersion": {
              "type": "string"
            },
            "observed": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "history": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "day": {
                "type": "string"
              },
              "outcome": {
                "type": "string"
              },
              "latencyMs": {
                "type": "number",
                "x-unit": "seconds"
              },
              "httpStatus": {
                "type": "number"
              },
              "name": {
                "type": "string"
              },
              "version": {
                "type": "string"
              },
              "protocolVersion": {
                "type": "string"
              },
              "observed": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "drift": {
          "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
        },
        "says": {
          "type": "string"
        },
        "outcomes": {
          "type": "object",
          "properties": {
            "serving": {
              "type": "string"
            },
            "no-handshake": {
              "type": "string"
            },
            "not-a-card": {
              "type": "string"
            },
            "unreachable": {
              "type": "string"
            },
            "gated": {
              "type": "string"
            },
            "error": {
              "type": "string"
            }
          }
        },
        "check": {
          "type": "string"
        },
        "limits": {
          "type": "string"
        },
        "price": {
          "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
        },
        "measured": {
          "type": "object",
          "properties": {
            "evidence": {
              "type": "string"
            },
            "days": {
              "type": "number",
              "x-unit": "days"
            },
            "serving": {
              "type": "number"
            },
            "outcomeCounts": {
              "type": "object",
              "properties": {
                "serving": {
                  "type": "number"
                }
              }
            },
            "latencyMsMedian": {
              "type": "number",
              "x-unit": "decimal-fraction"
            },
            "latencyMsWorst": {
              "type": "number"
            },
            "firstRead": {
              "type": "string"
            },
            "lastRead": {
              "type": "string"
            },
            "says": {
              "type": "string"
            }
          }
        },
        "handshake": {
          "type": "string"
        },
        "unpaidProbe": {
          "type": "object",
          "properties": {
            "outcome": {
              "type": "string"
            },
            "probedAt": {
              "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
            },
            "httpStatus": {
              "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
            },
            "latencyMs": {
              "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
            },
            "quoted": {
              "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
            },
            "detail": {
              "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
            },
            "says": {
              "type": "string"
            }
          }
        },
        "manifest": {
          "type": "object",
          "properties": {
            "hash": {
              "type": "string"
            },
            "tools": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "protocolVersion": {
              "type": "string"
            },
            "firstSeen": {
              "type": "string"
            },
            "lastSeen": {
              "type": "string"
            },
            "days": {
              "type": "number",
              "x-unit": "days"
            },
            "says": {
              "type": "string"
            }
          }
        },
        "changes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "at": {
                "type": "string"
              },
              "added": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "removed": {
                "type": "array"
              },
              "protocolVersion": {
                "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
              },
              "from": {
                "type": "string"
              },
              "to": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    },
    "warnings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Warning"
      }
    }
  },
  "$defs": {
    "Meta": {
      "type": "object",
      "required": [
        "requestId",
        "snapshotId",
        "servedAt",
        "methodologyVersion",
        "coverage"
      ],
      "properties": {
        "requestId": {
          "type": "string",
          "description": "Also the X-Request-Id header."
        },
        "environment": {
          "type": "string",
          "description": "production, staging or development. Also the X-ASPERN-Environment header and info.x-aspern-environment in the OpenAPI document, so a client can tell which contract answered."
        },
        "build": {
          "type": [
            "string",
            "null"
          ],
          "description": "The deploy that served this. Also the X-ASPERN-Build header."
        },
        "snapshotId": {
          "type": "string",
          "description": "Which state of our data answered. Two responses with the same snapshotId saw the same completed ingest runs — so a figure that differs between two surfaces under the SAME snapshot is a defect, and under different ones is a clock."
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When the source was observed."
        },
        "computedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When we computed this from it."
        },
        "servedAt": {
          "type": "string",
          "format": "date-time",
          "description": "When this response was built."
        },
        "methodologyVersion": {
          "type": "string",
          "description": "What the figures mean. Changes are listed at /changelog."
        },
        "source": {
          "type": [
            "string",
            "null"
          ]
        },
        "chainId": {
          "type": [
            "integer",
            "null"
          ],
          "x-unit": "chain-id"
        },
        "blockNumber": {
          "type": [
            "integer",
            "null"
          ],
          "x-unit": "block-number"
        },
        "coverage": {
          "type": "object",
          "properties": {
            "scope": {
              "type": [
                "string",
                "null"
              ],
              "description": "What this covers and, explicitly, what it does not."
            },
            "population": {
              "type": [
                "string",
                "null"
              ],
              "description": "The population these figures were measured over, as a key you can join on rather than a sentence you have to read. Every key is declared once and resolves to a definition at /reconciliation#<key>, where the ones that narrow show every row that falls out and why. The same key appears beside the figure on the website, so an integrator and a reader are talking about one population rather than two descriptions of it. Null only when `populationAbsence` says why."
            },
            "populationAbsence": {
              "type": [
                "string",
                "null"
              ],
              "description": "Why there is no single population, where there is none. A lookup of one address measures nothing; a document carrying several rails in units that are never summed carries several populations. A null population with nothing here would be an absence you could not tell from an oversight, which is the defect this field exists to close."
            },
            "knownExclusions": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              },
              "description": "THREE VALUES. A list is what this route deliberately leaves out. `[]` is a CLAIM that nothing is excluded. `null` is “we have not said”, which is our gap and must never be read as the second. It was hardcoded to `[]` on every route until 2026-09-27, so every response claimed to exclude nothing while its own `scope` sentence named exclusions."
            }
          }
        },
        "confidence": {
          "type": [
            "object",
            "null"
          ],
          "description": "Never a bare number; it names what it is a confidence in."
        },
        "freshness": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "oldestObservedAt",
                "newestObservedAt",
                "readings",
                "fields",
                "complete",
                "state",
                "newestAgeHours"
              ],
              "description": "When the readings behind this answer were taken, where they differ. A page of a hundred vaults read over four hours has no single observation time — `observedAt` is filled in only where every reading agrees, and this reports the spread otherwise.",
              "properties": {
                "oldestObservedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "newestObservedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "readings": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "How many readings the range was taken over.",
                  "x-unit": "count"
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The fields it was read from, so a caller can go and check any of them directly."
                },
                "complete": {
                  "type": "boolean",
                  "description": "Whether every reading in the payload was seen. False means the range is a LOWER BOUND — the true spread is at least this wide and may be wider — because a partial walk always returns the narrower range, which would read as fresher and more uniform than the data is."
                },
                "state": {
                  "enum": [
                    "fresh",
                    "mixed",
                    "stale"
                  ],
                  "description": "`stale` when the NEWEST reading is more than 26 hours old at the moment the response was built — every reader runs at least daily, so that means a reader has stopped. `mixed` when the newest is inside that window and the OLDEST is not: parts of this answer are current and parts are not, which is the usual shape of a document joining several sources. It was summarised as `fresh` until 2026-10-10, computed from the newest reading alone, so one current field hid a catalogue two months old. A source that could not be read is not a state here: it is a check that could not run (`/v1/checks`) or an analysis whose `availability` says so, and never a zero."
                },
                "newestAgeHours": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Hours between the newest reading and the moment this response was built, to one decimal.",
                  "x-unit": "hours"
                },
                "oldestAgeHours": {
                  "type": "number",
                  "minimum": 0,
                  "description": "The same for the OLDEST reading. The other end of the spread as a number, because a caller comparing two ISO strings to find out whether part of an answer is two months old will mostly not bother.",
                  "x-unit": "hours"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "reason",
                "state",
                "says",
                "readings"
              ],
              "description": "No range, and which of the two reasons it is.",
              "properties": {
                "reason": {
                  "enum": [
                    "not-applicable",
                    "no-dated-field"
                  ],
                  "description": "`not-applicable` is reference material: a plan, a capability list, a schema. Nothing in it was read from anywhere at a time. `no-dated-field` means the response carries data and nothing in it names when that data was read, which is a gap in that endpoint."
                },
                "state": {
                  "enum": [
                    "not_applicable",
                    "not_measured"
                  ],
                  "description": "The reason in the vocabulary shared with `fresh`/`stale`: `not-applicable` is `not_applicable`, `no-dated-field` is `not_measured`."
                },
                "says": {
                  "type": "string",
                  "description": "The same thing in a sentence."
                },
                "readings": {
                  "const": 0
                }
              }
            }
          ]
        },
        "pagination": {
          "anyOf": [
            {
              "$ref": "#/$defs/Page"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "Page": {
      "type": "object",
      "required": [
        "total",
        "limit",
        "offset",
        "hasMore"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "minimum": 0,
          "description": "Rows matching the filter, not rows returned.",
          "x-unit": "count"
        },
        "limit": {
          "type": "integer",
          "minimum": 0,
          "description": "Applied page size. May be below what was asked — X-Page-Limit says so when it is.",
          "x-unit": "count"
        },
        "offset": {
          "type": "integer",
          "minimum": 0,
          "x-unit": "count"
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextOffset": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null on the last page.",
          "x-unit": "count"
        },
        "orderedBy": {
          "type": "string",
          "description": "The sort, including its tie-breaker. The order is total, so paging cannot show a row twice or skip one."
        }
      }
    },
    "Warning": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}