Search Codal disclosures
cd_search_lettersSearch Codal disclosure letters from Iranian listed companies by symbol, title, date, category, or tracing number, returning newest results first with pagination.
Instructions
Search codal.ir disclosures (letters) of Iranian listed companies, newest first, 20 per page.
No filters lists the newest letters of all companies. total = matches, pages = page count. Pass a
letter's tracing_no to cd_letter to read it. No results: check the symbol with cd_company or widen filters.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "cd_search_letters"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page (20 letters). | |
| title | No | Persian words in the letter title, e.g. افزایش سرمایه. | |
| symbol | No | Exact Persian trading symbol, e.g. فولاد (find with cd_company). | |
| to_date | No | Sent on/before this Jalali date. | |
| category | No | Letter group: 1 financial statements, dividend schedules; 2 material info, clarifications; 3 monthly activity, portfolios; 4 articles, prospectuses; 5 board, audit committee; 6 shareholder meetings; 7 capital increase; 8 exchange notices; 9 SEO notices; 10 other; 11 debt securities. | |
| from_date | No | Sent on/after this Jalali date, e.g. 1405/07/01. | |
| tracing_no | No | Tracing number (شماره پیگیری) of one letter. | |
| letter_type | No | Letter type id from cd_letter_types, e.g. 6 financial statements, 58 monthly activity, 20 AGM decisions, 30 dividend schedule. | |
| period_months | No | Report period in months: 12 annual, 6 half-year, 3 quarterly, 1 monthly. |