> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Fetch document > Returns a time-limited pre-signed URL for downloading the document in annotated (structured) JSON format. Issuing a GET request to that URL returns the document's content, metadata, and annotations. The URL expires after 24 hours; request a new one when it does. This endpoint works for any document in Bigdata, whether it originates from the RavenPack catalog or from your own processed files. When `web_content` is `true`, the returned document also includes a direct URL to the publisher's original article on the web. ## OpenAPI ````yaml /api-rest/openapi/openapi_search_service.json get /v1/documents/{document_id} openapi: 3.0.3 info: title: Bigdata Search API version: 1.0.0 description: >- Easily find the most relevant information from trusted sources and your own data. Use it to power agents that give accurate, real-time answers. servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] paths: /v1/documents/{document_id}: get: tags: - Search summary: Fetch document description: >- Returns a time-limited pre-signed URL for downloading the document in annotated (structured) JSON format. Issuing a GET request to that URL returns the document's content, metadata, and annotations. The URL expires after 24 hours; request a new one when it does. This endpoint works for any document in Bigdata, whether it originates from the RavenPack catalog or from your own processed files. When `web_content` is `true`, the returned document also includes a direct URL to the publisher's original article on the web. operationId: get_document parameters: - name: document_id in: path required: true description: >- The unique 32-character MD5 hex identifier for the document (e.g., `776769957735667D2F01F695EF4F1231`). schema: type: string pattern: ^[A-F0-9]{32}$ example: 776769957735667D2F01F695EF4F1231 responses: '200': description: >- An object with a url and a web_content field is returned. When web_content is true, the returned document contains a direct link to the original web page in addition to the full analytics. content: application/json: schema: type: object properties: web_content: type: boolean description: true when is a public URL. example: false url: type: string format: uri description: >- When you access the URL, you receive the complete document in JSON format with the structure: document (metadata), content (title and body blocks) and analytics (document-level metrics, events array, entities array). In the case of transcript-style documents, the document metadata includes normalized event context (participants, reporting fields, timestamps_utc). This is available for **Factset** documents, other providers like **Quartr** or **Third Bridge** will be available soon. example: >- https://documents.bigdata.com/documents/776769957735667D2F01F695EF4F1231?signature=abc123... document: description: >- **Returned by URL** - Document metadata including source information, timestamps, and details. allOf: - $ref: '#/components/schemas/Document' content: description: >- **Returned by URL** - Document content including title, body blocks, entities, and sentences. allOf: - $ref: '#/components/schemas/Content' analytics: description: >- **Returned by URL** - Document-level analytics, events array, and entities array. allOf: - $ref: '#/components/schemas/FetchDocumentAnalytics' software_versions: description: >- **Returned by URL** - Optional pipeline build stamps when present. allOf: - $ref: '#/components/schemas/SoftwareVersions' required: - url examples: response: summary: API Response description: >- The endpoint returns a pre-signed URL to download the document. value: url: >- https://documents.bigdata.com/documents/776769957735667D2F01F695EF4F1231?signature=abc123... web_content: false document_from_url: summary: Document (returned by URL) description: >- When you access the URL (when web_content is false), you receive the complete document in JSON format: document metadata, content (title and body blocks) and analytics (document-level metrics, events array, entities array). Same structure as Get Annotated Document; see that endpoint for the full example including TABLE, LIST_ORDERED, LIST_UNORDERED body types and analytics. Transcript-class documents add normalized event context in metadata, such as participants, reporting dates, reporting entities and timestamps_utc. This is available for **Factset** documents, other providers like **Quartr** or **Third Bridge** will be available soon. value: document: rp_document_id: 679A67575E6C04213FB93D29E6AD91BE source: rp_external_source_id: 836C09E6173AAA3DA6A1415030B4EC2D rp_provider_id: FSTR rp_source_id: D4B903 name: Source Name rank: 1 rp_channel_id: 350 timestamps_utc: published: '2026-05-13 18:22:10.000' reception: '2026-05-13 19:05:02.146' analytics: '2026-05-13 19:12:35.698' revision: '2026-05-13 19:12:35.698' metadata: provider_document_id: 8821103:CorrectedTranscript:1002003 revision: chain_id: '8821103' transcript_event_date: '2026-05-13' transcript_event_datetime: '2026-05-13 21:00:00' transcript_event_type: EC transcript_participants: '0': id: '0' value: Speaker 1 (executive) type: corprep title: Chairman & Chief Executive Officer entity: 0D3E4F-E affiliation: Example Sensor Corp. affiliation_entity: 0G5H6J-E rp_company_id: 4ABF38 rp_person_id: D3ROD1 '1': id: '1' value: Speaker 2 (executive) type: corprep title: Chief Financial Officer entity: 0K7L8M-E affiliation: Example Sensor Corp. affiliation_entity: 0G5H6J-E rp_company_id: 4ABF38 rp_person_id: NSTS71 '2': id: '2' value: Speaker 3 (analyst) type: analyst title: Analyst entity: 0N9P0Q-E affiliation: Example Global Partners LLC affiliation_entity: 0R1S2T-E rp_company_id: HY0PTX rp_person_id: 9XQGTC '3': id: '3' value: Speaker 4 (analyst) type: analyst title: Analyst entity: 0U3V4W-E affiliation: Example Markets Inc. affiliation_entity: 0X5Y6Z-E rp_person_id: 4MJHX0 '4': id: '4' value: Speaker 5 (analyst) type: analyst title: Analyst entity: 0A7B8C-E affiliation: Example Research Group LLC affiliation_entity: 0D9E0F-E rp_company_id: DEC521 rp_person_id: KDO4MW software_versions: collection_build: '0' classification_build: '707' metadata_build: '20260513' content: stats: word_count: 8481 byte_count: 1336670 title: text: >- Example Sensor Corp.: Q1 Earnings Call on May 13, 2026 - Transcript sentences: - start: 0 end: 67 sentiment: '0.00' sentiment_confidence: '1.00' entities: - rp_entity_id: 4ABF38 start: 0 end: 20 - rp_entity_id: 5AF7E2 start: 25 end: 33 - rp_entity_id: 3DA2FA start: 42 end: 54 events: - event_similarity_key: A1795745A27ECCF46AC3FA2708032A95 start: 0 end: 54 body: - type: TEXT text: >- Ladies and gentlemen, good day, and welcome to Example Sensor Corp. Q1 FY twenty-six earnings conference call. As a reminder, all participant lines will be in listen-only mode until the Q&A portion. normalized_coordinates: [] sentences: - start: 0 end: 100 sentiment: '0.00' sentiment_confidence: '1.00' - start: 100 end: 198 sentiment: '0.15' sentiment_confidence: '0.73' entities: - rp_entity_id: 5AF7E2 start: 47 end: 67 - rp_entity_id: C408BB start: 22 end: 30 - rp_entity_id: '308257' start: 186 end: 189 analytics: document: analytics_version: '2.0' analytics_revision_number: 0 document_type: TRANSCRIPT-RAW document_record_count: 257 title_similarity_key: 0A4AD1E8BF251E1A90E3B2376E471E07 document_sentiment: 0.21 document_sentiment_confidence: 0.65 composite_sentiment_score: 0.04 sentiment_impact_projection: -0.2 stock_tone_sentiment: 0 earnings_tone_sentiment: 0 commentary_sentiment: 1 mergers_acquisitions_sentiment: 0 corporate_actions_sentiment: 0 earnings_release_sentiment: 0 product_key: EDGE realtime: 'Y' events: - event_similarity_key: E7913FBE641945AC0670EEF684B6D8E0 topic: business group: products-services type: business-contract event_relevance: 77 roles: - rp_entity_id: DD3BB1 category: business-contract fact_level: fact document_record_index: 6 match_type: TEMPLATE event_sentiment: 0.49 event_risk: 0.24 sustainability_sentiment: 0.24 credit_sentiment: 0.25 interest_rate_sentiment: 0 event_detection_distance: 0 event_text: >- Example Sensor Corp.: we entered into new contracts rp_event_detected_entity_id: DD3BB1 event_detected_entity_name: Example Sensor Corp. entities: - rp_entity_id: 4A6F00 entity_type: COMP entity_name: Example Listed Corp. country_code: US document_record_index: 217 entity_hierarchy_level: 1 entity_detection_type: direct entity_detection_distance: 0 entity_relevance: 26 entity_sentiment: 0.25 entity_sentiment_confidence: 0.05 entity_text_sentiment: 0.25 entity_text_sent_confidence: 0.05 analyst_ratings_sentiment: 0 multi_stock_sentiment: 0 '400': description: Invalid document_id '403': description: Access to document denied '404': description: Document not found. components: schemas: Document: type: object description: >- Complete document structure returned when accessing the URL. This is the JSON format used by Bigdata.com for structured document representation. properties: rp_document_id: type: string description: Internal document identifier example: 776769957735667D2F01F695EF4F1231 source: $ref: '#/components/schemas/DocumentSourceDetails' timestamps_utc: $ref: '#/components/schemas/DocumentTimestampsUtc' metadata: $ref: '#/components/schemas/DocumentMetadataDetails' required: - rp_document_id - source - metadata Content: type: object description: >- Structured content extracted from the document including title and body blocks. properties: stats: $ref: '#/components/schemas/ContentStats' title: $ref: '#/components/schemas/ContentTitleBlock' body: $ref: '#/components/schemas/ContentBodyBlock' required: - title - body FetchDocumentAnalytics: type: object description: >- Structured analytics returned when downloading annotated RPJSON from the signed URL. properties: document: $ref: '#/components/schemas/FetchDocumentAnalyticsDocument' events: type: array description: Detected events with scored roles. items: $ref: '#/components/schemas/FetchDocumentAnalyticsEvent' entities: type: array description: Detected entities with document-level relevance and sentiment. items: $ref: '#/components/schemas/FetchDocumentAnalyticsEntity' SoftwareVersions: type: object description: Optional pipeline build stamps included with some document payloads. properties: collection_build: type: string example: '0' classification_build: type: string example: '707' metadata_build: type: string example: '20260513' DocumentSourceDetails: type: object description: Information about the document source. properties: rp_external_source_id: type: string description: External source identifier when the upstream feed exposes one. example: 836C09E6173AAA3DA6A1415030B4EC2D rp_provider_id: type: string description: Short provider code for the originating data partner. example: FSTR rp_source_id: type: string description: Identifier of the source system example: D4B903 name: type: string description: Source display name for the feed or collection example: Source Name rank: type: integer description: Ranking classification of the source. example: 1 rp_channel_id: type: integer description: >- Channel identifier when the document is grouped under a provider channel. example: 350 required: - rp_source_id - name - rank DocumentTimestampsUtc: type: object description: Pipeline timestamps in UTC for the document record. properties: published: type: string description: When the provider published or released the underlying asset. example: '2026-05-13 18:22:10.000' reception: type: string description: When the document was first received into the collection pipeline. example: '2026-05-13 19:05:02.146' analytics: type: string description: When analytics enrichment completed for this revision. example: '2026-05-13 19:12:35.698' revision: type: string description: When this metadata revision was materialized. example: '2026-05-13 19:12:35.698' DocumentMetadataDetails: type: object description: >- Provider and RavenPack metadata carried on the document. Fields are sparse: only subsets apply per document type (news, filings, transcripts, web, etc.). properties: url: type: string format: uri description: >- URL pointing to the original document or asset when the provider exposes one. example: https://cdn.example.com/provider-assets/transcript.json provider_document_id: type: string description: >- Opaque provider document key, often colon-delimited segments (collection, flavor, provider id). example: 8821103:CorrectedTranscript:1002003 media_type: type: string description: MIME type of the canonical payload when known. example: application/json original_language: type: string description: Primary language of the source document. example: en file_name: type: string description: Original file name for uploaded or file-based documents. example: Weekly summary report.pdf content_type: type: string description: >- Legacy or alternate MIME label (for example message/rfc822 for email). example: application/pdf revision: $ref: '#/components/schemas/DocumentRevisionMetadata' transcript_event_date: type: string description: >- Calendar date of the live session or release for transcript-class documents. example: '2026-05-13' transcript_event_datetime: type: string description: Session anchor datetime in the provider or venue timezone context. example: '2026-05-13 21:00:00' transcript_event_type: type: string description: Compact code for the session category (for example earnings call). example: EC transcript_participants: type: object description: Map of string ordinal indexes to participant rows. additionalProperties: $ref: '#/components/schemas/TranscriptParticipant' codes: type: array description: Listing, ISIN, or other security codes when supplied. items: type: string example: - US0000000000 custom: type: object description: >- Provider-specific key-value metadata without a fixed cross-provider schema. additionalProperties: true reporting_period: type: string description: Fiscal reporting label when the session ties to a reporting window. example: FY-2026-Q4 reporting_start_date_utc: type: string description: Inclusive start of the reporting window in UTC when supplied. example: '2026-01-01 00:00:00' reporting_end_date_utc: type: string description: >- Exclusive or inclusive end of the reporting window in UTC when supplied. example: '2026-04-01 00:00:00' reporting_entities: type: array description: Related RavenPack entity identifiers for the reporting view. items: type: string example: - AEB48D - RUHOES - A03871 collection: $ref: '#/components/schemas/DocumentMetadataCollection' provider_primary_entity_id: type: string description: Provider-native primary company identifier for the session. example: '19936' provider_primary_entity_name: type: string description: Provider-native primary company display name. example: Example Company Limited document_type: type: string description: >- Normalized document flavor (for example transcript-raw, transcript-corrected). example: transcript-raw ContentStats: type: object description: Optional size statistics for the document text payload. properties: word_count: type: integer description: Approximate word count for indexed body text. example: 8481 byte_count: type: integer description: Approximate byte size of the serialized content payload. example: 1336670 ContentTitleBlock: type: object description: A title content block representing the title of the document. properties: text: type: string description: Extracted document title example: 'Tesla Inc: Q1 2025 Earnings Call' sentences: type: array description: Index ranges for title text segments items: $ref: '#/components/schemas/Sentence' entities: type: array description: Entities detected inside the title text items: $ref: '#/components/schemas/TextEntity' events: type: array description: >- Optional title-span events with character offsets into the title text. items: $ref: '#/components/schemas/ContentTitleInlineEvent' ContentBodyBlock: type: array description: >- Array of content blocks extracted from the document. Each item represents a block of content such as text paragraphs, tables, or lists. All block types include the common fields defined in ContentBlockCommonFields. items: oneOf: - $ref: '#/components/schemas/TextBlock' - $ref: '#/components/schemas/TableBlock' - $ref: '#/components/schemas/ListBlock' - $ref: '#/components/schemas/HeadingBlock' - $ref: '#/components/schemas/FooterBlock' FetchDocumentAnalyticsDocument: type: object description: Document-level analytics and tone aggregates returned alongside RPJSON. properties: analytics_version: type: string example: '2.0' analytics_revision_number: type: integer example: 0 document_type: type: string description: High-level classified document type for analytics. example: TRANSCRIPT-RAW document_record_count: type: integer description: Count of body records or segments used for analytics. example: 257 title_similarity_key: type: string description: Fingerprint linking this title to similar documents. example: 0A4AD1E8BF251E1A90E3B2376E471E07 document_sentiment: type: number format: float description: Aggregate document sentiment score. example: 0.21 document_sentiment_confidence: type: number format: float description: Confidence for aggregate document sentiment. example: 0.65 composite_sentiment_score: type: number format: float example: 0.04 sentiment_impact_projection: type: number format: float example: -0.2 stock_tone_sentiment: type: integer example: 0 earnings_tone_sentiment: type: integer example: 0 commentary_sentiment: type: integer example: 1 mergers_acquisitions_sentiment: type: integer example: 0 corporate_actions_sentiment: type: integer example: 0 earnings_release_sentiment: type: integer example: 0 product_key: type: string example: EDGE realtime: type: string description: >- Flag indicating whether the document was processed under realtime constraints. example: 'Y' FetchDocumentAnalyticsEvent: type: object description: Detected narrative or business event with scored roles. properties: event_similarity_key: type: string example: E7913FBE641945AC0670EEF684B6D8E0 topic: type: string example: business group: type: string example: products-services type: type: string example: business-contract event_relevance: type: integer example: 77 roles: type: array items: $ref: '#/components/schemas/FetchDocumentAnalyticsEventRole' FetchDocumentAnalyticsEntity: type: object description: Entity-level analytics aggregated across the document. properties: rp_entity_id: type: string example: 4A6F00 entity_type: type: string example: COMP entity_name: type: string example: Example Listed Corp. country_code: type: string example: US document_record_index: type: integer example: 217 entity_hierarchy_level: type: integer example: 1 entity_detection_type: type: string example: direct entity_detection_distance: type: integer example: 0 entity_relevance: type: integer example: 26 entity_sentiment: type: number format: float example: 0.25 entity_sentiment_confidence: type: number format: float example: 0.05 entity_text_sentiment: type: number format: float example: 0.25 entity_text_sent_confidence: type: number format: float example: 0.05 analyst_ratings_sentiment: type: integer example: 0 multi_stock_sentiment: type: integer example: 0 DocumentRevisionMetadata: type: object description: Provider revision lineage for the document. properties: chain_id: type: string description: >- Stable chain identifier for the revision stream (often a provider collection or story id, sometimes with flavor suffixes). example: '8821103' sequence_id: type: string description: >- Monotonic or provider-supplied sequence token within the chain, when present. example: '1777297165000' TranscriptParticipant: type: object description: >- Single speaker row from transcript metadata. Field presence varies by role and resolution quality. properties: id: type: string description: Ordinal id, usually aligned with the map key. example: '0' value: type: string description: Display label for the speaker as delivered by the provider. example: Speaker 1 (executive) type: type: string description: Speaker role class such as operator, corprep, or analyst. example: corprep title: type: string description: Job title when supplied. example: Chief Financial Officer entity: type: string description: Provider-side person or role entity identifier when supplied. example: 0K7L8M-E affiliation: type: string description: Employer or desk label as text. example: Example Sensor Corp. affiliation_entity: type: string description: >- Provider-side identifier for the affiliation organization when distinct from the person entity. example: 0G5H6J-E rp_company_id: type: string description: Resolved RavenPack company identifier when available. example: 4ABF38 rp_person_id: type: string description: Resolved RavenPack person identifier when available. example: NSTS71 rp_position_id: type: string description: Resolved standardized position identifier when available. example: 8FFEEE DocumentMetadataCollection: type: object description: >- Link between RavenPack collection identifiers and the provider collection. properties: rp_collection_id: type: string description: RavenPack collection identifier. example: 5ECE52D55DD6708C90A36D1A5B87B518 provider_collection_id: type: string description: Provider-native collection or listing identifier. example: '538315' Sentence: type: object description: Sentence segmentation information with sentiment analysis. properties: start: type: integer description: Start character index of the sentence. example: 0 end: type: integer description: End character index of the sentence. example: 46 sentiment: type: string description: Sentiment score ranging from -1.00 (negative) to 1.00 (positive). example: '0.01' sentiment_confidence: type: string description: Confidence score for the sentiment analysis (0.00 to 1.00). example: '0.94' required: - start - end TextEntity: type: object description: An entity detected within the text. properties: rp_entity_id: type: string description: Bigdata.com unique entity identifier. example: DD3BB1 name: type: string description: Display name of the entity. example: Tesla Inc type: type: string description: Entity type classification. enum: - COMPANY - PERSON - PLACE - PRODUCT - ORGANIZATION - ETF start: type: integer description: Start character index where the entity appears in the text. example: 0 end: type: integer description: End character index where the entity appears in the text. example: 9 required: - rp_entity_id - start - end ContentTitleInlineEvent: type: object description: Event span anchored on the title text using character indices. properties: event_similarity_key: type: string example: A1795745A27ECCF46AC3FA2708032A95 start: type: integer description: Start character index in the title text. example: 0 end: type: integer description: End character index in the title text. example: 54 TextBlock: title: Paragraph type: object description: >- A text content block representing paragraphs, headings, or other text elements. Includes all fields from ContentBlockCommonFields. allOf: - $ref: '#/components/schemas/ContentBlockCommonFields' TableBlock: title: Table type: object description: >- A table content block. Includes all fields from ContentBlockCommonFields. allOf: - type: object properties: type: type: string description: Table block type. enum: - TABLE rows: type: array description: Row definitions for the table. items: $ref: '#/components/schemas/TableRow' required: - type - rows - $ref: '#/components/schemas/ContentBlockCommonFields' ListBlock: title: List type: object description: >- A list content block (ordered or unordered). Includes all fields from ContentBlockCommonFields. allOf: - type: object properties: type: type: string description: List block type. enum: - LIST_ORDERED - LIST_UNORDERED entries: type: array description: List entries/items. items: $ref: '#/components/schemas/ListEntry' required: - type - entries - $ref: '#/components/schemas/ContentBlockCommonFields' HeadingBlock: title: Heading type: object description: >- A heading content block. Includes all fields from ContentBlockCommonFields. allOf: - type: object properties: type: type: string description: Heading block type. enum: - HEADING required: - type - $ref: '#/components/schemas/ContentBlockCommonFields' FooterBlock: title: Footer type: object description: >- A footer content block. Includes all fields from ContentBlockCommonFields. allOf: - type: object properties: type: type: string description: Footer block type. enum: - FOOTER required: - type - $ref: '#/components/schemas/ContentBlockCommonFields' FetchDocumentAnalyticsEventRole: type: object description: Per-entity role inside a detected document event. properties: rp_entity_id: type: string example: DD3BB1 category: type: string example: business-contract fact_level: type: string example: fact document_record_index: type: integer description: Index of the body record where the role matched. example: 6 match_type: type: string example: TEMPLATE event_sentiment: type: number format: float example: 0.49 event_risk: type: number format: float example: 0.24 sustainability_sentiment: type: number format: float example: 0.24 credit_sentiment: type: number format: float example: 0.25 interest_rate_sentiment: type: number format: float example: 0 event_detection_distance: type: integer example: 0 event_text: type: string description: Supporting snippet for the detected event. example: 'Example Sensor Corp.: we entered into new contracts' rp_event_detected_entity_id: type: string example: DD3BB1 event_detected_entity_name: type: string example: Example Sensor Corp. ContentBlockCommonFields: type: object description: >- Common fields present in all content block types (TextBlock, TableBlock, ListBlock). These fields may appear alongside the block-specific fields. properties: normalized_coordinates: type: array description: Bounding boxes normalized to page dimensions items: $ref: '#/components/schemas/NormalizedCoordinates' text: type: string description: Extracted visible text (if any) example: The first quarter results were announced today. sentences: type: array description: Index ranges for sentence segmentation items: $ref: '#/components/schemas/Sentence' entities: type: array description: Entities detected in the text items: $ref: '#/components/schemas/TextEntity' TableRow: type: object description: A row within a table. properties: cells: type: array description: Cells in the row. items: $ref: '#/components/schemas/TableCell' required: - cells ListEntry: type: object description: An entry within a list. properties: key: type: string description: >- Bullet character for unordered lists (e.g., '•') or list number for ordered lists (e.g., '1'). example: • content: type: array description: Content objects within the list entry. items: $ref: '#/components/schemas/CellContent' required: - key - content NormalizedCoordinates: type: object description: >- Bounding box coordinates normalized to page dimensions (values between 0 and 1). properties: page: type: integer description: Page number (1-indexed). example: 1 x: type: number format: float description: X coordinate (left edge) normalized to page width. example: 0.1 'y': type: number format: float description: Y coordinate (top edge) normalized to page height. example: 0.15 width: type: number format: float description: Width normalized to page width. example: 0.8 height: type: number format: float description: Height normalized to page height. example: 0.05 TableCell: type: object description: A cell within a table row. properties: content: type: array description: Content objects within the cell. items: $ref: '#/components/schemas/CellContent' required: - type - content CellContent: type: object description: Simple text content within a table cell or list entry. properties: text: type: string description: Text content. example: Quarter required: - text securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````