---
title: "SEC EDGAR Filing Event"
method: POST
path: "/us/sec/filing-event/v1"
tags: ["United States", "SEC EDGAR"]
---

# SEC EDGAR Filing Event

`POST /us/sec/filing-event/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/sec/filing-event/v1`
- Auth: HTTP bearer

Resolve one event filing by its EDGAR accession number and return it once per filer on it (a 13D's filer and the company it covers, a merger's two sides), each with the filer's EIN, state of incorporation and tickers. `found: false` when the accession number is not an event filing since 2020. Served by Croma (`as_of` says how current the data is), brought up to date daily.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `accession_number` string, required: Número de acceso de EDGAR del filing, p. ej. `0001587468-26-000001`.

## Response `200`

Successful response

- SecFilingEventResponse
  - `data` SecFilingEventData, required
    - `found` boolean, required
    - `accession_number` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `filing_events` object[], required: The filing once per filer on it: a 13D's filer and its subject, a merger's two sides.
      - `id` string, required: `<accession_number>:<cik>`: the filing, for one of its filers.
      - `accession_number` string, required: EDGAR's accession number of the filing, e.g. `0001193125-26-012345`.
      - `cik` string, required: The filer this row is for, without leading zeros.
      - `form` string, required: The form type exactly as EDGAR spells it: `8-K`, `8-K/A`, `S-4`, `425`, `25-NSE`, `15-12B`, `SC 13D`, `SCHEDULE 13D`, `NT 10-K`, ...
      - `event_type` 'current_report' | 'merger_or_acquisition' | 'delisting_or_deregistration' | 'registration' | 'late_filing_notice' | 'beneficial_ownership', required: What kind of event the form is.
      - `filed_on` string, required: `yyyy-mm-dd`, the filing's official date.
      - `report_date` string, nullable, required: `yyyy-mm-dd` of the event reported, when the form gives one.
      - `accepted_at` string, nullable, required: When EDGAR accepted the filing.
      - `act` string, nullable, required: The securities act the filing is under, e.g. `34`, `33`.
      - `file_number` string, nullable, required: The SEC file number the filing is under for this filer, e.g. `001-36743`.
      - `film_number` string, nullable, required
      - `items` string[], required: For an 8-K, the items reported: `1.01` material agreement, `1.03` bankruptcy, `2.01` acquisition completed, `2.02` results, `3.01` delisting notice, `5.02` officer or director change, `9.01` exhibits, ...
      - `core_type` string, nullable, required
      - `size` integer, nullable, required: The filing's size in bytes.
      - `is_xbrl` boolean, required
      - `is_inline_xbrl` boolean, required
      - `primary_document` string, nullable, required: The file name of the filing's main document.
      - `primary_document_description` string, nullable, required
      - `filing_url` string, required: The filing's index page on EDGAR.
      - `source_document_url` string, nullable, required: The filing's main document on EDGAR.
      - `company` object, nullable, required: The filer as EDGAR holds it today: name, EIN, state of incorporation, tickers.
        - `cik` string, required
        - `name` string, nullable, required
        - `entity_type` string, nullable, required
        - `ein` string, nullable, required
        - `state_of_incorporation` string, nullable, required
        - `sic` string, nullable, required
        - `sic_description` string, nullable, required
        - `tickers` string[], required
        - `exchanges` string[], required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)