JSON schema

The PaperJson, MetadataJson and Outline shapes, a trimmed example for 1706.03762, and the schema 1 compatibility promise.

/1706.03762.json returns a PaperJson. /1706.03762/metadata.json returns a MetadataJson. /1706.03762/outline.json returns an Outline. All carry schema: 1.

PaperJson

{
  "schema": 1,
  "id": "1706.03762",
  "version": 7,
  "latestVersion": 7,
  "idv": "1706.03762v7",
  "urls": {
    "arxiv": {
      "abs": "https://arxiv.org/abs/1706.03762v7",
      "pdf": "https://arxiv.org/pdf/1706.03762v7",
      "html": "https://arxiv.org/html/1706.03762v7"
    },
    "arxivv": {
      "json": "https://arxivv.org/1706.03762v7.json",
      "md": "https://arxivv.org/1706.03762v7.md",
      "txt": "https://arxivv.org/1706.03762v7.txt",
      "outline": "https://arxivv.org/1706.03762v7/outline.json"
    }
  },
  "metadata": {
    "title": "Attention Is All You Need",
    "authors": "Ashish Vaswani, Noam Shazeer, Niki Parmar, Jakob Uszkoreit, Llion Jones, Aidan N. Gomez, Lukasz Kaiser, Illia Polosukhin",
    "abstract": "The dominant sequence transduction models are based on ...",
    "categories": ["cs.CL", "cs.LG"],
    "primaryCategory": "cs.CL",
    "versions": [{ "version": 1, "submittedAt": "2017-06-12T17:57:34Z" }]
  },
  "build": {
    "source": "arxiv-html",
    "builder": "0.1.0",
    "builtAt": "2026-10-14T09:00:00Z",
    "quality": {
      "score": 0.97,
      "stats": {
        "errors": 1,
        "sections": 7,
        "paragraphs": 120,
        "mathNodes": 180,
        "mathWithoutLatex": 0,
        "cites": 60,
        "unresolvedCites": 1,
        "figures": 5,
        "figuresWithoutImages": 0
      }
    }
  },
  "tokens": { "approx": 10240, "method": "chars/4" },
  "content": {
    "title": [{ "type": "text", "text": "Attention Is All You Need" }],
    "body": [
      {
        "type": "section",
        "id": "S1",
        "level": 1,
        "number": "1",
        "title": [{ "type": "text", "text": "Introduction" }],
        "children": [
          {
            "type": "paragraph",
            "id": "S1.p1",
            "content": [{ "type": "text", "text": "Recurrent neural networks ..." }]
          }
        ]
      }
    ]
  },
  "inferred": { "status": "pending", "queuedAt": "2026-10-14T09:00:01Z" }
}

Fields and arrays are trimmed in this example.

MetadataJson

/1706.03762/metadata.json is the cheap way to look a paper up. It never builds the paper and ignores Prefer.

A paper that has never been built returns only the arXiv metadata and URLs. Request any format to build it.

Outline

{
  "schema": 1,
  "id": "1706.03762",
  "version": 7,
  "idv": "1706.03762v7",
  "title": "Attention Is All You Need",
  "authors": ["Ashish Vaswani", "Noam Shazeer"],
  "primaryCategory": "cs.CL",
  "submittedAt": "2017-06-12T17:57:34Z",
  "inferred": {
    "status": "ready",
    "tldr": "Introduces the Transformer ...",
    "paperType": "method"
  },
  "tokens": { "approx": 10240, "method": "chars/4" },
  "abstract": "The dominant sequence transduction models ...",
  "sections": [
    {
      "id": "S3",
      "alias": "S3",
      "number": "3",
      "title": "Model Architecture",
      "tokens": 3100,
      "children": [
        {
          "id": "S3.SS2",
          "alias": "S3.2",
          "number": "3.2",
          "title": "Attention",
          "tokens": 1200,
          "children": []
        }
      ]
    }
  ],
  "figures": [{ "id": "S3.F1", "number": "1", "caption": "The Transformer - model architecture." }],
  "tables": [
    { "id": "S6.T2", "number": "2", "caption": "The Transformer achieves better BLEU scores ..." }
  ],
  "equations": 3,
  "references": 40
}

Other shapes

• images[].url is absolute: https://arxivv.org/1706.03762v7/assets/Figures/ModalNet-21.png. It returns 404 until the asset is mirrored.
• A figure’s images are only its own direct images. Subfigures are listed as figures of their own, with their own images.
• referencedBy holds the ids of paragraphs whose ref targets the node (or a node inside it).

Compatibility

The schema field and the X-Arxivv-Schema header carry the major version.

• Ignore fields and node types you do not recognise.
• A new major ships alongside the old one.
• The old major stays available for a 6-month deprecation period.
• MCP tools and the API reference follow the same version.