Document Retrieval¶

Download proof documents associated with entities. Documents are official registry extracts and filings captured during searches.

Get document¶

Request¶

GET https://api.revolutio.systems/document/{documentId}

Headers

Header	Value
`X-API-Key` or `Authorization`	API key or Bearer token

Path parameters

Parameter	Type	Description
`documentId`	string	Document ID (`_documentID` on the entity)

Response¶

200 OK400 Bad Request404 Not Found

Returns the PDF file with:

Content-Type: application/pdf
Content-Disposition: inline; filename="document-name.pdf"

The response body is the full document.

{ "error": "Missing documentId" }

{ "error": "Invalid documentId format" }

{ "error": "Document not found" }

Or if the metadata exists but the file object is missing:

{ "error": "File not found" }

Example¶

curl -sS "https://api.revolutio.systems/document/abc123-doc-id" \
  -H "X-API-Key: $REV_API_KEY" \
  -o document.pdf

Finding document IDs¶

Document IDs appear on Entity objects under sourceDocuments:

{
  "sourceDocuments": [
    {
      "_documentID": "abc123-doc-id",
      "_entityID": "entity-uuid",
      "dateRetrieved": "2026-01-15",
      "name": "Certificate of Incorporation",
      "source": "Companies House"
    }
  ]
}

Use _documentID as the path parameter. Prefer reading documents from case.target (and nested counterparties) after a completed search, or from GET /search/{id}/status → result.sourceDocuments.