{"openapi":"3.1.0","info":{"title":"arXivv API","version":"0.1.0","description":"Every arXiv paper as Markdown, JSON and plain text, plus its parts by anchor. One rule: `/<paper>.<format>`. Any other path is proxied to arXiv unchanged (drop-in API). Generated from `apps/edge`."},"servers":[{"url":"https://arxivv.org"}],"tags":[{"name":"Papers","description":"Whole-paper renderings: `/{idv}.{md,json,txt}`."},{"name":"Parts","description":"Parts of a paper under `/{idv}/`."}],"paths":{"/{idv}.md":{"get":{"operationId":"getPaperMarkdown","tags":["Papers"],"summary":"Paper as Markdown","description":"The whole paper rendered from the document tree: YAML front matter, `# Title`, `## Abstract`, body sections with `{#anchor}` heading ids, LaTeX math, GFM tables, footnotes and a numbered `## References` list.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"text/markdown":{"schema":{"type":"string"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}.json":{"get":{"operationId":"getPaperJson","tags":["Papers"],"summary":"Paper as JSON","description":"Metadata, build info, approximate token count, the full document tree and inferred fields (`schema: 1`).","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"},{"$ref":"#/components/parameters/Wait"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"},"Preference-Applied":{"$ref":"#/components/headers/Preference-Applied"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperJson"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}.txt":{"get":{"operationId":"getPaperText","tags":["Papers"],"summary":"Paper as plain text","description":"The Markdown rendering with formatting stripped; math is kept as LaTeX.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"text/plain":{"schema":{"type":"string"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/metadata.json":{"get":{"operationId":"getMetadata","tags":["Parts"],"summary":"Paper metadata","description":"arXiv metadata and URLs without building the paper. `build` and `inferred` are present only once the tree has been built; this endpoint never triggers a build and ignores `Prefer`.","parameters":[{"$ref":"#/components/parameters/Idv"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataJson"}}}},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/outline.json":{"get":{"operationId":"getOutline","tags":["Parts"],"summary":"Paper outline","description":"Title, authors, abstract, inferred summary, and the section tree with per-section token counts, plus figure/table captions and counts.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"},{"$ref":"#/components/parameters/Wait"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"},"Preference-Applied":{"$ref":"#/components/headers/Preference-Applied"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Outline"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/sections/{anchor}.md":{"get":{"operationId":"getSection","tags":["Parts"],"summary":"One section as Markdown","description":"Markdown for one section subtree, heading included. `anchor` is a LaTeXML id (`S3.SS2`), a short alias (`S3.2`) or a slug (`introduction`).","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/SectionAnchor"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"text/markdown":{"schema":{"type":"string"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/references.json":{"get":{"operationId":"getReferences","tags":["Parts"],"summary":"Bibliography","description":"Every reference with its text, inline content and any arXiv id, DOI or URL.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferencesJson"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/figures.json":{"get":{"operationId":"getFigures","tags":["Parts"],"summary":"Figures and tables","description":"Every figure (captions, absolute image URLs) and table (cells), with the paragraphs that reference each.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiguresJson"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/figures/{anchor}.json":{"get":{"operationId":"getFigure","tags":["Parts"],"summary":"One figure","description":"One figure by LaTeXML id (`S3.F1`) or number alias (`F2`).","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/FigureAnchor"},{"$ref":"#/components/parameters/Prefer"},{"$ref":"#/components/parameters/Async"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"X-Arxivv-Quality":{"$ref":"#/components/headers/X-Arxivv-Quality"},"X-Arxivv-Source":{"$ref":"#/components/headers/X-Arxivv-Source"},"Link":{"$ref":"#/components/headers/Link"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"},"Vary":{"$ref":"#/components/headers/Vary"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FigureJson"}}}},"202":{"$ref":"#/components/responses/Accepted"},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/NoHtml"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/BuildFailed"},"502":{"$ref":"#/components/responses/Upstream"}}}},"/{idv}/assets/{path}":{"get":{"operationId":"getAsset","tags":["Parts"],"summary":"Figure image or other HTML asset","description":"A file referenced by the arXiv HTML (e.g. `Figures/ModalNet-21.png`), mirrored asynchronously after the first build. 404 until mirrored.","parameters":[{"$ref":"#/components/parameters/Idv"},{"$ref":"#/components/parameters/AssetPath"}],"responses":{"200":{"description":"OK","headers":{"X-Arxivv-Schema":{"$ref":"#/components/headers/X-Arxivv-Schema"},"X-Arxivv-Version":{"$ref":"#/components/headers/X-Arxivv-Version"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Cache-Tag":{"$ref":"#/components/headers/Cache-Tag"}},"content":{"*/*":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidId"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/Upstream"}}}}},"components":{"parameters":{"Idv":{"name":"idv","in":"path","required":true,"description":"arXiv ID, optionally with version (`1706.03762`, `1706.03762v7`). Old-style IDs keep their slash (`hep-th/9901001v1`). Unversioned resolves to the latest version.","schema":{"type":"string"},"examples":{"latest":{"value":"1706.03762"},"versioned":{"value":"1706.03762v7"}}},"SectionAnchor":{"name":"anchor","in":"path","required":true,"description":"Section id (`S3.SS2`), alias (`S3.2`) or slug (`attention`).","schema":{"type":"string"},"example":"S3.2"},"FigureAnchor":{"name":"anchor","in":"path","required":true,"description":"Figure id (`S3.F1`) or number alias (`F2`).","schema":{"type":"string"},"example":"F1"},"AssetPath":{"name":"path","in":"path","required":true,"description":"Asset path relative to the version's asset root, as in `Image.src`.","schema":{"type":"string"},"example":"Figures/ModalNet-21.png"},"Prefer":{"name":"Prefer","in":"header","required":false,"description":"RFC 7240. `wait=N` waits up to N seconds (max 60) for inferred fields; `respond-async` returns 202 + Location when the tree is not yet built.","schema":{"type":"string"},"examples":{"wait":{"value":"wait=30"},"async":{"value":"respond-async"}}},"Wait":{"name":"wait","in":"query","required":false,"description":"Same as `Prefer: wait=N`. Capped at 60.","schema":{"type":"integer","minimum":0,"maximum":60}},"Async":{"name":"async","in":"query","required":false,"description":"Same as `Prefer: respond-async`. Presence is enough (`?async`).","allowEmptyValue":true,"schema":{"type":"boolean"}}},"headers":{"X-Arxivv-Schema":{"description":"Major schema version.","schema":{"type":"integer"},"example":1},"X-Arxivv-Version":{"description":"arXiv version served.","schema":{"type":"integer"},"example":7},"X-Arxivv-Quality":{"description":"Conversion quality score, 0 to 1.","schema":{"type":"number"},"example":0.97},"X-Arxivv-Source":{"description":"Tree source.","schema":{"type":"string","enum":["arxiv-html","latexml-oxide"]},"example":"arxiv-html"},"Link":{"description":"Canonical versioned URL, on unversioned requests only.","schema":{"type":"string"},"example":"</1706.03762v7.md>; rel=\"canonical\""},"Cache-Control":{"description":"`public, max-age=31536000, immutable` for versioned URLs; `public, max-age=3600, stale-while-revalidate=86400` for unversioned URLs (assets included); `public, max-age=30` only on `.json`, `outline.json` and `metadata.json` while inferred fields are pending or failed (and on `metadata.json` before the tree is built); `no-store` when a preference was applied.","schema":{"type":"string"},"example":"public, max-age=31536000, immutable"},"Cache-Tag":{"description":"`paper:{id}` on unversioned responses.","schema":{"type":"string"},"example":"paper:1706.03762"},"Vary":{"description":"Always `Prefer`.","schema":{"type":"string"},"example":"Prefer"},"Preference-Applied":{"description":"The applied `Prefer` value(s).","schema":{"type":"string"},"example":"wait=30"},"Retry-After":{"description":"Seconds until pending inferred fields are likely ready.","schema":{"type":"integer"},"example":10}},"responses":{"Accepted":{"description":"Accepted (`Prefer: respond-async` or `?async`, tree not yet built). Poll `Location` (the requested URL).","headers":{"Location":{"description":"URL to poll.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the async build is likely ready.","schema":{"type":"integer"},"example":5},"Preference-Applied":{"$ref":"#/components/headers/Preference-Applied"}},"content":{"application/json":{"schema":{"type":"object","required":["status","location"],"properties":{"status":{"type":"string","enum":["building"]},"location":{"type":"string"}}}}}},"InvalidId":{"description":"Invalid paper ID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/invalid-id","title":"Invalid paper ID","status":400,"detail":"Invalid paper ID","instance":"/1706.03762v7.md","code":"invalid-id"}}}},"NotFound":{"description":"Paper, version or part not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/not-found","title":"Not found","status":404,"detail":"Paper, version or part not found","instance":"/1706.03762v7.md","code":"not-found"}}}},"NoHtml":{"description":"arXiv has no HTML for this version","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/no-html","title":"arXiv has no HTML for this version","status":422,"detail":"arXiv has no HTML for this version","instance":"/1706.03762v7.md","code":"no-html"}}}},"RateLimited":{"description":"Rate limit exceeded","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/rate-limited","title":"Rate limit exceeded","status":429,"detail":"Rate limit exceeded","instance":"/1706.03762v7.md","code":"rate-limited"}}},"headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"BuildFailed":{"description":"Tree build failed","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/build-failed","title":"Tree build failed","status":500,"detail":"Tree build failed","instance":"/1706.03762v7.md","code":"build-failed"}}}},"Upstream":{"description":"arXiv (or another upstream) returned an error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://arxivv.org/errors/upstream","title":"Upstream error","status":502,"detail":"arXiv (or another upstream) returned an error","instance":"/1706.03762v7.md","code":"upstream"}}}}},"schemas":{"PaperId":{"type":"string","pattern":"^(?:\\d{4}\\.\\d{4,5}|[a-z-]+(?:\\.[A-Z]{2})?\\/\\d{7})$","description":"arXiv identifier without version: new style `1706.03762` or old style `hep-th/9901001`"},"Version":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"arXiv version number (1-based)"},"Idv":{"type":"string","pattern":"^(?:\\d{4}\\.\\d{4,5}|[a-z-]+(?:\\.[A-Z]{2})?\\/\\d{7})v[1-9]\\d*$","description":"arXiv identifier with version, e.g. `1706.03762v7`"},"OaiVersion":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/Version"},"submittedAt":{"type":"string","description":"ISO 8601 timestamp"},"sourceType":{"type":"string"}},"required":["version","submittedAt"],"additionalProperties":true,"description":"One version entry from arXivRaw"},"PaperMetadata":{"type":"object","properties":{"title":{"type":"string"},"authors":{"type":"string","description":"Author list as given by arXiv"},"abstract":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"primaryCategory":{"type":"string"},"license":{"type":"string"},"doi":{"type":"string"},"journalRef":{"type":"string"},"comments":{"type":"string"},"reportNo":{"type":"string"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/OaiVersion"}}},"required":["title","authors","abstract","categories","primaryCategory","versions"],"additionalProperties":true,"description":"Paper metadata from arXivRaw"},"QualityStats":{"type":"object","properties":{"errors":{"type":"integer","minimum":0,"maximum":9007199254740991},"sections":{"type":"integer","minimum":0,"maximum":9007199254740991},"paragraphs":{"type":"integer","minimum":0,"maximum":9007199254740991},"mathNodes":{"type":"integer","minimum":0,"maximum":9007199254740991},"mathWithoutLatex":{"type":"integer","minimum":0,"maximum":9007199254740991},"cites":{"type":"integer","minimum":0,"maximum":9007199254740991},"unresolvedCites":{"type":"integer","minimum":0,"maximum":9007199254740991},"figures":{"type":"integer","minimum":0,"maximum":9007199254740991},"figuresWithoutImages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["errors","sections","paragraphs","mathNodes","mathWithoutLatex","cites","unresolvedCites","figures","figuresWithoutImages"],"additionalProperties":true,"description":"Counts collected while building the tree"},"Quality":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1},"stats":{"$ref":"#/components/schemas/QualityStats"}},"required":["score","stats"],"additionalProperties":true,"description":"Build quality score in [0, 1] and its inputs"},"Tokens":{"type":"object","properties":{"approx":{"type":"integer","minimum":0,"maximum":9007199254740991},"method":{"type":"string","enum":["chars/4"]}},"required":["approx","method"],"additionalProperties":true,"description":"Approximate token count, `ceil(chars / 4)`"},"TextInline":{"type":"object","properties":{"type":{"type":"string","enum":["text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true,"description":"Plain text"},"InlineStyle":{"type":"string","enum":["emph","strong","code","sub","sup","smallcaps","underline"],"description":"Inline formatting style"},"SpanInline":{"type":"object","properties":{"type":{"type":"string","enum":["span"]},"style":{"type":"array","items":{"$ref":"#/components/schemas/InlineStyle"}},"content":{"$ref":"#/components/schemas/Arrays_"}},"required":["type","style","content"],"additionalProperties":true,"description":"Formatted inline content"},"MathInline":{"type":"object","properties":{"type":{"type":"string","enum":["math"]},"id":{"type":"string"},"latex":{"type":"string"}},"required":["type","latex"],"additionalProperties":true,"description":"Inline math; `latex` comes from the LaTeXML alttext"},"CiteInline":{"type":"object","properties":{"type":{"type":"string","enum":["cite"]},"targets":{"type":"array","items":{"type":"string"},"description":"Bibliography ids"},"content":{"$ref":"#/components/schemas/Arrays_"}},"required":["type","targets","content"],"additionalProperties":true,"description":"Citation of bibliography entries"},"RefInline":{"type":"object","properties":{"type":{"type":"string","enum":["ref"]},"target":{"type":"string"},"content":{"$ref":"#/components/schemas/Arrays_"}},"required":["type","target","content"],"additionalProperties":true,"description":"Cross-reference to any node id"},"LinkInline":{"type":"object","properties":{"type":{"type":"string","enum":["link"]},"href":{"type":"string"},"content":{"$ref":"#/components/schemas/Arrays_"}},"required":["type","href","content"],"additionalProperties":true,"description":"Hyperlink"},"FootnoteRefInline":{"type":"object","properties":{"type":{"type":"string","enum":["footnoteRef"]},"target":{"type":"string"}},"required":["type","target"],"additionalProperties":true,"description":"Reference to an entry in `Document.footnotes`"},"BreakInline":{"type":"object","properties":{"type":{"type":"string","enum":["break"]}},"required":["type"],"additionalProperties":true,"description":"Line break"},"Inline":{"anyOf":[{"$ref":"#/components/schemas/TextInline"},{"$ref":"#/components/schemas/SpanInline"},{"$ref":"#/components/schemas/MathInline"},{"$ref":"#/components/schemas/CiteInline"},{"$ref":"#/components/schemas/RefInline"},{"$ref":"#/components/schemas/LinkInline"},{"$ref":"#/components/schemas/FootnoteRefInline"},{"$ref":"#/components/schemas/BreakInline"}],"description":"Inline content node"},"Arrays_":{"type":"array","items":{"$ref":"#/components/schemas/Inline"}},"Author":{"type":"object","properties":{"name":{"type":"string"},"affiliations":{"type":"array","items":{"type":"string"}},"email":{"type":"string"}},"required":["name"],"additionalProperties":true,"description":"Paper author as rendered in the paper"},"SectionBlock":{"type":"object","properties":{"type":{"type":"string","enum":["section"]},"id":{"type":"string"},"level":{"type":"number","enum":[1,2,3,4]},"number":{"type":"string"},"title":{"$ref":"#/components/schemas/Arrays_"},"children":{"$ref":"#/components/schemas/Arrays_1"}},"required":["type","id","level","title","children"],"additionalProperties":true,"description":"Section (level 1-4) with its nested content"},"ParagraphBlock":{"type":"object","properties":{"type":{"type":"string","enum":["paragraph"]},"id":{"type":"string"},"content":{"$ref":"#/components/schemas/Arrays_"}},"required":["type","content"],"additionalProperties":true,"description":"Paragraph"},"EquationBlock":{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"id":{"type":"string"},"number":{"type":"string"},"latex":{"type":"string"}},"required":["type","id","latex"],"additionalProperties":true,"description":"Display equation"},"Image":{"type":"object","properties":{"src":{"type":"string","description":"Path relative to the version's asset root, e.g. `Figures/ModalNet-21.png`"},"alt":{"type":"string"}},"required":["src"],"additionalProperties":true,"description":"An image inside a figure"},"FigureBlock":{"type":"object","properties":{"type":{"type":"string","enum":["figure"]},"id":{"type":"string"},"number":{"type":"string"},"caption":{"$ref":"#/components/schemas/Arrays_"},"images":{"type":"array","items":{"$ref":"#/components/schemas/Image"}},"children":{"type":"array","items":{"$ref":"#/components/schemas/Suspend_"}}},"required":["type","id","caption","images"],"additionalProperties":true,"description":"Figure; `children` holds subfigures"},"Cell":{"type":"object","properties":{"content":{"$ref":"#/components/schemas/Arrays_"},"header":{"type":"boolean"},"colspan":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rowspan":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["content","header"],"additionalProperties":true,"description":"A table cell"},"TableBlock":{"type":"object","properties":{"type":{"type":"string","enum":["table"]},"id":{"type":"string"},"number":{"type":"string"},"caption":{"$ref":"#/components/schemas/Arrays_"},"rows":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/Cell"}}}},"required":["type","id","caption","rows"],"additionalProperties":true,"description":"Table as rows of cells"},"ListBlock":{"type":"object","properties":{"type":{"type":"string","enum":["list"]},"ordered":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Arrays_1"}}},"required":["type","ordered","items"],"additionalProperties":true,"description":"Ordered or unordered list; each item is a list of blocks"},"TheoremBlock":{"type":"object","properties":{"type":{"type":"string","enum":["theorem"]},"id":{"type":"string"},"kind":{"type":"string"},"number":{"type":"string"},"title":{"type":"array","items":{"$ref":"#/components/schemas/Inline"}},"children":{"$ref":"#/components/schemas/Arrays_1"}},"required":["type","id","kind","children"],"additionalProperties":true,"description":"Theorem-like environment (theorem, lemma, proof, definition, ...)"},"CodeBlock":{"type":"object","properties":{"type":{"type":"string","enum":["code"]},"language":{"type":"string"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true,"description":"Code listing or verbatim text"},"QuoteBlock":{"type":"object","properties":{"type":{"type":"string","enum":["quote"]},"children":{"$ref":"#/components/schemas/Arrays_1"}},"required":["type","children"],"additionalProperties":true,"description":"Block quotation"},"RawBlock":{"type":"object","properties":{"type":{"type":"string","enum":["raw"]},"markdown":{"type":"string"}},"required":["type","markdown"],"additionalProperties":true,"description":"Unrecognised element converted best-effort to markdown"},"Block":{"anyOf":[{"$ref":"#/components/schemas/SectionBlock"},{"$ref":"#/components/schemas/ParagraphBlock"},{"$ref":"#/components/schemas/EquationBlock"},{"$ref":"#/components/schemas/FigureBlock"},{"$ref":"#/components/schemas/TableBlock"},{"$ref":"#/components/schemas/ListBlock"},{"$ref":"#/components/schemas/TheoremBlock"},{"$ref":"#/components/schemas/CodeBlock"},{"$ref":"#/components/schemas/QuoteBlock"},{"$ref":"#/components/schemas/RawBlock"}],"description":"Block content node"},"Suspend_":{"$ref":"#/components/schemas/Block"},"Arrays_1":{"type":"array","items":{"$ref":"#/components/schemas/Suspend_"}},"Reference":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"text":{"type":"string","description":"Plain text of the bibliography entry"},"content":{"$ref":"#/components/schemas/Arrays_"},"arxivId":{"type":"string"},"doi":{"type":"string"},"url":{"type":"string"}},"required":["id","text","content"],"additionalProperties":true,"description":"Bibliography entry"},"Footnote":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"content":{"$ref":"#/components/schemas/Arrays_1"}},"required":["id","content"],"additionalProperties":true,"description":"Footnote body"},"Document":{"type":"object","properties":{"title":{"$ref":"#/components/schemas/Arrays_"},"authors":{"type":"array","items":{"$ref":"#/components/schemas/Author"}},"abstract":{"$ref":"#/components/schemas/Arrays_1"},"body":{"$ref":"#/components/schemas/Arrays_1"},"appendices":{"$ref":"#/components/schemas/Arrays_1"},"bibliography":{"type":"array","items":{"$ref":"#/components/schemas/Reference"}},"footnotes":{"type":"array","items":{"$ref":"#/components/schemas/Footnote"}}},"required":["title","authors","abstract","body","appendices","bibliography","footnotes"],"additionalProperties":true,"description":"Document tree of one paper version"},"InferredFields":{"type":"object","properties":{"tldr":{"type":"string","description":"One-sentence summary"},"contributions":{"type":"array","items":{"type":"string"},"description":"Main contributions claimed by the paper"},"paperType":{"type":"string","enum":["method","benchmark","survey","theory","position","dataset","other"]},"entities":{"type":"object","properties":{"tasks":{"type":"array","items":{"type":"string"}},"methods":{"type":"array","items":{"type":"string"}},"datasets":{"type":"array","items":{"type":"string"}},"metrics":{"type":"array","items":{"type":"string"}},"models":{"type":"array","items":{"type":"string"}}},"required":["tasks","methods","datasets","metrics","models"],"additionalProperties":true},"results":{"type":"array","items":{"type":"object","properties":{"benchmark":{"type":"string"},"metric":{"type":"string"},"value":{"type":"string"},"baseline":{"type":"string"},"note":{"type":"string"}},"required":["benchmark","metric","value"],"additionalProperties":true}},"artifacts":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["code","data","model","project","other"]},"url":{"type":"string"},"note":{"type":"string"}},"required":["kind","url"],"additionalProperties":true}}},"required":["tldr","contributions","paperType","entities","results","artifacts"],"additionalProperties":true,"description":"Metadata inferred from the paper text by an LLM"},"Inferred":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["pending"]},"queuedAt":{"type":"string"}},"required":["status","queuedAt"],"additionalProperties":true},{"type":"object","properties":{"status":{"type":"string","enum":["failed"]},"error":{"type":"string"},"failedAt":{"type":"string"}},"required":["status","error","failedAt"],"additionalProperties":true},{"type":"object","properties":{"status":{"type":"string","enum":["ready"]},"models":{"type":"array","items":{"type":"object","properties":{"model":{"type":"string"},"fields":{"type":"array","items":{"type":"string"},"description":"`InferredFields` keys produced by this model"}},"required":["model","fields"],"additionalProperties":true},"description":"Which model produced which fields"},"promptVersion":{"type":"string"},"generatedAt":{"type":"string"},"fields":{"$ref":"#/components/schemas/InferredFields"}},"required":["status","models","promptVersion","generatedAt","fields"],"additionalProperties":true}],"description":"Enrichment state and, when ready, the inferred fields (`inferred.json` in R2)"},"PaperJson":{"type":"object","properties":{"schema":{"type":"number","enum":[1],"description":"Major schema version"},"id":{"$ref":"#/components/schemas/PaperId"},"version":{"$ref":"#/components/schemas/Version"},"latestVersion":{"$ref":"#/components/schemas/Version"},"idv":{"$ref":"#/components/schemas/Idv"},"urls":{"type":"object","properties":{"arxiv":{"type":"object","properties":{"abs":{"type":"string"},"pdf":{"type":"string"},"html":{"type":"string"}},"required":["abs","pdf","html"],"additionalProperties":true},"arxivv":{"type":"object","properties":{"json":{"type":"string"},"md":{"type":"string"},"txt":{"type":"string"},"outline":{"type":"string"}},"required":["json","md","txt","outline"],"additionalProperties":true}},"required":["arxiv","arxivv"],"additionalProperties":true},"metadata":{"$ref":"#/components/schemas/PaperMetadata"},"build":{"type":"object","properties":{"source":{"type":"string"},"builder":{"type":"string"},"builtAt":{"type":"string"},"quality":{"$ref":"#/components/schemas/Quality"}},"required":["source","builder","builtAt","quality"],"additionalProperties":true},"tokens":{"$ref":"#/components/schemas/Tokens"},"content":{"$ref":"#/components/schemas/Document"},"inferred":{"$ref":"#/components/schemas/Inferred"}},"required":["schema","id","version","latestVersion","idv","urls","metadata","build","tokens","content","inferred"],"additionalProperties":true,"description":"Full paper: `/{idv}.json`"},"MetadataJson":{"type":"object","properties":{"schema":{"type":"number","enum":[1],"description":"Major schema version"},"id":{"$ref":"#/components/schemas/PaperId"},"version":{"$ref":"#/components/schemas/Version"},"latestVersion":{"$ref":"#/components/schemas/Version"},"idv":{"$ref":"#/components/schemas/Idv"},"urls":{"type":"object","properties":{"arxiv":{"type":"object","properties":{"abs":{"type":"string"},"pdf":{"type":"string"},"html":{"type":"string"}},"required":["abs","pdf","html"],"additionalProperties":true},"arxivv":{"type":"object","properties":{"json":{"type":"string"},"md":{"type":"string"},"txt":{"type":"string"},"outline":{"type":"string"}},"required":["json","md","txt","outline"],"additionalProperties":true}},"required":["arxiv","arxivv"],"additionalProperties":true},"metadata":{"$ref":"#/components/schemas/PaperMetadata"},"build":{"type":"object","properties":{"source":{"type":"string"},"builder":{"type":"string"},"builtAt":{"type":"string"},"quality":{"$ref":"#/components/schemas/Quality"}},"required":["source","builder","builtAt","quality"],"additionalProperties":true},"inferred":{"$ref":"#/components/schemas/Inferred"}},"required":["schema","id","version","latestVersion","idv","urls","metadata"],"additionalProperties":true,"description":"Metadata only: `/{idv}/metadata.json`. `build` and `inferred` are present once the tree is built; this endpoint never triggers a build"},"OutlineSection":{"type":"object","properties":{"id":{"type":"string","description":"LaTeXML id, e.g. `S3.SS2`"},"alias":{"type":"string","description":"Short alias, e.g. `S3.2`"},"number":{"type":"string"},"title":{"type":"string"},"tokens":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Approximate tokens of the section markdown"},"children":{"type":"array","items":{"$ref":"#/components/schemas/OutlineSection"}}},"required":["id","alias","title","tokens","children"],"additionalProperties":true,"description":"Section entry in an outline"},"OutlineFloat":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"caption":{"type":"string"}},"required":["id","caption"],"additionalProperties":true,"description":"Figure or table entry in an outline"},"Outline":{"type":"object","properties":{"schema":{"type":"number","enum":[1],"description":"Major schema version"},"id":{"$ref":"#/components/schemas/PaperId"},"version":{"$ref":"#/components/schemas/Version"},"idv":{"$ref":"#/components/schemas/Idv"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"primaryCategory":{"type":"string"},"submittedAt":{"type":"string"},"inferred":{"type":"object","properties":{"status":{"type":"string","enum":["pending","failed","ready"]},"tldr":{"type":"string"},"contributions":{"type":"array","items":{"type":"string"}},"paperType":{"type":"string"}},"required":["status"],"additionalProperties":true},"tokens":{"$ref":"#/components/schemas/Tokens"},"abstract":{"type":"string"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/OutlineSection"}},"figures":{"type":"array","items":{"$ref":"#/components/schemas/OutlineFloat"}},"tables":{"type":"array","items":{"$ref":"#/components/schemas/OutlineFloat"}},"equations":{"type":"integer","minimum":0,"maximum":9007199254740991},"references":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["schema","id","version","idv","title","authors","primaryCategory","submittedAt","inferred","tokens","abstract","sections","figures","tables","equations","references"],"additionalProperties":true,"description":"Paper overview: `/{idv}/outline.json`"},"ReferencesJson":{"type":"object","properties":{"schema":{"type":"number","enum":[1],"description":"Major schema version"},"idv":{"$ref":"#/components/schemas/Idv"},"references":{"type":"array","items":{"$ref":"#/components/schemas/Reference"}}},"required":["schema","idv","references"],"additionalProperties":true,"description":"Bibliography: `/{idv}/references.json`"},"FigureJson":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"caption":{"type":"string"},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"}},"required":["url"],"additionalProperties":true}},"referencedBy":{"type":"array","items":{"type":"string"},"description":"Ids of paragraphs that reference this node"}},"required":["id","caption","images","referencedBy"],"additionalProperties":true,"description":"Figure: `/{idv}/figures/{anchor}.json`"},"TableJson":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"caption":{"type":"string"},"rows":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/Cell"}}},"referencedBy":{"type":"array","items":{"type":"string"},"description":"Ids of paragraphs that reference this node"}},"required":["id","caption","rows","referencedBy"],"additionalProperties":true,"description":"Table with its cells"},"FiguresJson":{"type":"object","properties":{"schema":{"type":"number","enum":[1],"description":"Major schema version"},"idv":{"$ref":"#/components/schemas/Idv"},"figures":{"type":"array","items":{"$ref":"#/components/schemas/FigureJson"}},"tables":{"type":"array","items":{"$ref":"#/components/schemas/TableJson"}}},"required":["schema","idv","figures","tables"],"additionalProperties":true,"description":"Figures and tables: `/{idv}/figures.json`"},"ErrorCode":{"type":"string","enum":["not-found","invalid-id","no-html","upstream","build-failed","rate-limited"],"description":"Machine-readable error code"},"Problem":{"type":"object","properties":{"type":{"type":"string","description":"`https://arxivv.org/errors/{code}`"},"title":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"$ref":"#/components/schemas/ErrorCode"}},"required":["type","title","status","code"],"additionalProperties":true,"description":"RFC 9457 problem details"}}}}