---
title: "Stored SEC filings and earnings call transcripts across the market or for one optional ticker, newest first. Returns company identity, document ids, types, filing/reporting dates, exact SEC item numbers, line counts, EDGAR accession numbers, EDGAR acceptance times and ingestion times."
method: GET
path: "/v1/filings"
tags: ["Filings"]
---

# Stored SEC filings and earnings call transcripts across the market or for one optional ticker, newest first. Returns company identity, document ids, types, filing/reporting dates, exact SEC item numbers, line counts, EDGAR accession numbers, EDGAR acceptance times and ingestion times.

`GET /v1/filings`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/filings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/filings/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `ticker` string
- `documentType` string
- `startDate` string, date
- `endDate` string, date
- `itemNumber` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- FilingDtoPagedResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` FilingDto[], nullable
    - `id` string, uuid
    - `ticker` string, nullable
    - `companyName` string, nullable
    - `documentType` string, nullable
    - `documentTypeName` string, nullable
    - `filedDate` string, date
    - `summary` string, nullable
    - `reportingForDate` string, date, nullable
    - `itemNumbers` string[], nullable
    - `lineCount` integer
    - `accessionNumber` string, nullable
    - `acceptedAt` string, date-time, nullable
    - `ingestedAt` string, date-time
    - `url` string, nullable
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)