Bibliography

Every reference with its text, inline content and any arXiv id, DOI or URL.

GET/{idv}/references.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).

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

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*$

referencesReference[]required

Show properties

Array of Reference

idstringrequired

numberstring

textstringrequired

Plain text of the bibliography entry

contentArrays_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

arxivIdstring

doistring

urlstring

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`).

Request

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

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

import requests

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

Response

{
  "schema": 1,
  "idv": "string",
  "references": [
    {
      "id": "string",
      "number": "string",
      "text": "string",
      "content": [
        {
          "type": "text",
          "text": "string"
        }
      ],
      "arxivId": "string",
      "doi": "string",
      "url": "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"
}