{"openapi":"3.1.0","info":{"title":"On the Bench","version":"1.3.0","description":"Ratios require an identical protocol pair, hardware, architecture, metric definition, clean harness commit, recorded mock digest, and metric-specific workload. Missing evidence never matches missing evidence. These are observed gateway measurements against a local mock, not a claim about model latency or statistical significance. Start with /api/v1/summary for bounded retrieval. Full evidence can exceed 4 MB. Actual publication time is unknown when published_at is null; generated_at is build time. Dynamic filters reject unknown and repeated parameters."},"servers":[{"url":"https://onthebench.ai"}],"components":{"schemas":{"ActiveField":{"type":"object","properties":{"id":{"type":"string"},"engine_commit":{"type":"string"},"started_at":{"type":"string"},"gateways":{"type":"array","items":{"type":"string"}}},"required":["id","engine_commit","started_at","gateways"]},"Trend":{"type":"object","properties":{"tolerance_percent":{"const":5},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"state":{"enum":["improved","regressed","flat","not_comparable"]},"symbol":{"type":"string"},"label":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"previous_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["tolerance_percent","change_percent","state","symbol","label"]},"HistoryPoint":{"type":"object","properties":{"run_id":{"type":"string"},"measurement_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"gateway_id":{"type":"string"},"gateway_build":{"anyOf":[{"type":"string"},{"type":"null"}]},"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"engine":{"anyOf":[{"type":"string"},{"type":"null"}]},"metric":{"type":"string"},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"state":{"type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"definition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"type":"string"},"trend":{"$ref":"#/components/schemas/Trend"},"provenance":{"type":"object","properties":{"run_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["run_url"]}},"required":["run_id","gateway_id","gateway_build","measured_at","engine","value","state","disposition","provenance"]},"HistoryComparison":{"type":"object","properties":{"metric":{"type":"string"},"before":{"anyOf":[{"type":"number"},{"type":"null"}]},"after":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["comparable","incomparable","insufficient_evidence"]},"reasons":{"type":"array","items":{"type":"string"}},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"$ref":"#/components/schemas/Trend"}},"required":["metric","before","after","status","reasons","change_percent","trend"]},"HistoryPage":{"type":"object","properties":{"schema_version":{"type":"string"},"catalog_id":{"type":"string"},"projector":{"type":"string"},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"returned":{"type":"number"},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"array","items":{"type":"string"}},"definitions":{"type":"object","additionalProperties":{"type":"string"}},"summary":{"anyOf":[{"$ref":"#/components/schemas/HistorySummary"},{"type":"null"}]},"points":{"type":"array","items":{"$ref":"#/components/schemas/HistoryPoint"}},"comparisons":{"type":"array","items":{"$ref":"#/components/schemas/HistoryComparison"}}},"required":["schema_version","catalog_id","projector","total","limit","offset","returned","next","metrics","definitions","points","comparisons"]},"HistorySummary":{"type":"object","properties":{"ingress":{"type":"string"},"egress":{"type":"string"},"from":{"type":"object"},"to":{"anyOf":[{"type":"object"},{"type":"null"}]},"engine_changed":{"type":"boolean"},"readings":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"bound":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"type":"string"},"before":{"anyOf":[{"type":"number"},{"type":"null"}]},"after":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"anyOf":[{"type":"object"},{"type":"null"}]},"rank_before":{"anyOf":[{"type":"object"},{"type":"null"}]},"rank_after":{"anyOf":[{"type":"object"},{"type":"null"}]}},"required":["metric","bound","label","before","after","change_percent","trend","rank_before","rank_after"]}}},"required":["ingress","egress","from","to","engine_changed","readings"]},"FieldLink":{"type":"object","properties":{"field_id":{"type":"string"},"dataset_id":{"type":"string"},"name":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string"}},"required":["field_id","dataset_id","name","published_at","url"]},"FieldPage":{"type":"object","properties":{"schema_version":{"type":"string"},"total":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"type":"number"},"offset":{"type":"number"},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FieldLink"}}},"required":["schema_version","total","limit","offset","next","fields"]},"FieldManifest":{"type":"object","properties":{"schema_version":{"type":"string"},"field_id":{"type":"string"},"dataset_id":{"type":"string"},"roster":{"type":"array","items":{"type":"string"}},"selected_measurements":{"type":"array","items":{"type":"object","properties":{"gateway_id":{"type":"string"},"measurement_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"ingress":{"type":"string"},"egress":{"type":"string"}},"required":["gateway_id","measurement_id","run_id","ingress","egress"]}},"comparison_policy":{"$ref":"#/components/schemas/Policy"},"measured_range":{"anyOf":[{"type":"object","properties":{"earliest":{"anyOf":[{"type":"string"},{"type":"null"}]},"latest":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["earliest","latest"]},{"type":"null"}]}},"required":["schema_version","field_id","dataset_id","roster","selected_measurements","comparison_policy","measured_range"]},"Releases":{"type":"object","properties":{"schema_version":{"type":"string"},"limit":{"type":"number"},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"releases":{"type":"array","items":{"$ref":"#/components/schemas/FieldLink"}}},"required":["schema_version","releases"]},"FieldRankings":{"type":"object","properties":{"schema_version":{"type":"string"},"field_id":{"type":"string"},"metric":{"type":"string"},"ingress":{"type":"string"},"egress":{"type":"string"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}]},"rostered":{"type":"number"},"excluded":{"type":"array","items":{"type":"object","properties":{"gateway_id":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["gateway_id","reasons"]}},"groups":{"type":"array","items":{"type":"object","properties":{"group":{"type":"number"},"eligible":{"type":"number"},"rankings":{"type":"array","items":{"type":"object","properties":{"gateway_id":{"type":"string"},"value":{"type":"number"},"rank":{"type":"number"},"measurement_id":{"type":"string"},"run_id":{"type":"string"}},"required":["gateway_id","value","rank","measurement_id","run_id"]}}},"required":["group","eligible","rankings"]}},"interpretation":{"type":"string"}},"required":["schema_version","field_id","metric","ingress","egress","direction","rostered","excluded","groups","interpretation"]},"JsonValue":{"description":"Version-specific JSON from the recorded instrument; consult its pinned source.","anyOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"Freshness":{"type":"object","properties":{"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Release timestamp recorded when publishing begins; not the first publication of historical measurements. Null for local builds or older unrecorded releases."},"age_days":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"age_as_of":{"type":"string"},"age":{"type":"string","description":"Human-readable measurement age relative to age_as_of, not request time."}},"required":["measured_at"]},"MetricState":{"type":"string","enum":["valid","below_resolution","bound_not_met","not_measured","not_configured","untestable","rig_limited","search_exhausted","harness_error","not_served","mock_bound","unverifiable"]},"Retrieval":{"type":"object","properties":{"start_here":{"type":"string"},"next_step":{"type":"string"},"measurements_max_response_bytes":{"const":1048576},"full_collection_bytes":{"type":"integer","minimum":0},"full_collection_use":{"type":"string"},"license":{"type":"string"}},"required":["start_here","next_step","measurements_max_response_bytes","full_collection_bytes","full_collection_use","license"]},"Disclosure":{"type":"object","properties":{"operator":{"type":"string"},"operator_is_entrant":{"type":"boolean"}},"required":["operator","operator_is_entrant"]},"Policy":{"type":"object","properties":{"id":{"type":"string"},"description":{"type":"string"}},"required":["id","description"]},"CurrentMetadata":{"type":"object","properties":{"stars":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"stars_as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"first_commit":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["stars","stars_as_of","first_commit"]},"CellState":{"type":"string","enum":["served","not_configured","not_declared","untestable","unprobed_auth","not_served","not_verified","not_measured"],"description":"served: passed; not_configured: probe did not complete correctly; not_declared: historical capability research, not a probe; untestable: harness limitation; unprobed_auth: authentication not tested; not_served: recorded refusal/failure; not_verified: inconclusive harness evidence; not_measured: no measurement. raw_state preserves the instrument token."},"Status":{"type":"object","properties":{"state":{"$ref":"#/components/schemas/CellState"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"raw_state":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"null"}]},"evidence_scope":{"type":"string"},"probe_http_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"response_excerpt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["state","reason","detail"]},"Metric":{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"state":{"$ref":"#/components/schemas/MetricState","description":"Only valid values are quantitative evidence; retain the reason for every absence."},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"definition":{"anyOf":[{"type":"string"},{"type":"null"}]},"definition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"section":{"type":"string"},"certified":{"type":"boolean"},"suppressed":{"type":"boolean"},"note":{"type":"string"}},"required":["value","state","reason"]},"Provenance":{"type":"object","properties":{"source_url":{"type":"string"},"raw_result_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"run_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"methodology_url":{"type":"string"},"raw_sha256":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source_url","raw_result_url","run_url","methodology_url","raw_sha256"]},"ProtocolPair":{"type":"object","properties":{"ingress_protocol":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"upstream_protocol":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]}},"required":["ingress_protocol","upstream_protocol"]},"TestConfiguration":{"type":"object","properties":{"ingress_protocol":{"type":"string"},"upstream_protocol":{"type":"string"},"hardware":{"anyOf":[{"type":"string"},{"type":"null"}]},"architecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"harness_commit":{"anyOf":[{"type":"string"},{"type":"null"}]},"harness_dirty":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"mock_sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"load_generator_sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"qualification":{"anyOf":[{"$ref":"#/components/schemas/JsonValue"},{"type":"null"}]},"definitions":{"type":"object","additionalProperties":{"type":"string"}},"definition_ids":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"sweep_duration_s":{"anyOf":[{"type":"number"},{"type":"null"}]},"sweep_ttft_ms":{"anyOf":[{"type":"number"},{"type":"null"}]},"memory_protocol":{"anyOf":[{"type":"string"},{"type":"null"}]},"memory_concurrency":{"anyOf":[{"type":"number"},{"type":"null"}]},"memory_load_s":{"anyOf":[{"type":"number"},{"type":"null"}]},"cost_concurrency":{"anyOf":[{"type":"number"},{"type":"null"}]},"somaxconn":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Engine v1.1: the box's effective net.core.somaxconn, recorded only when readable."},"tcp_max_syn_backlog":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Engine v1.1: the box's effective net.ipv4.tcp_max_syn_backlog, recorded only when readable."},"gateway_provenance":{"description":"Engine v1.1: the source-built gateway binary's build receipt, copied verbatim; absent for image gateways and older runs.","anyOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"upstream_transport":{"type":"string","enum":["tls","http"],"description":"Engine v1.2: how the gateway reached the mock for this cell, as recorded by the engine; tls means the upstream hop was HTTPS and its cost is inside the reported latency. Absent before v1.2 or when the engine could not tell."}},"required":["ingress_protocol","upstream_protocol","hardware","architecture","harness_commit","harness_dirty","mock_sha256","load_generator_sha256","qualification","definitions","sweep_duration_s","sweep_ttft_ms","memory_protocol","memory_concurrency","memory_load_s","cost_concurrency"]},"Frontier":{"type":"object","properties":{"bound_ms":{"anyOf":[{"type":"number"},{"type":"null"}]},"concurrency":{"anyOf":[{"type":"number"},{"type":"null"}]},"lower_bound":{"type":"boolean"},"p99_us":{"anyOf":[{"type":"number"},{"type":"null"}]},"samples":{"type":"number","description":"Engine v1.1: successful requests in the winning window, the population p99_us was taken over. Absent on older runs."},"rps":{"anyOf":[{"$ref":"#/components/schemas/Metric"},{"type":"null"}]}},"required":["rps"]},"Measurement":{"allOf":[{"$ref":"#/components/schemas/Freshness"},{"type":"object","properties":{"schema_version":{"const":"1.0"},"measurement_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"gateway_id":{"type":"string"},"gateway_build":{"anyOf":[{"type":"string"},{"type":"null"}]},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Release timestamp recorded when publishing begins; not the first publication of historical measurements. Null for local builds or older unrecorded releases."},"age_days":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"age_as_of":{"type":"string"},"age":{"type":"string","description":"Human-readable measurement age relative to age_as_of, not request time."},"status":{"$ref":"#/components/schemas/Status"},"test":{"$ref":"#/components/schemas/TestConfiguration"},"metrics":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Metric"}},"frontier":{"type":"array","items":{"$ref":"#/components/schemas/Frontier"}},"sample_counts":{"type":"object","additionalProperties":{"type":"number"},"description":"Engine v1.1 sample counts behind the percentiles, keyed by the engine's field names (gateway_c1_samples, direct_c1_samples, ttft_gw_samples, ttft_direct_samples, gap_gw_samples, gap_direct_samples). Present only when recorded."},"stream_rung_diagnostics":{"type":"array","items":{"type":"object","properties":{"conc":{"anyOf":[{"type":"number"},{"type":"null"}]},"http_status_counts":{"type":"object","additionalProperties":{"type":"number"}},"stream_errors_no_response":{"type":"number"}},"required":["conc"]},"description":"Engine v1.1 per stream-sweep rung: lanes per HTTP status and lanes that received no response. Present only when recorded."},"provenance":{"$ref":"#/components/schemas/Provenance"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","measurement_id","gateway_id","gateway_build","run_id","measured_at","status","test","metrics","frontier","provenance","disclosure"]}]},"GatewayLink":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"json_url":{"type":"string"},"current_metadata":{"$ref":"#/components/schemas/CurrentMetadata"}},"required":["id","name","url","json_url","current_metadata"]},"Catalog":{"type":"object","properties":{"schema_version":{"type":"string"},"gateways":{"type":"array","items":{"$ref":"#/components/schemas/GatewayLink"}},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","gateways","disclosure"]},"Discovery":{"type":"object","properties":{"schema_version":{"type":"string"},"retrieval":{"$ref":"#/components/schemas/Retrieval"},"links":{"type":"object","additionalProperties":{"type":"string"}},"comparison_policy":{"$ref":"#/components/schemas/Policy"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","retrieval","links","comparison_policy","disclosure"]},"RunReviews":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/RunReview"}},"RouteProbeReport":{"type":"object","properties":{"image":{"type":"string"},"checked_at":{"type":"string"},"responses":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"status":{"type":"integer","minimum":100,"maximum":599},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"body_sha256":{"type":"string"},"body_start":{"type":"string"}},"required":["path","status","content_type","body_sha256","body_start"]}}},"required":["image","checked_at","responses"]},"RunReview":{"type":"object","properties":{"gateway":{"type":"string"},"reviewed_at":{"type":"string"},"excluded_ingress":{"type":"array","items":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]}},"reason":{"type":"string"},"evidence":{"type":"string"}},"required":["gateway","reviewed_at","excluded_ingress","reason","evidence"]},"Run":{"type":"object","properties":{"review":{"$ref":"#/components/schemas/RunReview"},"id":{"type":"string"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"gateway_id":{"type":"string"},"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"build":{"anyOf":[{"type":"string"},{"type":"null"}]},"gateway_family":{"type":"string"},"evidence_available":{"type":"boolean"},"disposition":{"type":"string"},"engine":{"anyOf":[{"type":"string"},{"type":"null"}]},"available_metrics":{"type":"array","items":{"type":"string"}},"measurements_url":{"type":"string"}},"required":["id","gateway_id","measured_at","build"]},"RunResource":{"allOf":[{"$ref":"#/components/schemas/Run"},{"type":"object","properties":{"schema_version":{"type":"string"},"raw_result_url":{"type":"string"},"source_url":{"type":"string"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","raw_result_url","source_url","disclosure"]}]},"RawRun":{"type":"object","properties":{"gateway":{"type":"string"},"build":{"anyOf":[{"type":"string"},{"type":"null"}]},"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"matrix":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonValue"}},"rig":{"$ref":"#/components/schemas/JsonValue"},"definitions":{"type":"object","additionalProperties":{"type":"string"}}},"required":["gateway","matrix"]},"Gateway":{"type":"object","properties":{"key":{"type":"string"},"display":{"type":"string"},"lang":{"type":"string"},"repo":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"$ref":"#/components/schemas/JsonValue"},"stars":{"anyOf":[{"type":"number"},{"type":"null"}],"deprecated":true,"description":"Legacy alias for current_metadata.stars, not stars at measurement time."},"stars_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"deprecated":true},"matrix":{"$ref":"#/components/schemas/JsonValue"},"current":{"type":"boolean"}},"required":["key"]},"GatewayEvidence":{"type":"object","properties":{"schema_version":{"type":"string"},"gateway":{"$ref":"#/components/schemas/Gateway"},"current_metadata":{"$ref":"#/components/schemas/CurrentMetadata"},"metadata_scope":{"type":"string"},"measurements":{"type":"array","items":{"$ref":"#/components/schemas/Measurement"}},"history":{"type":"array","items":{"$ref":"#/components/schemas/Run"}},"generated_at":{"type":"string"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","gateway","measurements","history","disclosure"]},"EvidenceCollection":{"type":"object","properties":{"schema_version":{"type":"string"},"collection_kind":{"const":"independent_gateway_runs"},"dataset_id":{"type":"string"},"measurements":{"type":"array","items":{"$ref":"#/components/schemas/Measurement"}},"comparison_policy":{"$ref":"#/components/schemas/Policy"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","collection_kind","dataset_id","measurements","comparison_policy","disclosure"]},"LatestCollection":{"allOf":[{"$ref":"#/components/schemas/EvidenceCollection"},{"type":"object","properties":{"active_field":{"anyOf":[{"$ref":"#/components/schemas/ActiveField"},{"type":"null"}]},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"measured_range":{"type":"object","properties":{"earliest":{"anyOf":[{"type":"string"},{"type":"null"}]},"latest":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["earliest","latest"]},"metadata_as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"archive_history_included":{"type":"boolean"},"source_url":{"type":"string"},"immutable_url":{"type":"string"},"gateways":{"type":"array","items":{"$ref":"#/components/schemas/GatewayLink"}},"metrics":{"type":"array","items":{"type":"string"}}},"required":["active_field","generated_at","published_at","measured_range","metadata_as_of","license","archive_history_included","source_url","immutable_url","gateways","metrics"]}]},"BenchmarkResource":{"anyOf":[{"$ref":"#/components/schemas/EvidenceCollection"},{"$ref":"#/components/schemas/RunResource"}]},"Definitions":{"type":"object","properties":{"schema_version":{"type":"string"},"dataset_id":{"type":"string"},"definitions":{"type":"object","additionalProperties":{"type":"string"}}},"required":["schema_version","dataset_id","definitions"]},"RunPage":{"type":"object","properties":{"schema_version":{"type":"string"},"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"runs":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Run"},{"type":"object","properties":{"gateway_family":{"type":"string"},"raw_result_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string"}},"required":["gateway_family","raw_result_url","source_url"]}]}}},"required":["schema_version","total","limit","offset","next","runs"]},"MeasurementPage":{"type":"object","properties":{"schema_version":{"type":"string"},"dataset_id":{"type":"string"},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"total":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"returned":{"type":"integer","minimum":0},"max_response_bytes":{"const":1048576},"request_url":{"type":"string"},"applied_filters":{"type":"object","additionalProperties":{"type":"string"}},"next":{"anyOf":[{"type":"string"},{"type":"null"}]},"measurements":{"type":"array","items":{"$ref":"#/components/schemas/Measurement"}},"definitions":{"type":"object","additionalProperties":{"type":"string"}}},"required":["schema_version","dataset_id","total","offset","limit","returned","max_response_bytes","request_url","applied_filters","next","measurements"]},"CompactResult":{"allOf":[{"$ref":"#/components/schemas/Freshness"},{"type":"object","properties":{"gateway_id":{"type":"string"},"name":{"type":"string"},"gateway_build":{"anyOf":[{"type":"string"},{"type":"null"}]},"measured_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Release timestamp recorded when publishing begins; not the first publication of historical measurements. Null for local builds or older unrecorded releases."},"age_days":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"age_as_of":{"type":"string"},"age":{"type":"string","description":"Human-readable measurement age relative to age_as_of, not request time."},"current_metadata":{"$ref":"#/components/schemas/CurrentMetadata"},"status":{"$ref":"#/components/schemas/Status"},"metrics":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Metric"}},"provenance":{"$ref":"#/components/schemas/Provenance"},"evidence_url":{"type":"string"}},"required":["gateway_id","name","gateway_build","measured_at","generated_at","published_at","age_days","age_as_of","age","current_metadata","status","metrics","provenance","evidence_url"]}]},"Summary":{"type":"object","properties":{"active_field":{"anyOf":[{"$ref":"#/components/schemas/ActiveField"},{"type":"null"}]},"schema_version":{"type":"string"},"definitions":{"type":"object","additionalProperties":{"type":"string"}},"dataset_id":{"type":"string"},"generated_at":{"type":"string"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"selected_protocol_pair":{"$ref":"#/components/schemas/ProtocolPair"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CompactResult"}},"comparison_policy":{"$ref":"#/components/schemas/Policy"},"disclosure":{"$ref":"#/components/schemas/Disclosure"},"interpretation":{"type":"string"}},"required":["active_field","schema_version","definitions","dataset_id","generated_at","published_at","selected_protocol_pair","results","comparison_policy","disclosure","interpretation"]},"Comparison":{"type":"object","properties":{"comparison":{"type":"object","properties":{"gateway_a":{"type":"string"},"gateway_b":{"type":"string"},"ingress_protocol":{"type":"string"},"upstream_protocol":{"type":"string"},"metric":{"type":"string"},"bound_ms":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["gateway_a","gateway_b","ingress_protocol","upstream_protocol","metric"]},"comparability":{"type":"object","properties":{"status":{"enum":["comparable","incomparable","insufficient_evidence"]},"policy":{"type":"string"},"conditions_matched":{"type":"array","items":{"type":"string"}},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["status","policy","conditions_matched","reasons","warnings"]},"results":{"type":"object","properties":{"gateway_a":{"anyOf":[{"$ref":"#/components/schemas/Measurement"},{"type":"null"}]},"gateway_b":{"anyOf":[{"$ref":"#/components/schemas/Measurement"},{"type":"null"}]},"gateway_b_over_a":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["gateway_a","gateway_b","gateway_b_over_a"]},"interpretation":{"type":"object","properties":{"scope":{"type":"string"},"generalizable_to_real_model_latency":{"const":false},"statistical_significance":{"const":"not_established"}},"required":["scope","generalizable_to_real_model_latency","statistical_significance"]},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["comparison","comparability","results","interpretation","disclosure"]},"Methodology":{"type":"object","properties":{"schema_version":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"definitions":{"$ref":"#/components/schemas/JsonValue"},"comparison_policy":{"$ref":"#/components/schemas/Policy"},"disclosure":{"$ref":"#/components/schemas/Disclosure"}},"required":["schema_version","url","markdown","definitions","comparison_policy","disclosure"]},"SchemaIndex":{"type":"object","properties":{"schema_version":{"type":"string"},"schemas":{"type":"object","additionalProperties":{"type":"string"}},"states":{"type":"array","items":{"$ref":"#/components/schemas/MetricState"}},"metric_states":{"type":"array","items":{"$ref":"#/components/schemas/MetricState"}},"cell_states":{"type":"array","items":{"$ref":"#/components/schemas/CellState"}},"comparison_policy":{"$ref":"#/components/schemas/Policy"}},"required":["schema_version","schemas","states","metric_states","cell_states","comparison_policy"]},"Error":{"type":"object","properties":{"error":{"type":"string"},"status":{"type":"integer","enum":[400,404,413,500]}},"required":["error","status"]}}},"paths":{"/gateways/data.csv":{"get":{"operationId":"measurementCsv","description":"Compact CSV by default. Definitions are referenced by ID and immutable definitions_url. Prefer gateway-filtered exports; compact=0 explicitly requests verbose rows.","parameters":[{"name":"gateway","in":"query","required":false,"description":"Published gateway ID from /api/v1/gateways. Comparison a and b must differ.","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$"},"example":"busbar"},{"name":"ingress","in":"query","required":false,"description":"Client ingress protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"egress","in":"query","required":false,"description":"Upstream protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"metric","in":"query","required":false,"description":"Recorded metric key from latest.metrics, or throughput_rps. Comparison defaults to added_latency_p99_us; measurements return all metrics by default.","schema":{"type":"string","minLength":1},"example":"added_latency_p99_us"},{"name":"compact","in":"query","required":false,"description":"1 deduplicates definitions; 0 includes full text","schema":{"type":"string","enum":["0","1"],"default":"1"}}],"responses":{"200":{"description":"CSV measurements","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/gateways/{id}.md":{"get":{"operationId":"gatewayMarkdown","description":"Gateway evidence in Markdown. HTML is available without the suffix; use .txt for text/plain compatibility.","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"busbar"}],"responses":{"200":{"description":"Gateway evidence","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Unknown gateway"}}}},"/api/v1/schema/measurement.json":{"get":{"operationId":"measurementJsonSchema","description":"JSON Schema 2020-12 with concrete measurement properties and shared $defs.","responses":{"200":{"description":"JSON Schema document","content":{"application/json":{"schema":{"type":"object","required":["$schema","$id","$defs","$ref"],"properties":{"$schema":{"type":"string"},"$id":{"type":"string"},"$ref":{"type":"string"},"$defs":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}}}}}}}}}},"/api/v1/definitions/{id}":{"get":{"operationId":"immutableDefinitions","description":"Immutable definition catalog for a dataset ID referenced by compact CSV","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"dataset-c7c493902ee4473d65d1886e06f885af4adac2f4f5a4ea5fc70f2efa5f230c2f"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Definitions"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/definitions":{"get":{"operationId":"definitions","description":"Shared exact definition strings for compact CSV exports","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Definitions"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/history":{"get":{"operationId":"gatewayHistory","description":"Historical observations. Changes within inclusive ±5% are roughly unchanged; this is a display tolerance, not a statistical margin of error. Follow revision-pinned next links.","parameters":[{"name":"family","in":"query","required":false,"description":"Gateway family","schema":{"type":"string"},"example":"bifrost"},{"name":"ingress","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"},"example":"openai"},{"name":"egress","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"},"example":"openai"},{"name":"metric","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"},"example":"added_latency_p99_us"},{"name":"bound","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"catalog","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"a","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"b","in":"query","required":false,"description":"History filter; a and b select distinct run IDs","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum runs","schema":{"type":"integer","minimum":1,"maximum":100},"example":20},{"name":"offset","in":"query","required":false,"description":"Zero-based offset","schema":{"type":"integer","minimum":0},"example":0}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryPage"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/runs/{id}/measurements":{"get":{"operationId":"historicalMeasurements","description":"Bounded normalized measurements from one immutable raw run","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"run-busbar-16d2da7bc28375e55402b153f0f49b1550d5556f6ebb71eda60b8c3c47ad8d5f"},{"name":"limit","in":"query","required":false,"description":"Maximum records","schema":{"type":"integer","minimum":1,"maximum":100},"example":20},{"name":"offset","in":"query","required":false,"description":"Zero-based offset","schema":{"type":"integer","minimum":0},"example":0}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasurementPage"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fields":{"get":{"operationId":"fields","description":"Immutable published field selections and rosters","parameters":[{"name":"cursor","in":"query","required":false,"description":"Opaque retained-field pagination cursor; follow next","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum fields","schema":{"type":"integer","minimum":1,"maximum":100},"example":20}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldPage"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fields/{id}/rankings":{"get":{"operationId":"fieldRankings","description":"Rank within the recorded compatible field, never across incompatible engines","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"field-c8ed0c69830337d53ff6949a46780289eff55065dc0549a8463298922364e536"},{"name":"ingress","in":"query","required":false,"description":"Select protocol pair, metric and throughput bound","schema":{"type":"string"}},{"name":"egress","in":"query","required":false,"description":"Select protocol pair, metric and throughput bound","schema":{"type":"string"}},{"name":"metric","in":"query","required":false,"description":"Select protocol pair, metric and throughput bound","schema":{"type":"string"}},{"name":"bound","in":"query","required":false,"description":"Select protocol pair, metric and throughput bound","schema":{"type":"string"}}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldRankings"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fields/{id}":{"get":{"operationId":"field","description":"Exact roster and selected per-cell measurement identities","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"field-c8ed0c69830337d53ff6949a46780289eff55065dc0549a8463298922364e536"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldManifest"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/releases":{"get":{"operationId":"releases","description":"Named retained publications; metadata refreshes are not new benchmark runs","parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum releases","schema":{"type":"integer","minimum":1,"maximum":100},"example":20},{"name":"cursor","in":"query","required":false,"description":"Opaque next-page cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Releases"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/run-reviews.json":{"get":{"operationId":"runReviews","description":"Publication corrections keyed by SHA-256 of exact raw evidence. Corrections withhold invalid measurements without modifying retained raw bytes.","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunReviews"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reviews/{name}.json":{"get":{"operationId":"reviewEvidence","description":"Recorded direct HTTP probe evidence supporting a publication correction.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"example":"one-api-dashboard-probe-2026-11-08"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteProbeReport"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/runs":{"get":{"operationId":"runs","description":"Paginated immutable run catalog. family=busbar includes busbar, busbar-150 and busbar-151; gateway filters an exact historical ID.","parameters":[{"name":"gateway","in":"query","required":false,"description":"Exact historical gateway ID","schema":{"type":"string"},"example":"busbar-151"},{"name":"family","in":"query","required":false,"description":"Gateway family across versioned IDs","schema":{"type":"string"},"example":"busbar"},{"name":"limit","in":"query","required":false,"description":"Maximum runs per page","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"example":20},{"name":"offset","in":"query","required":false,"description":"Zero-based offset","schema":{"type":"integer","minimum":0,"default":0},"example":0}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunPage"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1":{"get":{"operationId":"discovery","description":"API links and interpretation policy","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Discovery"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/summary":{"get":{"operationId":"summary","description":"Compact core latency measurements for one selected protocol pair, with freshness and provenance; not a ranking.","parameters":[{"name":"gateway","in":"query","required":false,"description":"Published gateway ID from /api/v1/gateways. Comparison a and b must differ.","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$"},"example":"busbar"},{"name":"ingress","in":"query","required":false,"description":"Client ingress protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"egress","in":"query","required":false,"description":"Upstream protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Summary"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/gateways":{"get":{"operationId":"gateways","description":"Gateway catalog with dated repository metadata","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/gateways/{id}":{"get":{"operationId":"gateway","description":"Gateway measurements, history and legacy dashboard projection","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"busbar"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayEvidence"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/benchmarks/latest":{"get":{"operationId":"latest","description":"Large collection of independent runs; use summary or measurements for bounded retrieval","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestCollection"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/benchmarks/{id}":{"get":{"operationId":"benchmark","description":"Immutable collection (dataset-<sha256>) or run metadata (run-<gateway>-<sha256>)","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"dataset-c7c493902ee4473d65d1886e06f885af4adac2f4f5a4ea5fc70f2efa5f230c2f"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BenchmarkResource"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/measurements":{"get":{"operationId":"measurements","description":"Paginated evidence capped at 1 MiB UTF-8 JSON. returned can be less than limit; always follow next until null. Missing requested metrics remain absent.","parameters":[{"name":"gateway","in":"query","required":false,"description":"Published gateway ID from /api/v1/gateways. Comparison a and b must differ.","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$"},"example":"busbar"},{"name":"ingress","in":"query","required":false,"description":"Client ingress protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"egress","in":"query","required":false,"description":"Upstream protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"metric","in":"query","required":false,"description":"Recorded metric key from latest.metrics, or throughput_rps. Comparison defaults to added_latency_p99_us; measurements return all metrics by default.","schema":{"type":"string","minLength":1},"example":"added_latency_p99_us"},{"name":"compact","in":"query","required":false,"description":"Set to 1 to return definition_id references plus a shared definitions dictionary; default 1 deduplicates definitions; 0 retains self-contained evidence.","schema":{"type":"string","enum":["0","1"],"default":"1"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Maximum records per page","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"example":10},{"name":"offset","in":"query","required":false,"description":"Zero-based result offset","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"default":0},"example":0}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasurementPage"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"One measurement exceeds the 1 MiB response budget. Narrow the metric filter or use summary and raw evidence links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/compare":{"get":{"operationId":"compare","description":"Inspect comparability.status before citing a ratio. Full source measurements and provenance are preserved.","parameters":[{"name":"a","in":"query","required":true,"description":"Published gateway ID from /api/v1/gateways. Comparison a and b must differ.","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$"},"example":"busbar"},{"name":"b","in":"query","required":true,"description":"Published gateway ID from /api/v1/gateways. Comparison a and b must differ.","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$"},"example":"litellm-python"},{"name":"ingress","in":"query","required":false,"description":"Client ingress protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"egress","in":"query","required":false,"description":"Upstream protocol. Summary and comparison default to openai; measurements omit this filter by default.","schema":{"type":"string","enum":["openai","openai-responses","anthropic","gemini","cohere","bedrock"]},"example":"openai"},{"name":"metric","in":"query","required":false,"description":"Recorded metric key from latest.metrics, or throughput_rps. Comparison defaults to added_latency_p99_us; measurements return all metrics by default.","schema":{"type":"string","minLength":1},"example":"added_latency_p99_us"},{"name":"bound","in":"query","required":false,"description":"Only valid with metric=throughput_rps; none means unbounded. Matched operating concurrency is required.","schema":{"type":"string","enum":["1","5","10","50","100","none"]}}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comparison"}}}},"400":{"description":"Invalid, empty, repeated or unsupported query parameter, invalid bound, or identical comparison IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unknown protocol: invalid","status":400}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/methodology":{"get":{"operationId":"methodology","description":"Method text plus definitions recorded by the instrument","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Methodology"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/schema":{"get":{"operationId":"schemas","description":"Schema discovery","parameters":[],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaIndex"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/runs/{id}/raw.json":{"get":{"operationId":"rawRun","description":"Exact historical instrument JSON, schema may vary by harness version. Verify decoded bytes against raw_sha256.","parameters":[{"name":"id","in":"path","required":true,"description":"Exact identifier from the catalog or run evidence; unknown IDs return 404.","schema":{"type":"string","minLength":1},"example":"run-busbar-16d2da7bc28375e55402b153f0f49b1550d5556f6ebb71eda60b8c3c47ad8d5f"}],"responses":{"200":{"description":"Published evidence. Null means unknown or unavailable; never coerce to zero.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RawRun"}}}},"404":{"description":"Unknown gateway, run or collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Publication artifact unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
