API Overview

Submit documents programmatically, poll job status, and download verification results. Jobs use your normal credit balance.

Workflow

  1. Create an API key on your Account page.
  2. POST https://veruscite-data.com/api/v1/documents with your file.
  3. Poll GET https://veruscite-data.com/api/v1/documents/{id} until finished is true.
  4. Fetch GET https://veruscite-data.com/api/v1/documents/{id}/results.

Accepted files

  • PDF (.pdf)
  • Word (.docx)
  • Bibliography: BibTeX (.bib), RIS (.ris), EndNote (.enw)

Maximum size: 100 MB. Invalid or unsupported files are rejected.

Job status

Each document reports one of four statuses:

  • pending — queued, not started yet
  • in-process — being processed
  • completed — finished successfully
  • failed — failed (see error / error_message)

Papers with more than 100 citations are processed automatically (no confirmation step). Failed jobs only report a generic reason: not enough credits, too many pages, file too large, or processing failed.