---
title: "Company Document Lookup"
method: GET
path: "/api/v2/documents"
tags: ["Documents"]
---

# Company Document Lookup

`GET /api/v2/documents`

Retrieve paginated list of documents for a specific company, optionally filtered by quarter and filing type. Use `calendar_quarters` or `fiscal_quarters` (repeatable, mutually exclusive) to filter on one or more quarters; `fiscal_quarters` are translated to the company's calendar quarters before filtering. The legacy `period` and `periods` parameters are deprecated and fold into `calendar_quarters`. Each document in the response carries both `calendar_quarter` and `fiscal_quarter`. Results are ordered by filing date descending.

## Query parameters

- `calendar_quarters` string[]
- `company_id` integer, required
- `filing_type` '10-K' | '10-Q' | '8-K' | 'News Article' | 'Other' | 'Transcript'
- `fiscal_quarters` string[]
- `has_fundamentals` boolean
- `limit` integer
- `offset` integer
- `period` string
- `periods` string[]

## Response `200`

- PaginatedDocumentMetadataList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` DocumentMetadata[], required
    - `document_id` integer, required — Unique document identifier
    - `filing_date` string, date, nullable, required — Date when the filing was reported
    - `filing_type` string, nullable, required — Type of Filing (e.g., '10-Q', '10-K')
    - `document_type` string, nullable, required — Document type classification
    - `filing_uid` string, nullable, required — SEC filing unique identifier
    - `period` string, nullable, required — Deprecated: use `calendar_quarter`. Calendar quarter in YYYYQ# format.
    - `calendar_quarter` string, nullable, required — Calendar quarter for the document in YYYYQ# format.
    - `fiscal_quarter` string, nullable, required — Fiscal quarter for the document in YYYYQ# format.

## Other responses

- `400`
- `401`
- `403`
- `429`
- `500`

---

[API](https://skmtc.net/daloopa/apis/daloopa-api.md) · [All operations](https://skmtc.net/daloopa/apis/daloopa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daloopa/daloopa-api/versions/746538a1eb45/schema)