> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Latvia

> Country-specific identifiers, data sources, and implementation details

## Start here

This guide contains public integration notes for Latvia. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

<Card title="Latvia coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/lv">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Note>
  Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
</Note>

## Data Sources

Latvia uses two complementary data sources: the **real-time UR API** for full company profiles and documents, and **open data** for fast batch-deduplicated search and onboarding.

* **Uzņēmumu reģistrs (UR) API.** The Enterprise Register of the Republic of Latvia, maintained by the Register of Enterprises. This is the source for **full company profiles** with AI enrichment: activity codes (NACE/ISIC), legal representatives with standardized roles, supervisory board, shareholders with ownership details, UBOs with control types, and document access. Accessible at [ur.gov.lv](https://www.ur.gov.lv). The API uses OAuth2 with JWT client assertion (RFC 7523) for authentication.

* **Latvia Open Data (data.gov.lv).** CC0-licensed datasets from the Enterprise Register, updated daily. Covers \~480K entities across 7 CSV files: company register, officers, members (SIA shareholders), stockholders (AS shareholders), beneficial owners, equity capitals, and areas of activity. Used for **fast search** and the **onboarding profile** datapoint.

<Note>
  **Dual-source model.** Search queries hit the fast search index first for
  fast results from batch data, then fall back to the UR API for supplementary
  results. The onboarding profile serves data directly from batch staging
  tables, while the full company profile uses the UR API for AI-enriched data.
</Note>

## Company Identifiers

### Query Identifiers

| Company Type         | Source | Format                            | Example       | Notes                                         |
| -------------------- | ------ | --------------------------------- | ------------- | --------------------------------------------- |
| **All entity types** | UR     | 9-11 digits (Registration Number) | `40103217882` | Universal identifier for all Latvian entities |

<Tip>
  **Registration Number Format:** Latvian registration numbers are 9-11 digits.
  The first digit(s) often indicate the entity type: `40` prefix is common for
  commercial companies (SIA/AS), `50` for older registrations, and shorter
  numbers (9 digits) appear for legacy entities.
</Tip>

### Identifiers in API Response

Once you retrieve company data, the `identifiers` object contains all available identifiers for that entity:

| Identifier Type             | Format                           | Example       | Found In                         |
| --------------------------- | -------------------------------- | ------------- | -------------------------------- |
| `registrationNumber`        | 9-11 digits                      | `40103217882` | All entities                     |
| `foreignRegistrationNumber` | Home-country registration number | `930097705`   | Foreign entities in the register |

## Search Capabilities

| Search Type            | Pattern                   | Example         | Match Type     | Source              | Speed                |
| ---------------------- | ------------------------- | --------------- | -------------- | ------------------- | -------------------- |
| By Registration Number | 9-11 digits               | `40103217882`   | Exact          | Fast index + UR API | fast initial results |
| By Name                | Text string (2-100 chars) | `"Bolt"`        | Fuzzy/Contains | Fast index + UR API | fast initial results |
| By VAT Number          | `LV` + 11 digits          | `LV40103217882` | Exact          | VIES + UR API       | \~1-5s               |

<Tip>
  **Search Performance:** Fast-index results arrive first from
  batch-deduplicated data covering \~480K entities. UR API results supplement later via
  progressive streaming. Use registration number searches for exact matching and
  best performance.
</Tip>

<Note>
  **Search architecture:** Search queries run all sources in parallel. Fast-index sources return first from synchronized open data. The UR API sources (by ID, by VAT, by name) provide supplementary results. Results are merged with matchType priority (ID > exact name > partial match).
</Note>

## Quirks & Gotchas

| Quirk                                   | Details                                                                                                                                                                                                                                                                          |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Single registry source**              | All data comes from the Enterprise Register (Uzņēmumu reģistrs). No fallback sources exist. If the UR API is unavailable, no data can be returned.                                                                                                                               |
| **NACE revision conversion**            | Latvia may provide NACE Rev. 1 or 1.1 codes (pre-2008 classification) for older companies. These are automatically converted to NACE Rev. 2 via AI. Division codes have different meanings across revisions (e.g., Division 15 = Food products in Rev. 1 vs. Leather in Rev. 2). |
| **Status uses finite enum**             | Company status is deterministic from a finite API enum: `REGISTERED`, `REMOVED`, `ANNULLED`. No AI inference needed. The `statusDetails` field provides additional context (`REORGANIZED`, `IN_LIQUIDATION`).                                                                    |
| **Hyphen vs. underscore in status**     | The UR API returns status details with both hyphens (`IN-LIQUIDATION`) and underscores (`IN_LIQUIDATION`). Both formats are handled automatically.                                                                                                                               |
| **Removal reasons affect closure type** | When a company is REMOVED, the closure reason depends on context: reorganized = MERGER, after liquidation = LIQUIDATION, annulled = COURT\_ORDER, other = ADMINISTRATIVE\_DISSOLUTION.                                                                                           |
| **Hybrid role mapping**                 | Legal representative and other key person roles use a hybrid approach: known roles are mapped deterministically, unknown free-text roles are enriched by AI. The `position` and `governingBody` fields from the API are used alongside the free-text `role` field.               |
| **Historical currency (LVL)**           | Older records may show share capital in Latvian Lats (LVL) instead of EUR. Latvia adopted the Euro on January 1, 2014.                                                                                                                                                           |
| **Document format conversion**          | Documents from the Enterprise Register may be in TIF, HTML, EDOC, or ASICE format and are automatically converted to PDF for delivery.                                                                                                                                           |
| **ISIC always AI-inferred**             | NACE codes are official from the registry. ISIC codes are always derived from NACE via AI enrichment. Check the `isAIInferred` flag.                                                                                                                                             |
| **Shareholder nominal value**           | Shareholder data includes `shareNominalValue` (value per share) which is multiplied by `numberOfShares` to compute total nominal capital held.                                                                                                                                   |
| **Legacy person-as-entity records**     | Some older records (especially individual undertakings) store natural persons in the `legalEntity` field instead of `naturalPerson`. The system auto-detects and handles this.                                                                                                   |
| **No employee count**                   | The UR API does not provide employee count data for any entity type.                                                                                                                                                                                                             |
| **No website/email/phone**              | Contact information (website, email, phone numbers) is not available from the Enterprise Register.                                                                                                                                                                               |

## Company Status

Company status is determined **deterministically** from the UR API schema. No AI inference is involved. The API returns a finite enum of statuses with optional status details and liquidation records.

| UR Status    | Status Details             | Local Name                | Standardized Status         | Closure Reason             |
| ------------ | -------------------------- | ------------------------- | --------------------------- | -------------------------- |
| `REGISTERED` | (none)                     | Reģistrēts                | Active                      | -                          |
| `REGISTERED` | `IN_LIQUIDATION`           | Likvidācijas procesā      | Under Insolvency Proceeding | Liquidation                |
| `REMOVED`    | `REORGANIZED`              | Izslēgts (reorganizācija) | Closed                      | Merger                     |
| `REMOVED`    | (with liquidation history) | Izslēgts (likvidācija)    | Closed                      | Liquidation                |
| `REMOVED`    | (none)                     | Izslēgts no reģistra      | Closed                      | Administrative Dissolution |
| `ANNULLED`   | -                          | Anulēts                   | Closed                      | Court Order                |

<Note>
  When a company has `REGISTERED` status with `IN_LIQUIDATION` details, the
  `insolvencyStartDate` is derived from the most recent active liquidation
  record's `startedOn` date. The `groundsForLiquidation` field provides
  additional context (e.g., shareholder decision). For `REMOVED` companies, the
  `closureDate` comes from the `removedOn` field.
</Note>

## Legal Forms

Latvia uses a **finite set of 18 legal form types** from the UR API. The mapping is **fully deterministic**, and no AI inference is used for legal form identification. ISO 20275 codes are derived via AI enrichment after the deterministic mapping.

### Commercial Companies

| API Type Code                   | Latvian Name                       | Abbr. | English Translation       | Standardized              |
| ------------------------------- | ---------------------------------- | ----- | ------------------------- | ------------------------- |
| `LIMITED_LIABILITY_COMPANY_SIA` | Sabiedrība ar ierobežotu atbildību | SIA   | Limited Liability Company | Limited Liability Company |
| `PUBLIC_LIMITED_COMPANY_AS`     | Akciju sabiedrība                  | AS    | Public Limited Company    | Corporation               |
| `GENERAL_PARTNERSHIP_PS`        | Pilnsabiedrība                     | PS    | General Partnership       | Partnership               |
| `LIMITED_PARTNERSHIP_KS`        | Komandītsabiedrība                 | KS    | Limited Partnership       | Partnership               |
| `COOPERATIVE_SOCIETY_KB`        | Kooperatīvā sabiedrība             | -     | Cooperative Society       | Cooperative               |

### Sole Entrepreneurs & Individual Entities

| API Type Code                | Latvian Name             | Abbr. | English Translation    | Standardized        |
| ---------------------------- | ------------------------ | ----- | ---------------------- | ------------------- |
| `SOLE_TRADER_IK`             | Individuālais komersants | IK    | Sole Trader            | Sole Proprietorship |
| `INDIVIDUAL_UNDERTAKING_IND` | Individuālais uzņēmums   | -     | Individual Undertaking | Sole Proprietorship |
| `FARM_ZEM`                   | Zemnieku saimniecība     | Z/S   | Farm                   | Sole Proprietorship |

### Non-Profits & Civil Society

| API Type Code                | Latvian Name           | English Translation    | Standardized           |
| ---------------------------- | ---------------------- | ---------------------- | ---------------------- |
| `ASSOCIATION_BDR`            | Biedrība               | Association            | Nonprofit Organization |
| `FOUNDATION_NOD`             | Nodibinājums           | Foundation             | Nonprofit Organization |
| `RELIGIOUS_ORGANIZATION_REL` | Reliģiskā organizācija | Religious Organization | Nonprofit Organization |
| `POLITICAL_PARTY_PP`         | Politiskā partija      | Political Party        | Nonprofit Organization |

### European & International Entities

| API Type Code                              | Latvian Name                          | Abbr. | English Translation                        | Standardized |
| ------------------------------------------ | ------------------------------------- | ----- | ------------------------------------------ | ------------ |
| `EUROPEAN_COMPANY_SE`                      | Eiropas komercsabiedrība              | SE    | European Company (SE)                      | Corporation  |
| `EUROPEAN_COOPERATIVE_SOCIETY_SCE`         | Eiropas kooperatīvā sabiedrība        | SCE   | European Cooperative Society (SCE)         | Cooperative  |
| `EUROPEAN_ECONOMIC_INTEREST_GROUPING_EEIG` | Eiropas ekonomisko interešu grupējums | EEIG  | European Economic Interest Grouping (EEIG) | Partnership  |

### Other Entity Types

| API Type Code | Latvian Name                 | English Translation | Standardized                    |
| ------------- | ---------------------------- | ------------------- | ------------------------------- |
| `BRANCH_FIL`  | Filiāle                      | Branch              | Branch or Representative Office |
| `PUBLIC_BODY` | Publiska persona vai iestāde | Public Body         | Government-Owned Entity         |
| `MIL`         | Masu informācijas līdzeklis  | Mass Media          | Other                           |

<Note>
  Unknown legal forms not matching the 18 known types fall back to using the raw
  API value as `localName` without English translation. ISO 20275 codes are
  always derived via AI enrichment, not from a static lookup table.
</Note>

## Legal Representatives

Legal representatives are extracted from the UR API `officers` array. The classification of a role as **legal representative vs. other key person** uses a **hybrid approach**: known roles are mapped deterministically, while unknown free-text roles fall back to AI enrichment. Role determination uses three signals from the API: the free-text `role` field, the enum `position` field, and the enum `governingBody` field.

### Representation Mode

The UR API provides structured representation authority data in the `rightsOfRepresentation` field, which is mapped to `representationMode`:

* **`{ mode: "sole" }`**: Can sign alone (`type: "INDIVIDUAL"`)
* **`{ mode: "joint", minimumSignatories: N }`**: Must sign jointly (`type: "COLLECTIVE"` with minimum count)
* **`{ mode: "joint" }`**: Joint signing required, count unspecified
* **`null`**: No representation rights data provided by UR

<Note>
  Representation mode is populated from structured UR API data when available. Not all companies have this field populated in the registry.
</Note>

### Legal Representative Roles (Deterministic Mapping)

<AccordionGroup>
  <Accordion title="By Role Name (free-text Latvian)">
    | Role Key                | Latvian Name          | English Translation   | Standardized Role     |
    | ----------------------- | --------------------- | --------------------- | --------------------- |
    | `valdes_loceklis`       | Valdes loceklis       | Board Member          | Board Member          |
    | `valdes_priekssedetajs` | Valdes priekšsēdētājs | Chairman of the Board | Chairman of the Board |
    | `direktors`             | Direktors             | Director              | Director              |
    | `izpilddirektors`       | Izpilddirektors       | Executive Director    | Managing Director     |
    | `likvidators`           | Likvidators           | Liquidator            | Liquidator            |
    | `administrators`        | Administrators        | Administrator         | Administrator         |
    | `prokurists`            | Prokūrists            | Procurist             | Other                 |
  </Accordion>

  <Accordion title="By Position Enum (from UR API)">
    | Position Value       | Latvian Name          | English Translation   | Standardized Role     |
    | -------------------- | --------------------- | --------------------- | --------------------- |
    | `CHAIR_OF_BOARD`     | Valdes priekšsēdētājs | Chairman of the Board | Chairman of the Board |
    | `BOARD_MEMBER`       | Valdes loceklis       | Board Member          | Board Member          |
    | `DIRECTOR`           | Direktors             | Director              | Director              |
    | `EXECUTIVE_DIRECTOR` | Izpilddirektors       | Executive Director    | Managing Director     |
    | `LIQUIDATOR`         | Likvidators           | Liquidator            | Liquidator            |
    | `ADMINISTRATOR`      | Administrators        | Administrator         | Administrator         |
  </Accordion>

  <Accordion title="By Governing Body">
    | Governing Body      | Classification       |
    | ------------------- | -------------------- |
    | `EXECUTIVE_BOARD`   | Legal Representative |
    | `SUPERVISORY_BOARD` | Other Key Person     |
  </Accordion>

  <Accordion title="Pattern-Based Fallbacks">
    When the free-text role does not match an exact mapping, pattern matching is used to determine if the role is a legal representative:

    | Pattern          | Latvian Context        | Indicates            |
    | ---------------- | ---------------------- | -------------------- |
    | `valdes`         | Board-related          | Legal Representative |
    | `direktors`      | Director-related       | Legal Representative |
    | `likvidators`    | Liquidation-related    | Legal Representative |
    | `administrators` | Administration-related | Legal Representative |
    | `prokurists`     | Commercial proxy       | Legal Representative |
    | `pilnvarot`      | Authorization-related  | Legal Representative |
    | `parakst`        | Signing authority      | Legal Representative |

    If a pattern matches but the exact role is not known, the role is flagged for AI enrichment to provide accurate English translation and standardization.
  </Accordion>
</AccordionGroup>

<Note>
  **Procurists** are mapped separately from the `procurations` array (not the
  `officers` array). Each procuration may contain multiple procurists, and the
  system also extracts `rightsOfRepresentation` (e.g., INDIVIDUALLY,
  WITH\_AT\_LEAST, JOINTLY) and `rightsOnImmovableProperty` when available. Both
  individual and corporate legal representatives are supported.
</Note>

## Other Key Persons

Other key persons (supervisory board members, auditors) are extracted from the same `officers` array, classified by role, position, or governing body.

### Other Key Person Roles (Deterministic Mapping)

| Role Key / Position                                     | Latvian Name           | English Translation           | Standardized Role        |
| ------------------------------------------------------- | ---------------------- | ----------------------------- | ------------------------ |
| `padomes_loceklis` / `SUPERVISORY_BOARD_MEMBER`         | Padomes loceklis       | Supervisory Board Member      | Supervisory Board Member |
| `padomes_priekssedetajs` / `CHAIR_OF_SUPERVISORY_BOARD` | Padomes priekšsēdētājs | Chairman of Supervisory Board | Supervisory Board Member |
| `revidents` / `AUDITOR` / `REVISOR`                     | Revidents              | Auditor                       | Auditor                  |

<Note>
  Officers with `governingBody = SUPERVISORY_BOARD` but no explicit role or
  position are defaulted to "Supervisory Board Member" and flagged for AI
  verification. Both individual and corporate other key persons are supported.
</Note>

## Shareholders

Shareholders are extracted from the UR API `members` array for **commercial companies only** (SIA, AS). Non-profits, foundations, sole traders, and farms do not provide shareholder data.

### Extraction Logic

| Field                | Description                                                | Source                                                    |
| -------------------- | ---------------------------------------------------------- | --------------------------------------------------------- |
| `sharePercentage`    | Ownership percentage                                       | `shareHolderDetails.inPercent`                            |
| `numberOfShares`     | Number of shares held                                      | `shareHolderDetails.numberOfShares`                       |
| `nominalCapitalHeld` | Total nominal capital (value per share x number of shares) | `shareHolderDetails.shareNominalValue` x `numberOfShares` |
| `type`               | Individual or Company                                      | Determined from `naturalPerson` or `legalEntity` presence |

<AccordionGroup>
  <Accordion title="Additional shareholder fields (AI-enriched when available)">
    The following fields are extracted from the API but require AI enrichment for full processing:

    | Field                       | Description                                         |
    | --------------------------- | --------------------------------------------------- |
    | `votes`                     | Voting rights (when different from share ownership) |
    | `jointOwners`               | Co-ownership structures                             |
    | `dateFrom`                  | Date ownership started                              |
    | `representative`            | Representative for minors or legal entities         |
    | `paidUp` / `paidUpCurrency` | Paid-up share capital amount                        |
  </Accordion>
</AccordionGroup>

<Note>
  Both individual and corporate shareholders are supported. Corporate
  shareholders include registration number and country when available. Foreign
  corporate shareholders are identified with their home country registration
  details.
</Note>

## Activity Code Mapping

Latvia uses **NACE** (Nomenclature of Economic Activities) codes from the Enterprise Register. The system maps activity codes across two levels, with special handling for older NACE revisions:

```
NACE (European) → ISIC Rev. 4 (International)
```

| Classification  | Source                     | Example | AI Inferred?                                    |
| --------------- | -------------------------- | ------- | ----------------------------------------------- |
| **NACE Rev. 2** | UR API (`naceTypes` array) | `62.01` | No (official), unless converted from Rev. 1/1.1 |
| **ISIC**        | Derived from NACE          | `6201`  | Yes (always AI-derived)                         |

### NACE Revision Handling

| Scenario                      | Processing                                                                                    |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| **NACE Rev. 2 codes**         | Used directly, enriched with ISIC via formal mapping + AI                                     |
| **NACE Rev. 1 or 1.1 codes**  | Converted to NACE Rev. 2 via AI (LLM understands old classifications), then ISIC derived      |
| **No NACE codes (text only)** | `typesOfActivity` and `goals` text fields used for AI enrichment to derive both NACE and ISIC |
| **Placeholder codes (00.00)** | Filtered out automatically                                                                    |

<Warning>
  **NACE Revision Mismatch:** Older Latvian companies may have NACE Rev. 1 or
  1.1 codes that look similar to Rev. 2 codes but represent entirely different
  economic activities. For example, Division 15 in Rev. 1.1 = "Food products and
  beverages" but in Rev. 2 = "Leather and related products." The system detects
  the revision and converts automatically.
</Warning>

<Note>
  Non-profit entities (associations, foundations) may have activity area codes
  (`areasOfActivityOfAssociationsFoundations`) instead of NACE codes. These use
  a separate classification (e.g., `HEALTH_AND_DISEASE_PREVENTION`, `EDUCATION`,
  `CULTURE`, `SPORT`) and are processed via AI enrichment to derive NACE/ISIC
  equivalents.
</Note>

## Data Availability Matrix

| Data Type                  | Commercial Companies (SIA, AS) | Sole Entrepreneurs (IK) | Partnerships (PS, KS) | Non-Profits (Biedrība) | Foundations (Nodibinājums) | Notes                                                                   |
| -------------------------- | ------------------------------ | ----------------------- | --------------------- | ---------------------- | -------------------------- | ----------------------------------------------------------------------- |
| Onboarding Profile         | ✅ Fast                         | ✅ Fast                  | ✅ Fast                | ✅ Fast                 | ✅ Fast                     | From batch open data (\~1s). Includes legal reps, shareholders, capital |
| Company Profile            | ✅ Async                        | ✅ Async                 | ✅ Async               | ✅ Async                | ✅ Async                    | Full data from Enterprise Register                                      |
| Legal Representatives      | ✅                              | ✅                       | ✅                     | ✅                      | ✅                          | Board members, directors, liquidators, procurists                       |
| Other Key Persons          | ✅                              | ⚠️ Limited              | ⚠️ Limited            | ⚠️ Limited             | ⚠️ Limited                 | Supervisory board members, auditors                                     |
| Shareholders               | ✅                              | ❌                       | ❌                     | ❌                      | ❌                          | SIA and AS only                                                         |
| Ultimate Beneficial Owners | ✅                              | ⚠️ Limited              | ⚠️ Limited            | ⚠️ Limited             | ⚠️ Limited                 | Directly from registry, no retrieve required                            |
| Activity Codes             | ✅                              | ✅                       | ✅                     | ✅                      | ✅                          | NACE (may need revision conversion) + ISIC                              |
| Documents                  | ✅                              | ✅                       | ✅                     | ✅                      | ✅                          | CTRE, annual reports, articles, registry docs                           |
| Share Capital              | ✅                              | ❌                       | ❌                     | ❌                      | ❌                          | SIA and AS only                                                         |
| Employee Count             | ❌                              | ❌                       | ❌                     | ❌                      | ❌                          | Not available from Enterprise Register                                  |
| Previous Names             | ✅                              | ✅                       | ✅                     | ✅                      | ✅                          | Historical name changes with dates                                      |

**Legend:** ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing

## Documents by Company Type

Latvia provides comprehensive document access through the Enterprise Register (Uzņēmumu reģistrs). Documents are sourced from two channels: the UR website (for CTRE) and the UR API (for all other documents).

### Always Available

| Document Type                        | API Category                    | Format | Catalog item                     | Availability               | Notes                                                     |
| ------------------------------------ | ------------------------------- | ------ | -------------------------------- | -------------------------- | --------------------------------------------------------- |
| **Certified Trade Register Extract** | `certifiedTradeRegisterExtract` | PDF    | `LVA_CERTIFIED_REGISTER_EXTRACT` | ✅ All registered companies | Official e-sealed extract with complete registration data |

### From UR API (Public Documents)

<AccordionGroup>
  <Accordion title="Articles of Association">
    | Document Type                         | UR Type Code        | API Category              | Catalog item                  | Notes                    |
    | ------------------------------------- | ------------------- | ------------------------- | ----------------------------- | ------------------------ |
    | Articles of Association               | `AOA`               | `articlesOfAssociation[]` | `LVA_ARTICLES_OF_ASSOCIATION` | Company bylaws (Statūti) |
    | Amendments to Articles of Association | `AMENDMENTS_TO_AOA` | `articlesOfAssociation[]` | `LVA_ARTICLES_OF_ASSOCIATION` | Changes to bylaws        |
  </Accordion>

  <Accordion title="Financial Statements">
    | Document Type | UR Type Code    | API Category            | Catalog item               | Notes                                      |
    | ------------- | --------------- | ----------------------- | -------------------------- | ------------------------------------------ |
    | Annual Report | `ANNUAL_REPORT` | `financialStatements[]` | `LVA_FINANCIAL_STATEMENTS` | Balance sheet, income statement, cash flow |
    | Sample Report | `SAMPLE_REPORT` | `financialStatements[]` | `LVA_FINANCIAL_STATEMENTS` | Simplified financial report                |
  </Accordion>

  <Accordion title="Registration & Incorporation">
    | Document Type            | UR Type Code               | Internal Type                | Catalog item    | Notes                          |
    | ------------------------ | -------------------------- | ---------------------------- | --------------- | ------------------------------ |
    | Registration Certificate | `REGISTRATION_CERTIFICATE` | Certificate of Incorporation | `LVA_DOCUMENTS` | Original registration document |
    | Memorandum               | `MEMORANDUM`               | Other                        | `LVA_DOCUMENTS` | Founding documentation         |
  </Accordion>

  <Accordion title="Beneficial Owners">
    | Document Type                         | UR Type Code                            | Internal Type | Catalog item    | Notes                              |
    | ------------------------------------- | --------------------------------------- | ------------- | --------------- | ---------------------------------- |
    | Statement Regarding Beneficial Owners | `STATEMENT_REGARDING_BENEFICIAL_OWNERS` | UBO Extract   | `LVA_DOCUMENTS` | Declared beneficial owners         |
    | Beneficial Owner Justification        | `BO_JUSTIFICATION`                      | UBO Extract   | `LVA_DOCUMENTS` | Justification for UBO declarations |
  </Accordion>

  <Accordion title="Shareholders & Equity">
    | Document Type                     | UR Type Code                                 | Catalog item    | Notes                         |
    | --------------------------------- | -------------------------------------------- | --------------- | ----------------------------- |
    | Shareholders Register             | `SHAREHOLDERS_REGISTER`                      | `LVA_DOCUMENTS` | List of company shareholders  |
    | Application for Share Acquisition | `APPLICATION_FOR_SHARE_ACQUISITION`          | `LVA_DOCUMENTS` | Share retrieve applications   |
    | Share Transfer Attestation        | `ATTESTATION_SHARE_TRANSFER`                 | `LVA_DOCUMENTS` | Share transfer certificates   |
    | Regulations on Equity             | `REGULATIONS_ON_EQUITY`                      | `LVA_DOCUMENTS` | Rules governing share capital |
    | Bank Statement - Equity Retrieval | `BANK_STATEMENT_REGARDING_PAYMENT_OF_EQUITY` | `LVA_DOCUMENTS` | Proof of equity retrieval     |
    | Appraisal Report                  | `APPRAISAL_REPORT`                           | `LVA_DOCUMENTS` | Asset valuation reports       |
    | Board Statement Regarding Equity  | `BOARD_STATEMENT_REGARDING_EQUITY`           | `LVA_DOCUMENTS` | Board declarations on equity  |
  </Accordion>

  <Accordion title="Corporate Governance">
    | Document Type                | UR Type Code                          | Catalog item    | Notes                         |
    | ---------------------------- | ------------------------------------- | --------------- | ----------------------------- |
    | Company Protocol             | `PROTOCOL_OF_COMPANY_OR_ORGANISATION` | `LVA_DOCUMENTS` | Meeting minutes and decisions |
    | List of Board Members        | `LIST_OF_BOARD_MEMBERS`               | `LVA_DOCUMENTS` | Board composition             |
    | Consent of Supervisory Board | `CONSENT_OF_SUPERVISORY_BOARD`        | `LVA_DOCUMENTS` | Supervisory board approvals   |
    | Consent of Auditor           | `CONSENT_OF_AUDITOR`                  | `LVA_DOCUMENTS` | Auditor consent documents     |
  </Accordion>

  <Accordion title="Legal & Administrative">
    | Document Type                 | UR Type Code                            | Catalog item    | Notes                                |
    | ----------------------------- | --------------------------------------- | --------------- | ------------------------------------ |
    | Notarial Decision             | `NOTARIAL_DECISION`                     | `LVA_DOCUMENTS` | Notarized decisions and certificates |
    | Power of Attorney             | `POWER_OF_ATTORNEY`                     | `LVA_DOCUMENTS` | Authorization documents              |
    | Confirmation of Legal Address | `CONFIRMATION_OF_LEGAL_ADDRESS`         | `LVA_DOCUMENTS` | Address proof                        |
    | Legal Address Announcement    | `ANNOUNCEMENT_REGARDING_LEGAL_ADDRESS`  | `LVA_DOCUMENTS` | Address change notices               |
    | Reorganisation Agreement      | `REORGANISATION_AGREEMENT`              | `LVA_DOCUMENTS` | Merger/restructuring docs            |
    | Reorganisation Announcement   | `ANNOUNCEMENT_REGARDING_REORGANISATION` | `LVA_DOCUMENTS` | Reorganisation notices               |
  </Accordion>

  <Accordion title="Foreign Entities & Other">
    | Document Type                               | UR Type Code                                                | Catalog item    | Notes                            |
    | ------------------------------------------- | ----------------------------------------------------------- | --------------- | -------------------------------- |
    | Foreign Company Registration Documents      | `DOCUMENTS_CONFIRMING_REGISTRATION_OF_FOREIGN_COMPANY`      | `LVA_DOCUMENTS` | For foreign parent companies     |
    | Foreign Organisation Registration Documents | `DOCUMENTS_CONFIRMING_REGISTRATION_OF_FOREIGN_ORGANISATION` | `LVA_DOCUMENTS` | For foreign parent organisations |
    | Commercial Pledge                           | `PLEDGOR`                                                   | `LVA_DOCUMENTS` | Commercial pledge documents      |
    | Application                                 | `APPLICATION`                                               | `LVA_DOCUMENTS` | Various applications             |
    | Submission                                  | `SUBMISSION`                                                | `LVA_DOCUMENTS` | Regulatory submissions           |
    | Other Document                              | `OTHER`                                                     | `LVA_DOCUMENTS` | Miscellaneous documents          |
  </Accordion>

  <Accordion title="Insolvency Proceedings">
    Insolvency proceeding documents are retrieved from a separate API endpoint and enriched via AI parsing to extract the proceeding type, status, and descriptive English names.

    | Source            | Catalog item    | Format | Notes                              |
    | ----------------- | --------------- | ------ | ---------------------------------- |
    | UR Insolvency API | `LVA_DOCUMENTS` | PDF    | AI-enriched names and descriptions |
  </Accordion>
</AccordionGroup>

<Warning>
  **Document Format Conversion:** Documents from the Enterprise Register may
  arrive in TIF, HTML, EDOC, or ASICE format. All non-PDF formats are
  automatically converted to PDF before delivery. The `format` field in
  available documents reflects the output format (PDF), not the original source
  format.
</Warning>

<Note>
  **Annual Report Deduplication:** The UR API may return multiple versions of
  the same annual report (including DUF structured data files). The system
  automatically filters out DUF files and deduplicates by year+format, keeping
  only the most recent version.
</Note>

## Example API Responses

All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "<id>", "countryCode": "LV", "dataPoints": ["company", "legalRepresentatives"] }`

<AccordionGroup>
  <Accordion title="Active SIA (Limited Liability Company), with shareholders and UBOs">
    ```json theme={null}
    {
      "company": {
        "id": "40103217882",
        "countryCode": "LV",
        "identifiers": { "registrationNumber": "40103217882" },
        "legalName": "Piemērs Tehnoloģijas SIA",
        "incorporationDate": "2010-05-20",
        "status": { "localName": "Reģistrēts", "active": true, "statusDetails": { "status": "ACTIVE" } },
        "legalForm": { "localName": "Sabiedrība ar ierobežotu atbildību (SIA)", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "V9QP" },
        "capital": { "amount": 2800, "currency": "EUR" },
        "activities": {
          "NACE": [{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": false }],
          "ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }]
        },
        "legalAddress": { "addressLine1": "Brīvības iela 100", "city": "Rīga", "postalCode": "LV-1001", "countryCode": "LV" }
      },
      "legalRepresentatives": [
        { "type": "individual", "role": { "localName": "Valdes priekšsēdētājs", "englishTranslation": "Chairman of the Board", "standardized": "Chairman of the Board" }, "startDate": "2010-05-20", "representationMode": { "mode": "sole" }, "individual": { "name": { "fullName": "Jānis BĒRZIŅŠ", "firstName": "Jānis", "lastName": "BĒRZIŅŠ" }, "birthDate": { "year": 1985, "month": 3, "day": 15 }, "nationality": "LV" } },
        { "type": "individual", "role": { "localName": "Valdes loceklis", "englishTranslation": "Board Member", "standardized": "Board Member" }, "startDate": "2012-08-10", "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Anna KALNIŅA", "firstName": "Anna", "lastName": "KALNIŅA" }, "birthDate": { "year": 1990, "month": 7, "day": 22 }, "nationality": "LV" } }
      ],
      "otherKeyPersons": [
        { "type": "individual", "role": { "localName": "Padomes priekšsēdētājs", "englishTranslation": "Chairman of Supervisory Board", "standardized": "Supervisory Board Member" }, "startDate": "2010-05-20", "individual": { "name": { "fullName": "Pēteris OZOLS" }, "nationality": "LV" } }
      ],
      "shareholders": [
        { "type": "individual", "sharePercentage": 60, "numberOfShares": 168, "individual": { "name": { "fullName": "Jānis BĒRZIŅŠ" } }, "nominalCapitalHeld": { "amount": 1680, "currency": "EUR" } },
        { "type": "company", "sharePercentage": 40, "numberOfShares": 112, "company": { "id": "40003000771", "countryCode": "LV", "legalName": "Nordic Holdings AS", "identifiers": { "registrationNumber": "40003000771" } }, "nominalCapitalHeld": { "amount": 1120, "currency": "EUR" } }
      ],
      "ultimateBeneficialOwners": [
        {
          "name": { "fullName": "Jānis BĒRZIŅŠ", "firstName": "Jānis", "lastName": "BĒRZIŅŠ" },
          "birthDate": { "year": 1985, "month": 3, "day": 15 },
          "nationality": "LV",
          "residenceAddress": { "countryCode": "LV" },
          "control": {
            "types": ["OWNERSHIP_OF_SHARES", "VOTING_RIGHTS"],
            "description": "As shareholder with 60% shares and 60% voting rights",
            "details": [
              { "type": "SHARES", "percentageValue": 60 },
              { "type": "VOTING_RIGHTS", "percentageValue": 60 }
            ]
          }
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="Closed Company (Removed from Register)">
    ```json theme={null}
    {
      "company": {
        "id": "50003090101",
        "countryCode": "LV",
        "identifiers": { "registrationNumber": "50003090101" },
        "legalName": "Vecais Uzņēmums SIA",
        "incorporationDate": "2003-01-15",
        "status": { "localName": "Izslēgts no reģistra", "active": false, "statusDetails": { "status": "CLOSED", "closureReason": "ADMINISTRATIVE_DISSOLUTION", "closureDate": "2022-06-30" } },
        "legalForm": { "localName": "Sabiedrība ar ierobežotu atbildību (SIA)", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company" },
        "capital": { "amount": 2000, "currency": "EUR" },
        "legalAddress": { "addressLine1": "Elizabetes iela 50", "city": "Rīga", "postalCode": "LV-1050", "countryCode": "LV" }
      }
    }
    ```

    **Note:** Closed companies have `active: false` with a `closureDate` and `closureReason`. Different removal reasons (reorganization, liquidation, administrative dissolution) are mapped to specific closure reasons.
  </Accordion>

  <Accordion title="Company in Liquidation">
    ```json theme={null}
    {
      "company": {
        "id": "40003555777",
        "countryCode": "LV",
        "identifiers": { "registrationNumber": "40003555777" },
        "legalName": "Likvidējamais Uzņēmums SIA",
        "incorporationDate": "2008-11-20",
        "status": { "localName": "Likvidācijas procesā", "active": false, "statusDetails": { "status": "UNDER_INSOLVENCY_PROCEEDING", "closureReason": "LIQUIDATION", "insolvencyStartDate": "2024-03-15" } },
        "legalForm": { "localName": "Sabiedrība ar ierobežotu atbildību (SIA)", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company" },
        "capital": { "amount": 5000, "currency": "EUR" },
        "legalAddress": { "addressLine1": "Krišjāņa Barona iela 30", "city": "Rīga", "postalCode": "LV-1011", "countryCode": "LV" }
      },
      "legalRepresentatives": [
        { "type": "individual", "role": { "localName": "Likvidators", "englishTranslation": "Liquidator", "standardized": "Liquidator" }, "startDate": "2024-03-15", "individual": { "name": { "fullName": "Ivars LIEPA" }, "nationality": "LV" } }
      ]
    }
    ```

    **Note:** Companies in liquidation have status `Likvidācijas procesā` (Under Insolvency Proceeding) with the liquidation start date. The liquidator replaces board members as the legal representative.
  </Accordion>

  <Accordion title="Association (Non-profit)">
    ```json theme={null}
    {
      "company": {
        "id": "40008123456",
        "countryCode": "LV",
        "identifiers": { "registrationNumber": "40008123456" },
        "legalName": "Latvijas Sporta Biedrība",
        "incorporationDate": "2015-09-01",
        "status": { "localName": "Reģistrēts", "active": true, "statusDetails": { "status": "ACTIVE" } },
        "legalForm": { "localName": "Biedrība", "englishTranslation": "Association", "standardized": "Nonprofit Organization" },
        "activities": {
          "NACE": [{ "code": "93.12", "description": "Activities of sport clubs", "isAIInferred": false }],
          "ISIC": [{ "code": "9312", "description": "Activities of sport clubs", "isAIInferred": true }]
        },
        "legalAddress": { "addressLine1": "Stadionu iela 5", "city": "Rīga", "postalCode": "LV-1013", "countryCode": "LV" }
      },
      "legalRepresentatives": [
        { "type": "individual", "role": { "localName": "Valdes priekšsēdētājs", "englishTranslation": "Chairman of the Board", "standardized": "Chairman of the Board" }, "individual": { "name": { "fullName": "Mārtiņš LIEPIŅŠ" } } }
      ]
    }
    ```

    **Note:** Non-profit associations do not have shareholders or share capital. Legal representatives (board members) are available. Activity codes may use the non-profit activity area classification instead of NACE.
  </Accordion>

  <Accordion title="UBO Response (dedicated datapoint)">
    Query with `"dataPoints": ["ultimateBeneficialOwners"]`:

    ```json theme={null}
    {
      "ultimateBeneficialOwners": [
        {
          "name": {
            "fullName": "Jānis BĒRZIŅŠ",
            "firstName": "Jānis",
            "lastName": "BĒRZIŅŠ"
          },
          "birthDate": { "year": 1985, "month": 3, "day": 15 },
          "nationality": "LV",
          "residenceAddress": { "countryCode": "LV" },
          "identifiers": { "personalCode": "150385-12345" },
          "control": {
            "types": ["OWNERSHIP_OF_SHARES", "VOTING_RIGHTS"],
            "description": "As shareholder with 75% shares and 75% voting rights",
            "details": [
              { "type": "SHARES", "percentageValue": 75 },
              { "type": "VOTING_RIGHTS", "percentageValue": 75 }
            ]
          }
        },
        {
          "name": {
            "fullName": "Anna KALNIŅA",
            "firstName": "Anna",
            "lastName": "KALNIŅA"
          },
          "birthDate": { "year": 1990, "month": 7, "day": 22 },
          "nationality": "LV",
          "residenceAddress": { "countryCode": "LV" },
          "control": {
            "types": ["OWNERSHIP_OF_SHARES"],
            "description": "As member with 25% shares",
            "details": [{ "type": "SHARES", "percentageValue": 25 }]
          }
        }
      ]
    }
    ```

    **Note:** UBOs are available directly from the Enterprise Register, no separate retrieve required. The `natureOfControl` field uses known enum values: `AS_MEMBER`, `AS_FOUNDATION_FOUNDER`, `AS_OWNER`, `ON_GROUNDS_OF_PROPERTY_RIGHT`, `AS_SHAREHOLDER`. Includes share and voting rights percentages when declared.
  </Accordion>

  <Accordion title="Available Documents (company example)">
    Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.

    **All entity types:**

    | API Category                    | Document                                                  | Catalog item                     | Notes                                     |
    | ------------------------------- | --------------------------------------------------------- | -------------------------------- | ----------------------------------------- |
    | `certifiedTradeRegisterExtract` | Certified Trade Register Extract (e-sealed PDF)           | `LVA_CERTIFIED_REGISTER_EXTRACT` | Always available for registered companies |
    | `financialStatements[]`         | Annual Reports                                            | `LVA_FINANCIAL_STATEMENTS`       | When filed, deduplicated by year          |
    | `articlesOfAssociation[]`       | Articles of Association / Amendments                      | `LVA_ARTICLES_OF_ASSOCIATION`    | When filed                                |
    | Various (see Documents section) | Registration cert., shareholder register, protocols, etc. | `LVA_DOCUMENTS`                  | Based on what company has filed           |
  </Accordion>
</AccordionGroup>
