Retrieve a filing

Returns a filing published alongside an earnings call, such as an 8-K earnings release, a 10-Q quarterly report, or a 10-K annual report.

The response includes file metadata and a signed url on content.roic.ai. You can download the file directly without API credentials. The link expires at expires_at, one hour after your request. Call the endpoint again to get a new link.

Take the doc_ id from the filings array of the call listing. Slide decks share the doc_ prefix, so a slides id on this route returns 404. Filings require a Professional or Enterprise plan.

GET/v3.0.0/documents/filings/{id}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

Not included

Individual

$29/mo

Not included

Professional

$89/mo

All available

Request
curl "https://api.roic.ai/v3.0.0/documents/filings/doc_4JlukNobJIA1qj?apikey=YOUR_API_KEY"
Response
200 OK
{
  "id": "doc_4JlukNobJIA1qj",
  "event": "evt_hbBlbCUawzMoz0",
  "symbol": "NASDAQ:AAPL",
  "fiscal_year": 2026,
  "fiscal_quarter": 3,
  "period_end_date": "2026-06-30",
  "filename": "NASDAQ-AAPL_earnings-release-8-K_2026-06-30_FY2026-Q3_doc_4JlukNobJIA1qj.pdf",
  "url": "https://content.roic.ai/filings/file_TT9sRXWctFsOz5.pdf?filename=NASDAQ-AAPL_earnings-release-8-K_2026-06-30_FY2026-Q3_doc_4JlukNobJIA1qj.pdf&verify=1758031446-<mac>",
  "expires_at": "2026-09-16T14:04:06.755Z",
  "form": "8-K",
  "document_group": "earnings",
  "document_kind": "earnings_release",
  "language": "en",
  "created_at": "2026-07-30T21:10:12.004Z",
  "updated_at": "2026-08-01T04:22:31.884Z"
}

Parameters

Path parameters

idstringrequired

The document id from the filings array of the event listing, beginning with doc_. A slide-deck id on this route returns 404.

Example: doc_4JlukNobJIA1qj

Response

Response fields

idstring

Unique identifier for the file. doc_ for a slide deck or a filing.

eventstring

Identifier of the parent event, beginning with evt_.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL. It names the primary listing of the event.

fiscal_yearnumber

Fiscal year the event reports on, e.g. 2026. The fiscal year is the calendar year in which it ends. null when the period is not known.

fiscal_quarternumber

Fiscal quarter the event reports on, from 1 to 4. null for an annual period and when the quarter is not known. If the company reports semiannually, the first half is 2 and the second half is 4.

period_end_datestring

Last day of the reporting period, in YYYY-MM-DD format.

filenamestring

Download name of the file. The fiscal label appears only when the period is certain, and the language code only when the file is not in English.

urlstring

Signed download link on content.roic.ai. Fetch it directly, without API credentials, and send it exactly as returned.

expires_atstring

ISO 8601 timestamp after which url stops working, one hour after the request by default. Call the route again for a new link.

formstring

Regulatory code of the filing, e.g. 8-K, 10-Q, 10-K, 6-K or 20-F. null when the filing carries no regulatory code.

document_groupstring

Bucket the filing falls in, for filtering: earnings, financial_report, regulatory, sustainability or other.

document_kindstring

The filing named the way the industry does, e.g. earnings_release, quarterly_report or annual_report. A filing we cannot type lands on other.

languagestring

Two-letter language code of the file, e.g. en. null when it is not known.

created_atstring

ISO 8601 UTC timestamp of when this file was first stored.

updated_atstring

ISO 8601 UTC timestamp of when this file last changed.

Document typing

document_kind names the document the way the industry does and document_group is the bucket above it, for filtering. form is the regulatory code when there is one: a 10-K, a 20-F and a 40-F are all annual_report, and only form tells them apart. A document we cannot type lands on the other group with the other kind.

document_groupdocument_kind
earningsearnings_release, shareholder_letter
financial_reportannual_report, quarterly_report, interim_report, financial_statements, management_discussion_analysis
presentationpresentation
regulatoryproxy_statement, registration_statement
sustainabilitysustainability_report, governance_report
otherpress_release

Errors

StatuscodeWhen it happens
400invalid_parameterA malformed id.
402document_restrictedThe key is below the Professional plan.
404resource_missingNo filing with that id, including a slides id.