v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Documents

Get annotated document

Returns a time-limited pre-signed URL to download private document content in annotated (structured) JSON format. Use this only for documents you ingested via the Content API (connectors or direct upload). When you GET the URL, the response contains document content, metadata and annotations. The URL expires after 24 hours; request a new one if needed.

get/contents/v1/documents/{content_id}/annotated

Path parameters

content_idstring required

Example:E0618D0E9D3A960C1731A620EDE56B5C

Content ID of the document (32-character uppercase hex string).

Response

The endpoint returns an object containing a pre-signed url. Perform a GET request on that URL to retrieve the annotated document in JSON format. The URL is valid for 24 hours; request a new one if needed.

urlstring uri required

Pre-signed URL that provides temporary access to the annotated document in JSON format. When you access the URL, you receive the complete document with structure: document (metadata), content (title and body blocks), profiling (processor timestamps), and analytics (document-level metrics, events array, entities array).

Example response

{
  "url": "https://content.bigdata.com/classified-documents/E0618D0E9D3A960C1731A620EDE56B5C.json?Expires=1770304237&Signature=abc123...&Key-Pair-Id=K34UQS1JQ2RLGM",
  "document": {
    "rp_document_id": "E0618D0E9D3A960C1731A620EDE56B5C",
    "source": {
      "rp_source_id": "DA0F7F",
      "name": "User Uploaded Content",
      "rank": 1
    },
    "timestamp": "2026-02-03T08:43:02Z",
    "metadata": {
      "file_name": "Weekly summary report.eml",
      "content_type": "message/rfc822",
      "user_id": "user_id_001",
      "org_id": "org_id_001"
    }
  },
  "content": {
    "title": {
      "text": "Tesla Inc: Q1 2025 Earnings Call",
      "sentences": [
        {
          "end": 46,
          "sentiment": "0.01",
          "sentiment_confidence": "0.94"
        }
      ],
      "entities": [
        {
          "rp_entity_id": "DD3BB1",
          "name": "Tesla Inc",
          "end": 9
        }
      ],
      "events": [
        {
          "event_similarity_key": "A1795745A27ECCF46AC3FA2708032A95",
          "end": 54
        }
      ]
    },
    "body": [
      {
        "type": "TEXT",
        "text": "The Federal Reserve will meet this week to discuss interest rates.",
        "sentences": [
          {
            "end": 46,
            "sentiment": "0.01",
            "sentiment_confidence": "0.94"
          }
        ],
        "entities": [
          {
            "rp_entity_id": "DD3BB1",
            "name": "Tesla Inc",
            "end": 9
          }
        ]
      }
    ]
  },
  "profiling": {
    "collection": {
      "processor_in_timestamp_utc": "2025-10-22 22:57:42.170",
      "processor_out_timestamp_utc": "2025-10-22 22:57:42.170"
    }
  }
}