# New Openinfo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access data from new.openinfo.uz.

**Category:** Finance & Markets | **Website:** [new.openinfo.uz/ru](https://new.openinfo.uz/ru) | **Docs:** [parse.bot/marketplace/292edba6-24c0-4c8c-92ad-c5caad3bb984/new-openinfo-uz-api](https://parse.bot/marketplace/292edba6-24c0-4c8c-92ad-c5caad3bb984/new-openinfo-uz-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_financial_report

Retrieve structured financial statement data for a specific report. Accepts a report view URL (from list_financial_reports view_url field) or an object_id plus report_category. Returns key balance sheet items (total assets, total equity, total liabilities) and income statement items (revenue/interest income, gross profit, operating profit, net profit) for the current reporting period and prior comparative period where available. Values are numeric (UZS thousands). Use period_type to disambiguate when the same object_id exists in both quarterly and annual report collections for the same category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `object_id` | string | No | Report object ID (from list_financial_reports results). |
| `period_type` | string | No | Report period type: 'quarter' or 'annual'. When omitted, tries quarter first then annual. Specify to disambiguate when the same object_id exists in both. |
| `report_category` | string | No | Report category/org type: 'bank' for banking institutions, 'jsc' for joint-stock companies. Required when using object_id without report_url. |
| `report_url` | string | No | Full report view URL from list_financial_reports (e.g. https://new.openinfo.uz/ru/reports/bank/1269). Extracts report_category and object_id automatically. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/get_financial_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object_id":"<string>","period_type":"<string>","report_category":"<string>","report_url":"<string>"}'
```

### get_issuer_profile

Retrieve full profile of an issuer including legal details, contacts, tickers, ISINs, and listing status. Accepts issuer_id (from search_issuers), tin, or ticker — any one identifies the issuer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issuer_id` | string | No | Portal internal issuer ID (from search_issuers results). |
| `ticker` | string | No | Exchange ticker symbol. |
| `tin` | string | No | ИНН/TIN of the issuer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/get_issuer_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issuer_id":"<string>","ticker":"<string>","tin":"<string>"}'
```

### get_material_fact

Get full structured content of a specific material fact by its fact_id (from list_material_facts). Returns all field/value rows as key-value data in the body object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fact_id` | string | Yes | Material fact ID (from list_material_facts results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/get_material_fact \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fact_id":"<string>"}'
```

### list_dividends

List dividend records for an issuer from the dividend calendar. Includes per-share amounts for common and preferred shares, decision dates, and payment periods. Requires issuer_id or tin.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_from` | string | No | Start date filter (YYYY-MM-DD) on publication date. |
| `date_to` | string | No | End date filter (YYYY-MM-DD) on publication date. |
| `issuer_id` | string | No | Portal internal issuer ID. |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Results per page. |
| `tin` | string | No | ИНН/TIN of the issuer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/list_dividends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"<string>","date_to":"<string>","issuer_id":"<string>","page":"<integer>","page_size":"<integer>","tin":"<string>"}'
```

### list_financial_reports

List financial reports for an issuer. Each report includes type (quarter/annual), format (NSBU/MSFO), publication date, and a view URL. Requires issuer_id or tin.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issuer_id` | string | No | Portal internal issuer ID. |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Results per page. |
| `report_type` | string | No | Filter by report format: NSBU or MSFO. |
| `tin` | string | No | ИНН/TIN of the issuer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/list_financial_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issuer_id":"<string>","page":"<integer>","page_size":"<integer>","report_type":"<string>","tin":"<string>"}'
```

### list_material_facts

List material facts (существенные факты) for an issuer, optionally filtered by fact type number and date range. Requires issuer_id or tin.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_from` | string | No | Start date filter (YYYY-MM-DD) on disclosure date. |
| `date_to` | string | No | End date filter (YYYY-MM-DD) on disclosure date. |
| `fact_type` | string | No | Material fact type number (e.g. 41 for dividend recommendations, 42 for dividend payments, 6 for management decisions). |
| `issuer_id` | string | No | Portal internal issuer ID. |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Results per page. |
| `tin` | string | No | ИНН/TIN of the issuer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/list_material_facts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"<string>","date_to":"<string>","fact_type":"<string>","issuer_id":"<string>","page":"<integer>","page_size":"<integer>","tin":"<string>"}'
```

### list_security_issues

List securities (ISIN codes, tickers, share types) and emission records for an issuer. Includes security type, nominal value, quantity, and listing details from the exchange registry. Requires issuer_id or tin.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issuer_id` | string | No | Portal internal issuer ID. |
| `tin` | string | No | ИНН/TIN of the issuer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/list_security_issues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issuer_id":"<string>","tin":"<string>"}'
```

### search_issuers

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listed_only` | boolean | No | When true, restricts results to companies listed on the stock exchange. |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Results per page (max 100). |
| `query` | string | No | Name substring to search for (company name in any language). |
| `ticker` | string | No | Exchange ticker symbol (e.g. HMKB, ALKB). |
| `tin` | string | No | ИНН/TIN of the issuer for precise lookup. 9-digit numeric string. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-new-openinfo-uz-api-292edba6/search_issuers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listed_only":"<boolean>","page":"<integer>","page_size":"<integer>","query":"<string>","ticker":"<string>","tin":"<string>"}'
```