OpenInfo APInew.openinfo.uz ↗
Access issuer profiles, financial reports, dividends, material facts, and securities data for Uzbekistan-listed companies via the OpenInfo.uz API.
What is the OpenInfo API?
The OpenInfo.uz API exposes 8 endpoints covering Uzbekistan's corporate disclosure portal, giving programmatic access to issuer profiles, financial statements, dividend records, and material facts for publicly registered companies. The search_issuers endpoint lets you find any registered entity by name, TIN, or ticker, returning the issuer_id that unlocks all downstream endpoints. Response fields include ISINs, tickers, balance sheet line items, and structured fact body data drawn directly from the portal.
curl -X GET 'https://api.parse.bot/scraper/32945961-a59d-4475-af03-0296aa7b1433/search_issuers?query=Hamkorbank' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for issuers (emitents) on the portal by name, TIN/ИНН, or ticker. Supports filtering to listed companies only. Returns paginated results with basic issuer metadata. Each result includes issuer_id for use in other endpoints.
| Param | Type | Description |
|---|---|---|
| tin | string | ИНН/TIN of the issuer for precise lookup. 9-digit numeric string. |
| page | integer | Page number for pagination. |
| query | string | Name substring to search for (company name in any language). |
| ticker | string | Exchange ticker symbol (e.g. HMKB, ALKB). |
| page_size | integer | Results per page (max 100). |
| listed_only | boolean | When true, restricts results to companies listed on the stock exchange. |
{
"type": "object",
"fields": {
"page": "integer current page",
"total": "integer total count of matching issuers",
"results": "array of issuer objects with issuer_id, organization_name, short_name, tin, tickers, isins, status, is_listing, source_url",
"page_size": "integer page size",
"total_pages": "integer total pages"
},
"sample": {
"page": 1,
"total": 1,
"results": [
{
"tin": "200242936",
"isins": [],
"status": "активная",
"tickers": [
"HMKB",
"HMKBP"
],
"issuer_id": 8,
"is_listing": true,
"short_name": "\"Hamkorbank\" ATB",
"source_url": "https://new.openinfo.uz/ru/organizations/8",
"organization_name": "Chet el kapitali ishtirokidagi \"Hamkorbank\" aksiyadorlik tijorat banki"
}
],
"page_size": 20,
"total_pages": 1
}
}About the OpenInfo API
Issuer Discovery and Profiles
Use search_issuers to locate companies by name substring (query), 9-digit TIN (tin), or exchange ticker (ticker). Results are paginated and each entry carries issuer_id, organization_name, tickers, isins, status, and an is_listing flag to distinguish exchange-listed from merely registered entities. Pass listed_only: true to restrict the result set to companies trading on the Uzbek exchange. The returned issuer_id is the key identifier for all other endpoints. get_issuer_profile extends that with full legal details, contacts (phone, email, director, accountant, responsible officer), and the issuer's own website URL.
Financial Reports and Structured Statements
list_financial_reports returns a paginated list of published reports for an issuer, filterable by format — NSBU (national accounting standards) or MSFO (IFRS) — with each entry providing report_type, report_period_type, publication_date, and a view_url. To extract numeric data, pass that view_url (or the object_id plus report_category) to get_financial_report. It returns standardized balance sheet fields — total_assets, total_equity, total_liabilities — and income statement items, each with current_period and prior_period values, always denominated in thousands of UZS. Specify report_category as bank or jsc and period_type as quarter or annual to disambiguate when multiple report variants exist for the same object.
Material Facts, Dividends, and Securities
list_material_facts surfaces regulatory disclosures filterable by fact_type number (for example, type 41 for dividend recommendations, type 42 for dividend payments, type 6 for management changes), date_from, and date_to. Retrieve the full structured content of any disclosure with get_material_fact, which returns a body object of key-value pairs parsed from the fact detail page alongside disclosure_date, issuer_tin, and source_url. list_dividends queries the dividend calendar and returns per-share amounts for both common and preferred shares along with decision_date and payment_period. list_security_issues provides ISIN-level detail including security_type, stock_type, nominal_value, quantity, listing_date, and trading_currency, plus a separate emissions array for prospectus records.
The OpenInfo API is a managed, monitored endpoint for new.openinfo.uz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when new.openinfo.uz changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official new.openinfo.uz API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen all exchange-listed Uzbek companies using
search_issuerswithlisted_only: trueto build a local securities reference database. - Track quarterly and annual balance sheet trends for a specific issuer by chaining
list_financial_reportswithget_financial_reportto comparetotal_assetsacross periods. - Monitor dividend announcements by polling
list_material_factsfor fact_type 41 and 42 to catch recommendation and payment events as they are disclosed. - Build a dividend yield calculator using
list_dividendsto retrievecommon_share_amountandpreferred_share_amountper issuer over custom date ranges. - Enrich a company directory with legal contacts, director names, and website URLs by batch-calling
get_issuer_profilefor a list of TINs. - Audit securities issuance history for an entity using
list_security_issuesto retrieve ISIN codes, nominal values, and listing dates from the exchange registry. - Alert on management changes or other regulatory events by filtering
list_material_factsfor specific fact type numbers within a rolling date window.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does new.openinfo.uz have an official developer API?+
What does `get_financial_report` return, and how do I avoid ambiguous results?+
get_financial_report returns normalized balance sheet fields (total_assets, total_equity, total_liabilities) and income statement items with current_period and prior_period values, all in thousands of UZS. If an issuer has both quarter and annual variants for the same object_id, supply period_type (quarter or annual) explicitly to avoid the endpoint guessing. For banking issuers pass report_category: bank; for joint-stock companies use jsc.Can I retrieve the full text of material fact documents rather than just structured fields?+
get_material_fact returns the structured key-value body fields and metadata like disclosure_date and source_url, but does not return attached PDF or HTML document content. You can fork this API on Parse and revise it to add an endpoint that fetches and parses linked document files.Does the API cover bond issuers or only equity companies?+
list_security_issues returns security_type per ISIN so you can identify bond versus equity instruments. However, there is no dedicated endpoint for bond-specific data such as coupon schedules or maturity dates. You can fork this API on Parse and revise it to add endpoints targeting those fields.How does pagination work across list endpoints?+
search_issuers, list_financial_reports, list_material_facts, list_dividends) return page, page_size, total, and total_pages in every response. Set page_size up to a maximum of 100 and increment page to walk through results. list_security_issues is not paginated — it returns all ISIN codes and emissions records for an issuer in a single response.