# EDGAR fillings (New)

The EDGAR fillings endpoint provides access to a comprehensive collection of financial documents submitted to the SEC, including real-time and historical forms, filings, and exhibits. Users can retrieve detailed information about company disclosures, financial statements, and regulatory submissions, enabling them to access essential compliance and financial data directly from the SEC's EDGAR system.

**API credits cost:** `50` per request

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  The ticker symbol of an instrument for which data is requested


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `exchange` (string, optional)
  Filter by exchange name


- `mic_code` (string, optional)
  Filter by market identifier code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `form_type` (string, optional)
  Filter by form types, example `8-K`, `EX-1.1`


- `filled_from` (string, optional)
  Filter by filled time from


- `filled_to` (string, optional)
  Filter by filled time to


- `page` (integer, optional)
  Page number


- `page_size` (integer, optional)
  Number of records in response


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the company and listing
  - `symbol` (string)
    Ticker of the company
  - `exchange` (string)
    Exchange name where the company is listed
  - `mic_code` (string)
    Market Identifier Code (MIC) under ISO 10383 standard
  - `type` (string)
    Issue type of the stock

- `values` (array of object)
  List of filings
  - `cik` (integer)
    CIK code
  - `filed_at` (integer)
    Filing date in UNIX timestamp
  - `files` (array of object)
    Filing files
    - `name` (string)
      File name
    - `size` (integer)
      File size
    - `type` (string)
      File type
    - `url` (string)
      File full url
  - `filing_url` (string)
    Full URL of the filing
  - `form_type` (string)
    Filing form type
  - `ticker` (array of string)
    Ticker symbols associated with the filing


## Example Request

```bash
curl "https://api.twelvedata.com/edgar_filings/archive?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "exchange": "NASDAQ",
        "mic_code": "XNGS",
        "type": "Common Stock"
    },
    "values": [
        {
            "cik": 1711463,
            "filed_at": 1726617600,
            "files": [
                {
                    "name": "primary_doc.html",
                    "size": 2980,
                    "type": "144",
                    "url": "https://www.sec.gov/Archives/edgar/data/1711463/000197185724000581/primary_doc.xml"
                }
            ],
            "filing_url": "https://www.sec.gov/Archives/edgar/data/1711463/0001971857-24-000581-index.htm",
            "form_type": "144",
            "ticker": [
                "AAPL"
            ]
        }
    ]
}
```