Search codal.ir disclosures (letters) of Iranian listed companies, newest first, 20 per page.

Use it for "latest letters of a company", financial statements, monthly reports, meeting decisions, dividend schedules or capital increases. With no filters it lists the newest letters of all companies. Combine filters to narrow down; total is the number of matching letters and pages the number of pages (pass page for more). Each letter has its tracing_no: pass it to cd_letter to read the letter's text and tables and get its PDF, Excel and attachment links. files lists what the letter has. Dates and times are Jalali (Tehran time). No results: check the symbol with cd_company, widen the dates or drop a filter.

Read one codal.ir letter: its text or tables, plus links to its page, PDF, Excel and attachments.

Use it after cd_search_letters to see what a letter says. Structured reports (financial statements, monthly activity reports) come back as tables, one line per row with cells separated by ' | ' (amounts as on the site, usually million Rial; see unit_note). Financial statements show one sheet at a time: sheets lists them (income statement, balance sheet, cash flows ...); call again with sheet to read another. Other letters come back as text. attachments are files the company attached (often the real content of an explanation letter). Long letters are cut at 16,000 characters (truncated); the PDF link has the full letter.

Find companies and funds on codal.ir by symbol or name, with their market, industry and type.

Use it to get the exact symbol for cd_search_letters and cd_financial_years, or to answer what a symbol is. Exact symbol or name matches come first, then symbols starting with the query, then names containing it; within each, exchange-listed companies before unlisted ones. Covers the ~5,400 publishers on codal.ir, including unlisted companies and funds. matched is the total number of hits.

List codal.ir letter groups, or the letter types of one group with the ids cd_search_letters takes.

Call it without arguments for the 11 groups, then with category for that group's letter types. Use the id of a type as letter_type in cd_search_letters (with or without the same category).

List the fiscal year-end dates codal.ir knows for one company, newest first (Jalali).

Use it to learn when a company's fiscal year ends (e.g. 12/29 or 03/31) before searching for its annual statements with cd_search_letters (from_date after the year end, period_months 12). An empty list usually means the symbol is wrong: check it with cd_company.