> ## Documentation Index > Fetch the complete documentation index at: https://docs.captide.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Document by ID > Fetch a document by its ID from the database, including company and ticker info. This v2 endpoint includes several improvements over v1: - Supports newer document categories (e.g., earnings-presentation, investor-event-presentation, shareholder-meeting-circular, etc.) - Renamed fields: tickers → companyTickers, formType → secFormType - Added fields: companyId, fiscalPeriod, language ## OpenAPI ````yaml GET /api/v2/documents/{id} openapi: 3.1.0 info: title: Captide REST API description: >- API for accessing financial disclosures and AI-powered financial document analysis. version: 0.3.13 servers: - url: https://rest-api.captide.co description: Prod server security: [] paths: /api/v2/documents/{id}: get: tags: - Documents summary: Get document by ID (v2) description: >- Fetch a document by its ID from the database, including company and ticker info. This v2 endpoint includes several improvements over v1: - Supports newer document categories (e.g., earnings-presentation, investor-event-presentation, shareholder-meeting-circular, etc.) - Renamed fields: tickers → companyTickers, formType → secFormType - Added fields: companyId, fiscalPeriod, language operationId: get_document_by_id_api_v2_documents__id__get parameters: - name: id in: path required: true schema: type: string format: uuid description: Document file ID examples: - a586df65-76d8-4b04-864c-ceed76592f4d title: Id description: Document file ID responses: '200': description: Document found successfully content: application/json: schema: $ref: '#/components/schemas/DocumentResponseV2' examples: document: summary: Example document response value: id: a586df65-76d8-4b04-864c-ceed76592f4d documentCategory: interim-financial-report title: First Quarter Report for period ending 31 March 2025 description: >- This document is the First Quarter Report of Santos Limited for the period ending 31 March 2025. date: '2025-04-17' fiscalQuarter: 1 fiscalYear: 2025 fiscalPeriod: quarter language: en companyId: 77848abe-a215-41b7-8950-86e89ea1fadc companyName: Santos companyTickers: - STO.AX originalFileUrl: https://files.captide.co/original-docs/... markdownFileUrl: https://files.captide.co/markdown-docs/... metadata: {} '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - APIKeyHeader: [] components: schemas: DocumentResponseV2: properties: id: type: string title: Id description: Unique document ID documentCategory: type: string title: Documentcategory description: >- Document category code as stored in the database. For detailed category descriptions, please refer to [this page](/coverage). secFormType: anyOf: - type: string - type: 'null' title: Secformtype description: >- Document SEC form type (only applicable if the document is an SEC filing) title: anyOf: - type: string - type: 'null' title: Title description: Captide-generated document title description: anyOf: - type: string - type: 'null' title: Description description: Captide-generated document description date: anyOf: - type: string - type: 'null' title: Date description: >- Date the document relates to (e.g., the press release date for a current report, or the fiscal period end date for annual and interim reports) fiscalQuarter: anyOf: - type: integer - type: 'null' title: Fiscalquarter description: Fiscal quarter the document relates to (from 1 to 4) fiscalYear: anyOf: - type: integer - type: 'null' title: Fiscalyear description: Fiscal year the document relates to (e.g., 2024) fiscalPeriod: anyOf: - type: string - type: 'null' title: Fiscalperiod description: >- Fiscal period the document relates to. Valid values: `year`, `multi-year`, `month`, `half-year`, `quarter`, or null language: anyOf: - type: string - type: 'null' title: Language description: Language of the document in ISO 639-1 code companyId: type: string title: Companyid description: Unique ID of the company filing the document companyName: anyOf: - type: string - type: 'null' title: Companyname description: Name of the company filing the document companyTickers: items: type: string type: array title: Companytickers description: Tickers of the company filing the document originalFileUrl: type: string title: Originalfileurl description: >- Secure and temporary URL providing access to the original document file markdownFileUrl: type: string title: Markdownfileurl description: >- Secure and temporary URL providing access to the pre-processed, machine-readable document file metadata: additionalProperties: true type: object title: Metadata description: Additional document metadata (e.g., accessionNumber, 8kItems) type: object required: - id - documentCategory - companyId - originalFileUrl - markdownFileUrl title: DocumentResponseV2 description: >- V2 response model for document retrieval by ID. Uses database category codes directly. ErrorResponse: properties: detail: type: string title: Detail type: object required: - detail title: ErrorResponse description: Standard error response model for all API endpoints. securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````