Paper as JSON

Metadata, build info, approximate token count, the full document tree and inferred fields (schema: 1).

GET/{idv}.json

Path parameters

idvstringrequired

arXiv ID, optionally with version (1706.03762, 1706.03762v7). Old-style IDs keep their slash (hep-th/9901001v1). Unversioned resolves to the latest version.

Query parameters

asyncboolean

Same as Prefer: respond-async. Presence is enough (?async).

waitinteger

Same as Prefer: wait=N. Capped at 60.

min 0 · max 60

Header parameters

Preferstring

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.

Responses

200

schemanumberrequired

Major schema version

Allowed:1

idPaperIdrequired

arXiv identifier without version: new style 1706.03762 or old style hep-th/9901001

matches ^(?:\d{4}\.\d{4,5}|[a-z-]+(?:\.[A-Z]{2})?\/\d{7})$

versionVersionrequired

arXiv version number (1-based)

min 1 · max 9007199254740991

latestVersionVersionrequired

arXiv version number (1-based)

min 1 · max 9007199254740991

idvIdvrequired

arXiv identifier with version, e.g. 1706.03762v7

matches ^(?:\d{4}\.\d{4,5}|[a-z-]+(?:\.[A-Z]{2})?\/\d{7})v[1-9]\d*$

urlsobjectrequired

Show properties

arxivobjectrequired

Show properties

absstringrequired

pdfstringrequired

htmlstringrequired

arxivvobjectrequired

Show properties

jsonstringrequired

mdstringrequired

txtstringrequired

outlinestringrequired

metadataPaperMetadatarequired

Paper metadata from arXivRaw

Show properties

titlestringrequired

authorsstringrequired

Author list as given by arXiv

abstractstringrequired

categoriesstring[]required

primaryCategorystringrequired

licensestring

doistring

journalRefstring

commentsstring

reportNostring

versionsOaiVersion[]required

Show properties

Array of OaiVersion

versionVersionrequired

arXiv version number (1-based)

min 1 · max 9007199254740991

submittedAtstringrequired

ISO 8601 timestamp

sourceTypestring

buildobjectrequired

Show properties

sourcestringrequired

builderstringrequired

builtAtstringrequired

qualityQualityrequired

Build quality score in [0, 1] and its inputs

Show properties

scorenumberrequired

min 0 · max 1

statsQualityStatsrequired

Counts collected while building the tree

Show properties

errorsintegerrequired

min 0 · max 9007199254740991

sectionsintegerrequired

min 0 · max 9007199254740991

paragraphsintegerrequired

min 0 · max 9007199254740991

mathNodesintegerrequired

min 0 · max 9007199254740991

mathWithoutLatexintegerrequired

min 0 · max 9007199254740991

citesintegerrequired

min 0 · max 9007199254740991

unresolvedCitesintegerrequired

min 0 · max 9007199254740991

figuresintegerrequired

min 0 · max 9007199254740991

figuresWithoutImagesintegerrequired

min 0 · max 9007199254740991

tokensTokensrequired

Approximate token count, ceil(chars / 4)

Show properties

approxintegerrequired

min 0 · max 9007199254740991

methodstringrequired

Allowed:chars/4

contentDocumentrequired

Document tree of one paper version

Show properties

titleArrays_required

Show properties

Array of Inline

Any of:

TextInline

typestringrequired

Allowed:text

textstringrequired

SpanInline

typestringrequired

Allowed:span

styleInlineStyle[]required

contentArrays_required

MathInline

typestringrequired

Allowed:math

idstring

latexstringrequired

CiteInline

typestringrequired

Allowed:cite

targetsstring[]required

Bibliography ids

contentArrays_required

RefInline

typestringrequired

Allowed:ref

targetstringrequired

contentArrays_required

LinkInline

typestringrequired

Allowed:link

hrefstringrequired

contentArrays_required

FootnoteRefInline

typestringrequired

Allowed:footnoteRef

targetstringrequired

BreakInline

typestringrequired

Allowed:break

authorsAuthor[]required

Show properties

Array of Author

namestringrequired

affiliationsstring[]

emailstring

abstractArrays_1required

Show properties

Array of Suspend_

Block

bodyArrays_1required

appendicesArrays_1required

bibliographyReference[]required

Show properties

Array of Reference

idstringrequired

numberstring

textstringrequired

Plain text of the bibliography entry

contentArrays_required

arxivIdstring

doistring

urlstring

footnotesFootnote[]required

Show properties

Array of Footnote

idstringrequired

numberstring

contentArrays_1required

inferredInferredrequired

Enrichment state and, when ready, the inferred fields (inferred.json in R2)

Show properties

Any of:

object

statusstringrequired

Allowed:pending

queuedAtstringrequired

object

statusstringrequired

Allowed:failed

errorstringrequired

failedAtstringrequired

object

statusstringrequired

Allowed:ready

modelsobject[]required

Which model produced which fields

Show properties

Array of object

modelstringrequired

fieldsstring[]required

InferredFields keys produced by this model

promptVersionstringrequired

generatedAtstringrequired

fieldsInferredFieldsrequired

Metadata inferred from the paper text by an LLM

Show properties

tldrstringrequired

One-sentence summary

contributionsstring[]required

Main contributions claimed by the paper

paperTypestringrequired

Allowed:methodbenchmarksurveytheorypositiondatasetother

entitiesobjectrequired

Show properties

tasksstring[]required

methodsstring[]required

datasetsstring[]required

metricsstring[]required

modelsstring[]required

resultsobject[]required

Show properties

Array of object

benchmarkstringrequired

metricstringrequired

valuestringrequired

baselinestring

notestring

artifactsobject[]required

Show properties

Array of object

kindstringrequired

Allowed:codedatamodelprojectother

urlstringrequired

notestring

202

Accepted (Prefer: respond-async or ?async, tree not yet built). Poll Location (the requested URL).

statusstringrequired

Allowed:building

locationstringrequired

400

Invalid paper ID

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

404

Paper, version or part not found

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

422

arXiv has no HTML for this version

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

429

Rate limit exceeded

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

500

Tree build failed

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

502

arXiv (or another upstream) returned an error

typestringrequired

https://arxivv.org/errors/{code}

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

detailstring

instancestring

codeErrorCoderequired

Machine-readable error code

Allowed:not-foundinvalid-idno-htmlupstreambuild-failedrate-limited

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Parameters

idvpath*arXiv ID, optionally with version (`1706.03762`, `1706.03762v7`). Old-style IDs keep their slash (`hep-th/9901001v1`). Unversioned resolves to the latest version.PreferheaderRFC 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.asyncquerySame as `Prefer: respond-async`. Presence is enough (`?async`).waitquerySame as `Prefer: wait=N`. Capped at 60.

Request

curl -X GET 'https://arxivv.org/1706.03762.json' \
  -H 'Accept: application/json'

const response = await fetch("https://arxivv.org/1706.03762.json", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://arxivv.org/1706.03762.json",
    headers={
        "Accept": "application/json"
    },
)

Response

{
  "schema": 1,
  "id": "string",
  "version": 1,
  "latestVersion": 1,
  "idv": "string",
  "urls": {
    "arxiv": {
      "abs": "string",
      "pdf": "string",
      "html": "string"
    },
    "arxivv": {
      "json": "string",
      "md": "string",
      "txt": "string",
      "outline": "string"
    }
  },
  "metadata": {
    "title": "string",
    "authors": "string",
    "abstract": "string",
    "categories": [
      "string"
    ],
    "primaryCategory": "string",
    "license": "string",
    "doi": "string",
    "journalRef": "string",
    "comments": "string",
    "reportNo": "string",
    "versions": [
      {
        "version": 1,
        "submittedAt": "string",
        "sourceType": "string"
      }
    ]
  },
  "build": {
    "source": "string",
    "builder": "string",
    "builtAt": "string",
    "quality": {
      "score": 0,
      "stats": {
        "errors": 0,
        "sections": 0,
        "paragraphs": 0,
        "mathNodes": 0,
        "mathWithoutLatex": 0,
        "cites": 0,
        "unresolvedCites": 0,
        "figures": 0,
        "figuresWithoutImages": 0
      }
    }
  },
  "tokens": {
    "approx": 0,
    "method": "chars/4"
  },
  "content": {
    "title": [
      {
        "type": "text",
        "text": "string"
      }
    ],
    "authors": [
      {
        "name": "string",
        "affiliations": [
          "string"
        ],
        "email": "string"
      }
    ],
    "abstract": [
      {
        "type": "section",
        "id": "string",
        "level": 1,
        "number": "string",
        "title": [
          {
            "type": "text",
            "text": "string"
          }
        ],
        "children": []
      }
    ],
    "body": [
      {
        "type": "section",
        "id": "string",
        "level": 1,
        "number": "string",
        "title": [
          {
            "type": "text",
            "text": "string"
          }
        ],
        "children": []
      }
    ],
    "appendices": [
      {
        "type": "section",
        "id": "string",
        "level": 1,
        "number": "string",
        "title": [
          {
            "type": "text",
            "text": "string"
          }
        ],
        "children": []
      }
    ],
    "bibliography": [
      {
        "id": "string",
        "number": "string",
        "text": "string",
        "content": [
          {
            "type": "text",
            "text": "string"
          }
        ],
        "arxivId": "string",
        "doi": "string",
        "url": "string"
      }
    ],
    "footnotes": [
      {
        "id": "string",
        "number": "string",
        "content": [
          {
            "type": "section",
            "id": "string",
            "level": 1,
            "number": "string",
            "title": [
              {
                "type": "text",
                "text": "string"
              }
            ],
            "children": []
          }
        ]
      }
    ]
  },
  "inferred": {
    "status": "pending",
    "queuedAt": "string"
  }
}

{
  "status": "building",
  "location": "string"
}

{
  "type": "https://arxivv.org/errors/invalid-id",
  "title": "Invalid paper ID",
  "status": 400,
  "detail": "Invalid paper ID",
  "instance": "/1706.03762v7.md",
  "code": "invalid-id"
}

{
  "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"
}

{
  "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"
}

{
  "type": "https://arxivv.org/errors/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit exceeded",
  "instance": "/1706.03762v7.md",
  "code": "rate-limited"
}

{
  "type": "https://arxivv.org/errors/build-failed",
  "title": "Tree build failed",
  "status": 500,
  "detail": "Tree build failed",
  "instance": "/1706.03762v7.md",
  "code": "build-failed"
}

{
  "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"
}