---
search:
  tags:
    - Papers
    - GET
seo:
  description: >-
    Metadata, build info, approximate token count, the full document tree and
    inferred fields… Reference for the GET /{idv}.json endpoint in the arXivv
    API.
sidebar:
  label: Paper as JSON
  badge: GET
title: Paper as JSON
type: openapi-operation
---
Metadata, build info, approximate token count, the full document tree and inferred fields (`schema: 1`).

`GET /{idv}.json`

**Responses**

- `200` — OK
- `202` — Accepted (\`Prefer: respond-async\` or \`?async\`, tree not yet built). Poll \`Location\` (the requested URL).
- `400` — Invalid paper ID
- `404` — Paper, version or part not found
- `422` — arXiv has no HTML for this version
- `429` — Rate limit exceeded
- `500` — Tree build failed
- `502` — arXiv (or another upstream) returned an error

Response example, 200:

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

Response example, 400:

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

Response example, 404:

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

Response example, 422:

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

Response example, 429:

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

Response example, 500:

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

Response example, 502:

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