{"openapi":"3.0.3","info":{"title":"Cuántica Results API","version":"1.0.0","description":"Source-backed public quantum and classical computation results. Public, read-only, no authentication. Units and resource scopes are retained; no universal advantage ranking. CORS permits GET, HEAD, OPTIONS with no credentials. Unsupported write methods return 405."},"servers":[{"url":"/","description":"Same origin"}],"paths":{"/v1/results":{"get":{"operationId":"listResults","summary":"Filter and sort public results","description":"All filters combine with AND. Query string maximum 4096 bytes; each parameter appears at most once. No authentication or writes.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"Case- and accent-insensitive substring across title, summary, accuracy, limitations, hardware, source titles, and method IDs."},{"name":"approach","in":"query","required":false,"schema":{"type":"string","enum":["classical","quantum","hybrid"]},"description":"Computing approach."},{"name":"workload","in":"query","required":false,"schema":{"type":"string","enum":["chemistry","quantum-dynamics","random-circuit-sampling","materials","molecular-dynamics"]},"description":"Type of physical or benchmark workload."},{"name":"unit","in":"query","required":false,"schema":{"type":"string","enum":["qubits","spins","atoms","electrons","spatial-orbitals"]},"description":"Require a reported size in this unit. Required when sorting by size; units are never converted."},{"name":"claim_role","in":"query","required":false,"schema":{"type":"string","enum":["demonstration","advantage-claim","classical-response","resource-estimate"]},"description":"Role of the result in the evidence."},{"name":"comparison_group","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":"Exact stable comparison-group ID. Unknown but valid IDs return zero results."},{"name":"method","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"description":"Exact method ID. Unknown but valid IDs return zero results."},{"name":"year_min","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9999},"description":"Inclusive source-date year lower bound."},{"name":"year_max","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9999},"description":"Inclusive source-date year upper bound."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Maximum records in this page."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0},"description":"Records to skip after filtering and sorting."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["-date","date","title","-title","size","-size"],"default":"-date"},"description":"Default: newest date first. Partial dates sort at the start of their known period; original date precision is preserved. Size sorting requires unit and uses the largest reported size in that unit per record. Ties use ascending record ID."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultPage"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"listResultsHead","summary":"Read response headers without a body","description":"All filters combine with AND. Query string maximum 4096 bytes; each parameter appears at most once. No authentication or writes.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"Case- and accent-insensitive substring across title, summary, accuracy, limitations, hardware, source titles, and method IDs."},{"name":"approach","in":"query","required":false,"schema":{"type":"string","enum":["classical","quantum","hybrid"]},"description":"Computing approach."},{"name":"workload","in":"query","required":false,"schema":{"type":"string","enum":["chemistry","quantum-dynamics","random-circuit-sampling","materials","molecular-dynamics"]},"description":"Type of physical or benchmark workload."},{"name":"unit","in":"query","required":false,"schema":{"type":"string","enum":["qubits","spins","atoms","electrons","spatial-orbitals"]},"description":"Require a reported size in this unit. Required when sorting by size; units are never converted."},{"name":"claim_role","in":"query","required":false,"schema":{"type":"string","enum":["demonstration","advantage-claim","classical-response","resource-estimate"]},"description":"Role of the result in the evidence."},{"name":"comparison_group","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":"Exact stable comparison-group ID. Unknown but valid IDs return zero results."},{"name":"method","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"description":"Exact method ID. Unknown but valid IDs return zero results."},{"name":"year_min","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9999},"description":"Inclusive source-date year lower bound."},{"name":"year_max","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9999},"description":"Inclusive source-date year upper bound."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Maximum records in this page."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0},"description":"Records to skip after filtering and sorting."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["-date","date","title","-title","size","-size"],"default":"-date"},"description":"Default: newest date first. Partial dates sort at the start of their known period; original date precision is preserved. Size sorting requires unit and uses the largest reported size in that unit per record. Ties use ascending record ID."}],"responses":{"200":{"description":"Success"},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/v1/results/{id}":{"get":{"operationId":"getResult","summary":"Read one public result","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getResultHead","summary":"Read response headers without a body","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}]}},"/v1/meta":{"get":{"operationId":"getMetadata","summary":"Read whole-dataset facets and unit-specific size ranges","description":"Facet counts count records, once per unit or method. Size ranges remain separate by unit. No query parameters.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getMetadataHead","summary":"Read response headers without a body","description":"Facet counts count records, once per unit or method. Size ranges remain separate by unit. No query parameters.","responses":{"200":{"description":"Success"},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/health":{"get":{"operationId":"getHealth","summary":"Check availability of valid public data","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getHealthHead","summary":"Read response headers without a body","responses":{"200":{"description":"Success"},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/openapi.json":{"get":{"operationId":"getOpenAPI","summary":"Read this OpenAPI document","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getOpenAPIHead","summary":"Read response headers without a body","responses":{"200":{"description":"Success"},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/":{"get":{"operationId":"home","summary":"Interactive API documentation","responses":{"200":{"description":"Self-contained documentation and query form.","content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"homeHead","summary":"Read response headers without a body","responses":{"200":{"description":"Self-contained documentation and query form."},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/docs":{"get":{"operationId":"docs","summary":"Interactive API documentation","responses":{"200":{"description":"Self-contained documentation and query form.","content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"docsHead","summary":"Read response headers without a body","responses":{"200":{"description":"Self-contained documentation and query form."},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}},"/docs/":{"get":{"operationId":"docsTrailingSlash","summary":"Interactive API documentation","responses":{"200":{"description":"Self-contained documentation and query form.","content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown result or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Read-only endpoint; method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"414":{"description":"Request URL exceeds 8192 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Public dataset unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"docsTrailingSlashHead","summary":"Read response headers without a body","responses":{"200":{"description":"Self-contained documentation and query form."},"400":{"description":"Unknown, duplicate, malformed, or invalid query parameter."},"404":{"description":"Unknown result or endpoint."},"405":{"description":"Read-only endpoint; method not allowed."},"414":{"description":"Request URL exceeds 8192 characters."},"503":{"description":"Public dataset unavailable."}}},"options":{"summary":"Public CORS preflight","responses":{"204":{"description":"Allows GET, HEAD, OPTIONS from any origin; no credentials."}}}}},"components":{"schemas":{"Result":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string"},"summary":{"type":"string"},"approach":{"type":"string","enum":["classical","quantum","hybrid"]},"workload":{"type":"string","enum":["chemistry","quantum-dynamics","random-circuit-sampling","materials","molecular-dynamics"]},"comparison_group":{"type":"string","nullable":true},"date":{"type":"string","pattern":"^\\d{4}(-\\d{2}(-\\d{2})?)?$","description":"Source-backed date retaining its precision: YYYY, YYYY-MM, or YYYY-MM-DD."},"date_kind":{"type":"string","enum":["publication","preprint","experiment"]},"date_note":{"type":"string"},"sizes":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"number","minimum":0,"exclusiveMinimum":true},"unit":{"type":"string","enum":["qubits","spins","atoms","electrons","spatial-orbitals"]},"label":{"type":"string"},"note":{"type":"string"}},"required":["value","unit","label"]}},"resources":{"type":"object","additionalProperties":false,"properties":{"hardware":{"type":"string"},"cpu_cores":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"gpus":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"qpus":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"nodes":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"wall_seconds":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"total_flops":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"peak_flops_per_second":{"type":"number","minimum":0,"exclusiveMinimum":true,"nullable":true},"precision":{"type":"string","nullable":true},"note":{"type":"string"}},"required":["hardware","cpu_cores","gpus","qpus","nodes","wall_seconds","total_flops","peak_flops_per_second","precision","note"]},"accuracy":{"type":"string"},"evidence":{"type":"string","enum":["measured","estimated","mixed"]},"claim_role":{"type":"string","enum":["demonstration","advantage-claim","classical-response","resource-estimate"]},"chemistry_relevance":{"type":"string","enum":["direct","model","benchmark"]},"method_ids":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri","pattern":"^https://"},"year":{"type":"integer","minimum":1,"maximum":9999},"status":{"type":"string"}},"required":["title","url","year","status"]}},"relations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"target":{"type":"string"},"kind":{"type":"string","enum":["responds-to","extends","compares-with"]},"note":{"type":"string"}},"required":["target","kind","note"]}},"limitation":{"type":"string"}},"required":["id","title","summary","approach","workload","comparison_group","date","date_kind","date_note","sizes","resources","accuracy","evidence","claim_role","chemistry_relevance","method_ids","sources","relations","limitation"]},"ResultPage":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["1.0"]},"updated_at":{"type":"string","format":"date"},"total":{"type":"integer","minimum":0},"limit":{"type":"integer"},"offset":{"type":"integer"},"sort":{"type":"string"},"records":{"type":"array","items":{"$ref":"#/components/schemas/Result"}}},"required":["schema_version","updated_at","total","limit","offset","sort","records"]},"Metadata":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["1.0"]},"updated_at":{"type":"string","format":"date"},"total":{"type":"integer"},"facets":{"type":"object","additionalProperties":false,"properties":{"approach":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"workload":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"unit":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"claim_role":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"comparison_group":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"method":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}},"year":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"oneOf":[{"type":"string"},{"type":"integer"}]},"count":{"type":"integer","minimum":1}},"required":["value","count"]}}},"required":["approach","workload","unit","claim_role","comparison_group","method","year"]},"size_ranges":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"unit":{"type":"string","enum":["qubits","spins","atoms","electrons","spatial-orbitals"]},"min":{"type":"number","minimum":0,"exclusiveMinimum":true},"max":{"type":"number","minimum":0,"exclusiveMinimum":true},"count":{"type":"integer"}},"required":["unit","min","max","count"]}}},"required":["schema_version","updated_at","total","facets","size_ranges"]},"Health":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["1.0"]},"updated_at":{"type":"string","format":"date"},"status":{"type":"string","enum":["ok"]},"records":{"type":"integer"}},"required":["schema_version","updated_at","status","records"]},"Error":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}