> ## 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.

# Find Documents

> Find documents (filings, reports, presentations, transcripts and other disclosures) by company, category, SEC form type, fiscal period, date range, or text in the title and description.

    Returns each document's metadata and `id`; use `GET /api/v2/documents/{id}` to get links to its files. Results are newest first by default; page through them with `limit` and `offset`.



## OpenAPI

````yaml GET /api/v2/documents/list
openapi: 3.1.0
info:
  title: Captide REST API
  description: >-
    API for accessing financial disclosures and AI-powered financial document
    analysis.
  version: 0.3.14
servers:
  - url: https://rest-api.captide.co
    description: Prod server
security: []
paths:
  /api/v2/documents/list:
    get:
      tags:
        - Documents
      summary: List documents
      description: >-
        Find documents (filings, reports, presentations, transcripts and other
        disclosures) by company, category, SEC form type, fiscal period, date
        range, or text in the title and description.

            Returns each document's metadata and `id`; use `GET /api/v2/documents/{id}` to get links to its files. Results are newest first by default; page through them with `limit` and `offset`.
      operationId: list_documents_api_v2_documents_list_get
      parameters:
        - name: documentCategories
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated list of document categories. For detailed
              descriptions, please refer to [this page](/coverage).


              Valid values: `annual-financial-report`,
              `interim-financial-report`, `financial-attachments`,
              `annual-activity-report`, `interim-activity-report`,
              `compliance-report`, `historical-performance-summary`,
              `earnings-release`, `current-report`, `letter-to-shareholders`,
              `earnings-presentation`, `earnings-call-transcript`,
              `investor-event-presentation`, `investor-event-transcript`,
              `conference-transcript`, `shareholder-meeting-circular`,
              `shareholder-meeting-resolutions`,
              `shareholder-meeting-transcript`, `governance-report`,
              `compensation-report`, `governance-policies`, `esg-report`,
              `esg-assessment`, `insider-share-transactions`,
              `shareholder-dealing-disclosure`,
              `beneficial-ownership-disclosure`,
              `institutional-holdings-disclosure`, `share-issuance-notice`,
              `share-buyback-notice`, `share-capital-disclosure`,
              `initial-offering-prospectus`, `follow-on-offering-prospectus`,
              `merger-offering-prospectus`, `employee-share-plan-prospectus`,
              `tender-offer-disclosure`, `going-private-statement`,
              `termination-of-registration`, `other`.


              Legacy codes such as `annual-report` or `interim-report` are also
              accepted.
            examples:
              - >-
                annual-financial-report,interim-financial-report,earnings-release
            title: Documentcategories
          description: >-
            Comma-separated list of document categories. For detailed
            descriptions, please refer to [this page](/coverage).


            Valid values: `annual-financial-report`, `interim-financial-report`,
            `financial-attachments`, `annual-activity-report`,
            `interim-activity-report`, `compliance-report`,
            `historical-performance-summary`, `earnings-release`,
            `current-report`, `letter-to-shareholders`, `earnings-presentation`,
            `earnings-call-transcript`, `investor-event-presentation`,
            `investor-event-transcript`, `conference-transcript`,
            `shareholder-meeting-circular`, `shareholder-meeting-resolutions`,
            `shareholder-meeting-transcript`, `governance-report`,
            `compensation-report`, `governance-policies`, `esg-report`,
            `esg-assessment`, `insider-share-transactions`,
            `shareholder-dealing-disclosure`, `beneficial-ownership-disclosure`,
            `institutional-holdings-disclosure`, `share-issuance-notice`,
            `share-buyback-notice`, `share-capital-disclosure`,
            `initial-offering-prospectus`, `follow-on-offering-prospectus`,
            `merger-offering-prospectus`, `employee-share-plan-prospectus`,
            `tender-offer-disclosure`, `going-private-statement`,
            `termination-of-registration`, `other`.


            Legacy codes such as `annual-report` or `interim-report` are also
            accepted.
        - name: secFormTypes
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated list of SEC form types, as EDGAR names them (exact
              match; amendments end in `/A`). Only SEC filings have one;
              `filesWithSec` on `/api/v2/companies/list` says whether a company
              files with the SEC, and each document's `secFormType` shows the
              name to use.


              Common types: annual and interim reports `10-K`, `10-Q`, `20-F`,
              `40-F`; current reports `8-K`, `6-K`; proxies `DEF 14A`,
              `DEFA14A`; registrations and prospectuses `S-1`, `S-3`, `S-4`,
              `S-8`, `F-1`, `F-3`, `F-4`, `424B4`; institutional holdings
              `13F-HR`, `13F-HR/A`, `13F-NT`; beneficial ownership `SC 13D`, `SC
              13G` (filed as `SCHEDULE 13D` and `SCHEDULE 13G` since December
              2024); deregistrations `15-12B`, `15-12G`, `15-15D`; insider
              transactions `3`, `4`
            examples:
              - 10-K,10-Q
            title: Secformtypes
          description: >-
            Comma-separated list of SEC form types, as EDGAR names them (exact
            match; amendments end in `/A`). Only SEC filings have one;
            `filesWithSec` on `/api/v2/companies/list` says whether a company
            files with the SEC, and each document's `secFormType` shows the name
            to use.


            Common types: annual and interim reports `10-K`, `10-Q`, `20-F`,
            `40-F`; current reports `8-K`, `6-K`; proxies `DEF 14A`, `DEFA14A`;
            registrations and prospectuses `S-1`, `S-3`, `S-4`, `S-8`, `F-1`,
            `F-3`, `F-4`, `424B4`; institutional holdings `13F-HR`, `13F-HR/A`,
            `13F-NT`; beneficial ownership `SC 13D`, `SC 13G` (filed as
            `SCHEDULE 13D` and `SCHEDULE 13G` since December 2024);
            deregistrations `15-12B`, `15-12G`, `15-15D`; insider transactions
            `3`, `4`
        - name: companyTickers
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated list of tickers of the companies filing the
              documents (supports both base tickers like 'ITX' and suffixed
              tickers like 'ITX.MC')
            examples:
              - STO.AX,ASML.AS
            title: Companytickers
          description: >-
            Comma-separated list of tickers of the companies filing the
            documents (supports both base tickers like 'ITX' and suffixed
            tickers like 'ITX.MC')
        - name: companyIds
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated list of unique IDs of the companies filing the
              documents. Use /api/v2/companies/list to find the company ID
            examples:
              - >-
                77848abe-a215-41b7-8950-86e89ea1fadc,91f6c6da-478f-4161-b451-aa5177cc7fb9
            title: Companyids
          description: >-
            Comma-separated list of unique IDs of the companies filing the
            documents. Use /api/v2/companies/list to find the company ID
        - name: fiscalQuarter
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 4
                minimum: 1
              - type: 'null'
            description: Fiscal quarter to filter documents (1-4)
            examples:
              - 1
            title: Fiscalquarter
          description: Fiscal quarter to filter documents (1-4)
        - name: fiscalYear
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Fiscal year to filter documents (e.g., 2024)
            examples:
              - 2024
            title: Fiscalyear
          description: Fiscal year to filter documents (e.g., 2024)
        - name: startDate
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Start date for filtering documents (ISO 8601 format)
            examples:
              - '2025-01-01'
            title: Startdate
          description: Start date for filtering documents (ISO 8601 format)
        - name: endDate
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: End date for filtering documents (ISO 8601 format)
            examples:
              - '2025-12-31'
            title: Enddate
          description: End date for filtering documents (ISO 8601 format)
        - name: limit
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 1000
                minimum: 1
              - type: 'null'
            description: Maximum number of records to return
            examples:
              - 100
            default: 100
            title: Limit
          description: Maximum number of records to return
        - name: offset
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
            description: Number of records to skip (for pagination)
            examples:
              - 0
            default: 0
            title: Offset
          description: Number of records to skip (for pagination)
        - name: sortBy
          in: query
          required: false
          schema:
            enum:
              - date
              - name
            type: string
            description: >-
              Field to sort by: `date` (effective date, default) or `name`
              (document title)
            default: date
            title: Sortby
          description: >-
            Field to sort by: `date` (effective date, default) or `name`
            (document title)
        - name: sortOrder
          in: query
          required: false
          schema:
            enum:
              - asc
              - desc
            type: string
            description: 'Sort direction: `desc` (default) or `asc`'
            default: desc
            title: Sortorder
          description: 'Sort direction: `desc` (default) or `asc`'
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
              - type: 'null'
            description: >-
              Free-form text search across document title and description
              (full-text search)
            examples:
              - annual earnings report
            title: Query
          description: >-
            Free-form text search across document title and description
            (full-text search)
      responses:
        '200':
          description: Documents matching the filters, newest first by default
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DocumentListResponse'
                title: Response List Documents Api V2 Documents List Get
              example:
                - id: 97ac0c55-7349-46ec-8670-92f8524f5294
                  documentCategory: interim-financial-report
                  title: Third Quarter Report
                  description: >-
                    Santos Limited third quarter report for the period ending 30
                    September 2026, summarising record quarterly production and
                    free cash flow, operational performance across assets
                    (including Barossa, Pikka and PNG LNG), sales and pricing,
                    updated 2026 guidance and project developments.
                  date: '2026-10-22'
                  fiscalQuarter: 3
                  fiscalYear: 2026
                  fiscalPeriod: quarter
                  language: en
                  companyId: 77848abe-a215-41b7-8950-86e89ea1fadc
                  companyName: Santos Ltd.
                  companyTickers:
                    - STO.AX
                  metadata: {}
        '400':
          description: Invalid request parameters
          content:
            application/json:
              examples:
                invalid_category:
                  summary: 'Invalid document categories: annual-reports'
                  value:
                    detail: 'Invalid document categories: annual-reports'
                invalid_company_id:
                  summary: >-
                    Invalid company ID format: badly formed hexadecimal UUID
                    string
                  value:
                    detail: >-
                      Invalid company ID format: badly formed hexadecimal UUID
                      string
                invalid_date:
                  summary: >-
                    Invalid startDate format. Use ISO 8601 format (e.g.,
                    2024-12-12T15:00:00Z)
                  value:
                    detail: >-
                      Invalid startDate format. Use ISO 8601 format (e.g.,
                      2024-12-12T15:00:00Z)
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              examples:
                missing_key:
                  summary: Missing API key
                  value:
                    detail: Missing API key
                invalid_key:
                  summary: Invalid or expired API key
                  value:
                    detail: Invalid or expired API key
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Your organization doesn't have access to this endpoint
          content:
            application/json:
              examples:
                forbidden:
                  summary: Access to this endpoint is not allowed for your organization
                  value:
                    detail: >-
                      Access to this endpoint is not allowed for your
                      organization
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: >-
            Validation error: a parameter or body field is missing, has the
            wrong type or is out of range
          content:
            application/json:
              example:
                detail:
                  - type: less_than_equal
                    loc:
                      - query
                      - limit
                    msg: Input should be less than or equal to 1000
                    input: '5000'
                    ctx:
                      le: 1000
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              examples:
                rate_limited:
                  summary: 'Rate limit exceeded: 100 requests per minute'
                  value:
                    detail: 'Rate limit exceeded: 100 requests per minute'
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                database_error:
                  summary: Database error occurred
                  value:
                    detail: Database error occurred
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - APIKeyHeader: []
components:
  schemas:
    DocumentListResponse:
      properties:
        id:
          type: string
          title: Id
          description: >-
            Document ID. Use it with `GET /api/v2/documents/{id}`; chunks, agent
            sources and webhooks return the same 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 of the document: the EDGAR filing date for SEC filings,
            otherwise the date the document was issued or published. When the
            document has no date of its own, the date it was published online.
        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
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: >-
            Additional document metadata: `accessionNumber` and `8kItems` for
            SEC filings, and `sourceUrl`, the document's original address, for
            SEC filings and investor-relations documents
      type: object
      required:
        - id
        - documentCategory
        - companyId
      title: DocumentListResponse
      description: Response model for document list results.
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Standard error response model for all API endpoints.
    ValidationErrorResponse:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationErrorItem'
          type: array
          title: Detail
      type: object
      required:
        - detail
      title: ValidationErrorResponse
      description: '422 body: every invalid field of the request.'
    ValidationErrorItem:
      properties:
        type:
          type: string
          title: Type
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Loc
        msg:
          type: string
          title: Msg
        input:
          anyOf:
            - {}
            - type: 'null'
          title: Input
        ctx:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Ctx
      type: object
      required:
        - type
        - loc
        - msg
      title: ValidationErrorItem
      description: One invalid field, as FastAPI reports it.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.