Figures and tables

Every figure (captions, absolute image URLs) and table (cells), with the paragraphs that reference each.

GET/{idv}/figures.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*$

figuresFigureJson[]required

Show properties

Array of FigureJson

idstringrequired

numberstring

captionstringrequired

imagesobject[]required

Show properties

Array of object

urlstringrequired

altstring

referencedBystring[]required

Ids of paragraphs that reference this node

tablesTableJson[]required

Show properties

Array of TableJson

idstringrequired

numberstring

captionstringrequired

rowsCell[][]required

referencedBystring[]required

Ids of paragraphs that reference this node

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/figures.json' \
  -H 'Accept: application/json'

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

import requests

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

Response

{
  "schema": 1,
  "idv": "string",
  "figures": [
    {
      "id": "string",
      "number": "string",
      "caption": "string",
      "images": [
        {
          "url": "string",
          "alt": "string"
        }
      ],
      "referencedBy": [
        "string"
      ]
    }
  ],
  "tables": [
    {
      "id": "string",
      "number": "string",
      "caption": "string",
      "rows": [
        [
          {
            "content": [
              {
                "type": "text",
                "text": "string"
              }
            ],
            "header": true,
            "colspan": -9007199254740991,
            "rowspan": -9007199254740991
          }
        ]
      ],
      "referencedBy": [
        "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"
}