{
  "version": "1.0",
  "as_of": "2026-09-15T00:00:00Z",
  "dataset_version": "coldchain-v1",
  "routes": [
    {
      "method": "GET",
      "path": "/v1/orders",
      "query": [
        "hub",
        "service",
        "cohort",
        "as_of",
        "cursor",
        "limit"
      ],
      "limit": {
        "min": 1,
        "max": 100
      },
      "response": [
        "items",
        "total",
        "next_cursor",
        "as_of",
        "dataset_version",
        "updated_at"
      ],
      "errors": [
        400,
        401,
        403,
        409,
        429,
        503
      ]
    },
    {
      "method": "GET",
      "path": "/v1/orders/{order_id}/events",
      "response": [
        "events",
        "visible_at_cutoff"
      ],
      "errors": [
        401,
        403,
        404,
        503
      ]
    },
    {
      "method": "GET",
      "path": "/v1/metrics",
      "response": [
        "eligible",
        "late",
        "by_hub",
        "by_service",
        "sample_status"
      ],
      "errors": [
        400,
        401,
        403,
        409,
        503
      ]
    },
    {
      "method": "POST",
      "path": "/v1/exports",
      "roles": [
        "supervisor",
        "service"
      ],
      "body": [
        "scope",
        "as_of",
        "dataset_version",
        "request_key"
      ],
      "accepted_status": 202,
      "errors": [
        400,
        401,
        403,
        409,
        429,
        503
      ]
    }
  ]
}