GET https://api.bertei.net/ticker_map.json

ticker_map does not require an API key and does not count as an API request

POST https://api.bertei.net/summary

summary requests can batch up to 100 filings, using only 1 API request

POST https://api.bertei.net/full

full requests are always limited to 1 filing per request due to their larger size

For /summary and /full, add both of these headers to every request:

x-api-key: YOUR_API_KEY
Content-Type: application/json

The request body is always a JSON array. Here’s an example for /summary:

[
  {
    "source": "sec",
    "company_code": ["0000320193", "0000789019"],
    "form_type": ["10-K", "10-Q"], // optional
    "limit": 2,                    // optional
    "before_date": "2023-12-31"    // optional
  }
]

source currently supports sec only. More coming soon (edinet/japan next).
company_code is an array of codes (for sec, use 10-digit CIKs). Max 100 companies for /summary and 1 for /full.
form_type specifies filing type. For sec, supported form types are: 10-Q quarterly, 10-K annual, 20-F foreign annual, 40-F canadian annual. Omitting this defaults to all available form types.
limit controls how many filings you get per company. Max 100 for /summary and 1 for /full. Note that total filings per request (number of company codes * limit) is max 100 for /summary. Omitting this defaults to 1.
after_date returns filings which have a filing date on or after specified date in yyyy-mm-dd format.
before_date returns filings which have a filing date on or before specified date in yyyy-mm-dd format.
Requests cannot contain both after_date and before_date, only one or the other. Omitting a date defaults to most recent filings (before current date).

Here’s an example for /full:

[
  {
    "source": "sec",
    "company_code": ["0000320193"],
    "form_type": ["10-K"],         // optional
    "after_date": "2022-01-01",    // optional
  }
]

/full requires exactly one company code (as an array). The limit is always 1. Other fields work the same as /summary.