Skip to main content

Query SEC filing metadata

GET 
/v1/filings

Retrieves metadata for SEC filings based on various filter criteria with pagination and sorting support.

Available Sort Fields​

Field NameDescription
AccessionNumberSEC filing accession number
FilingDateDate when filing was submitted
AcceptanceDateTimeDate and time of filing acceptance
ReportDateDate of the report
SizeSize of the filing document

Date Format​

All dates must be provided in YYYY-MM-DD format

Form Types​

Form types can be provided as comma-separated values, e.g.: "10-K,8-K,10-Q"

tip

For optimal performance, use date ranges and form types to narrow down your search

Request​

Query Parameters

    cik int64

    Filter by Central Index Key (CIK)

    form_type string

    Filter by form type(s) (e.g., "10-K", "8-K"). Multiple values can be comma-separated

    filling_date_start string

    Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    Filter by filling date start (inclusive), format YYYY-MM-DD

    filling_date_end string

    Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    Filter by filling date end (inclusive), format YYYY-MM-DD

    report_date_start string

    Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    Filter by report date start (inclusive), format YYYY-MM-DD

    report_date_end string

    Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    Filter by report date end (inclusive), format YYYY-MM-DD

    items_contain string

    Filter filings where the 'Items' field contains the specified text

    page_size int32

    Possible values: >= 1 and <= 200

    Number of results per page (default: 50, max: 200)

    page_number int32

    Possible values: >= 1 and <= 2147483647

    Page number to retrieve (default: 1)

    sort_by DTO.FilingSortBy

    Possible values: [AccessionNumber, FilingDate, ReportDate, AcceptanceDateTime, Size]

    Field to sort results by (default: AccessionNumber)

    sort_order DTO.SortOrder

    Possible values: [Asc, Desc]

    Sort order (Asc or Desc, default: Desc)

Responses​

Successful operation

Schema

  • Array [

    • cik int64
    accession_number stringnullable
    filing_date date
    report_date datenullable
    acceptance_date_time date-timenullable
    act stringnullable
    form stringnullable
    file_number stringnullable
    film_number stringnullable
    items stringnullable
    core_type stringnullable
    size int32nullable
    is_xbrl booleannullable
    is_inline_xbrl booleannullable
    primary_document stringnullable
    primary_doc_description stringnullable
    source_file stringnullable

  • ]

Loading...