Paper metadata

arXiv metadata and URLs without building the paper. build and inferred are present only once the tree has been built; this endpoint never triggers a build and ignores Prefer.

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

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

buildobject

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

inferredInferred

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

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

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

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.

Request

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

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

import requests

response = requests.get(
    "https://arxivv.org/1706.03762/metadata.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
      }
    }
  },
  "inferred": {
    "status": "pending",
    "queuedAt": "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/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit exceeded",
  "instance": "/1706.03762v7.md",
  "code": "rate-limited"
}

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