# New Openinfo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```