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

# Latvia Company Data – Search, Lite Profile, and Enhanced Profile Updates

> Latvia V2 Search, Lite Profile, and Enhanced Profile responses updated with improved data quality and additional fields following the migration from EBR to a new provider.

## Overview

In Kyckr's migration from the EBR (European Business Registry Network), we've updated Search, Lite Profile, and Enhanced Profile responses for Latvia (ISO code LV). Enhanced Profiles remain available and have been improved with better data quality and additional fields.

## Search results

We've improved the structure and data quality of Search responses for Latvia companies.

### Response structure changes

The search response structure has been updated for better consistency and additional company information.

**Before:**

```json theme={null}
{
  "data": [
    {
      "id": "LV|MTIzNDU2Nzg5MDF8TFZSRQ",
      "companyName": "SIA \"Example Company\"",
      "companyNumber": "12345678901",
      "address": "Example iela 1, Rīga, Latvia",
      "registrationAuthority": "Register of Enterprises"
    }
  ]
}
```

**After:**

```json theme={null}
{
  "data": [
    {
      "id": "LV|MTIzNDU2Nzg5MDE",
      "companyName": "SIA \"Example Company\"",
      "companyNumber": "12345678901",
      "address": "Rīga, Example iela 1, LV-1046",
      "status": "Registered",
      "type": "Limited liability company",
      "startDate": "2006-05-15",
      "registrationAuthority": "Register of Enterprises of the Republic of Latvia"
    }
  ]
}
```

### Key changes

* **Address format**: Address now includes the postcode and uses a new format
* **Start date**: `startDate` field is now included, providing the company's start date in ISO format
* **Legal status**: `status` field is now populated (e.g., "Registered")
* **Entity type**: `type` field is now populated (e.g., "Limited liability company")
* **Registration authority**: Now uses full name "Register of Enterprises of the Republic of Latvia"

## Lite profile changes

The response structure has been updated due to the new provider, with improved address parsing, activity data, and additional fields.

### Response structure changes

**Before (V2 format):**

```json theme={null}
{
  "data": {
    "orderId": 5272007,
    "correlationId": "019c9d98-e305-719c-b8c8-087c6ccab587",
    "cost": {
      "type": "lite",
      "value": 1
    },
    "timeStamp": "2026-02-27T05:36:11.6924143Z",
    "details": "Success",
    "data": {
      "activity": [
        {
          "description": "35.15 - Trade of electricity",
          "type": "Primary"
        }
      ],
      "address": {},
      "companyNumber": "12345678901",
      "companyName": "SIA \"Example Company\"",
      "foundationDate": {
        "original": "15.05.2006"
      },
      "registrationDate": {
        "original": "15.05.2006"
      },
      "legalForm": {
        "original": "Limited liability company (SIA)"
      },
      "legalStatus": {
        "original": "Reģistrēts"
      },
      "registrationAuthority": "Register of Enterprises of the Republic of Latvia"
    }
  }
}
```

**After (V2 format):**

```json theme={null}
{
  "data": {
    "orderId": 335370,
    "correlationId": "019c9d99-0291-719c-ad5b-21f1d7a94b70",
    "cost": {
      "type": "lite",
      "value": 1
    },
    "timeStamp": "2026-02-27T05:36:19.116857Z",
    "details": "Success",
    "data": {
      "activity": [
        {
          "code": "35.15",
          "description": "Trade of electricity",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        },
        {
          "code": "35.40",
          "description": "Activities of brokers and agents for electric power and natural gas",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        },
        {
          "code": "35.14",
          "description": "Distribution of electricity",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        }
      ],
      "address": {
        "type": "Registered Address",
        "fullAddress": "Rīga, Example iela 1",
        "rawAddressLines": [
          "Rīga, Example iela 1"
        ],
        "streetNumber": "1",
        "streetName": "Example iela",
        "city": "Rīga",
        "postcode": "LV-1046",
        "country": "Latvija",
        "secondaryPostalCode": "100003003"
      },
      "companyNumber": "12345678901",
      "companyName": "SIA \"Example Company\"",
      "otherIdentifiers": [
        {
          "type": "LV_VAT_CD",
          "value": "LV12345678901"
        }
      ],
      "foundationDate": {
        "original": "2006-05-15",
        "normalized": "2006-05-15"
      },
      "registrationDate": {
        "original": "2006-05-15",
        "normalized": "2006-05-15"
      },
      "legalForm": {
        "original": "Limited liability company"
      },
      "legalStatus": {
        "original": "Registered",
        "normalized": "Active"
      },
      "registrationAuthority": "Register of Enterprises of the Republic of Latvia",
      "aliases": [
        {
          "name": "Example Co",
          "type": "Trading Name"
        }
      ]
    }
  }
}
```

### Field mapping changes

#### Activity data

Activity (NACE code) information is now properly populated:

**Key improvements:**

* Activity codes (`code`) are now populated separately from descriptions
* Activity codes were previously embedded in the description (e.g., "35.15 - Trade of electricity")
* Multiple activities are now captured when available
* `classificationScheme` field is now included (e.g., "NACErev2")

#### Address structure

The address structure has been enhanced with better parsing and structured fields:

**Key improvements:**

* `address` is now fully populated (previously an empty object `{}`)
* `type` field is now included to specify the address type (e.g., "Registered Address")
* Structured fields added: `streetNumber`, `streetName`, `city`, `postcode`, `country`
* `rawAddressLines` array provides the original address components
* `fullAddress` provides the complete address string
* `secondaryPostalCode` provides additional postal code information

#### Date fields

**Key improvements:**

* Date normalization has been improved for consistency
* `foundationDate` and `registrationDate` now use ISO format (YYYY-MM-DD) in both original and normalized fields
* Previously dates used DD.MM.YYYY format
* `normalized` field is now included for dates

#### Legal form and status

**Key changes:**

* `legalForm.original` now uses shorter form (e.g., "Limited liability company" instead of "Limited liability company (SIA)")
* `legalStatus.original` now provides English translation (e.g., "Registered" instead of "Reģistrēts")
* `legalStatus.normalized` is now included (e.g., "Active")

#### Other changes

**New fields added:**

* `otherIdentifiers` array for additional company identifiers including VAT numbers
* `aliases` array with structured objects containing `name` and `type` fields

## Enhanced profile changes

The response structure has been updated due to the new provider, with improved data quality across multiple fields.

### Response structure changes

**Before (V2 format):**

```json theme={null}
{
  "data": {
    "orderId": 5272094,
    "correlationId": "019c9da7-b8f9-719c-b183-b6a8f06d9c26",
    "cost": {
      "type": "credit",
      "value": 3
    },
    "timeStamp": "2026-02-27T05:52:23.1696308Z",
    "details": "Success",
    "data": {
      "addresses": [
        {
          "type": "Address of the local main office",
          "fullAddress": "Example iela 1, Rīga, Latvia",
          "buildingName": "Example iela 1",
          "city": "Rīga",
          "country": "Latvia"
        }
      ],
      "representatives": {
        "corporations": [
          {
            "role": {
              "original": "Member of the board"
            },
            "isActive": true,
            "registeredAddress": {},
            "type": "Corporation",
            "name": "John Smith"
          }
        ]
      },
      "identifiers": {
        "primaryRegistrationNumber": "12345678901"
      },
      "companyName": "SIA \"Example Company\"",
      "aliases": [
        {}
      ],
      "registrationAuthority": "Register of Enterprises",
      "registrationDate": {
        "original": "2006-05-16",
        "normalized": "2006-05-16"
      },
      "status": {
        "original": "Active",
        "normalized": "Active"
      },
      "legalForm": {
        "original": "Sabiedrība ar ierobežotu atbildību"
      },
      "links": {
        "document": "/orders/5272094/download",
        "data": "/orders/5272094/download?format=json"
      }
    }
  }
}
```

**After (V2 format):**

```json theme={null}
{
  "data": {
    "orderId": 335390,
    "correlationId": "019c9da7-d4ca-719c-94a6-bccc36c407c8",
    "cost": {
      "type": "credit",
      "value": 3
    },
    "timeStamp": "2026-02-27T05:52:29.4860909Z",
    "details": "Success",
    "data": {
      "activities": [
        {
          "code": "35.15",
          "description": "Trade of electricity",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        },
        {
          "code": "35.40",
          "description": "Activities of brokers and agents for electric power and natural gas",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        },
        {
          "code": "35.14",
          "description": "Distribution of electricity",
          "classificationScheme": "NACErev2",
          "type": "Primary"
        }
      ],
      "addresses": [
        {
          "type": "Registered Address",
          "fullAddress": "Rīga, Example iela 1",
          "rawAddressLines": [
            "Rīga, Example iela 1"
          ],
          "streetNumber": "1",
          "streetName": "Example iela",
          "city": "Rīga",
          "postcode": "LV-1046",
          "country": "Latvija",
          "secondaryPostalCode": "100003003"
        }
      ],
      "capital": [
        {
          "type": "APM",
          "description": "Paid capital",
          "classCode": "APM",
          "classDescription": "Paid capital",
          "quantity": 213.0,
          "totalNominalValue": 2982.0,
          "currency": "EUR",
          "shareholdings": [
            {
              "percentage": "100.00",
              "count": 213,
              "totalNominalValue": 2982.0,
              "shareholders": {
                "corporations": [
                  {
                    "registrationNumber": "12345678",
                    "type": "Corporation",
                    "name": "EXAMPLE HOLDINGS OÜ",
                    "address": {
                      "fullAddress": "Example maantee 141, 11314 Tallinn, Igaunija",
                      "isoCode": "EE"
                    }
                  }
                ]
              }
            }
          ]
        }
      ],
      "totalCapital": {
        "totalValue": 2982.0,
        "currency": "EUR"
      },
      "representatives": {
        "individuals": [
          {
            "role": {
              "original": "VLO",
              "normalized": "Member of the Board"
            },
            "startDate": {
              "original": "2014-03-06",
              "normalized": "2014-03-06"
            },
            "isActive": true,
            "powers": [
              "Right of sole representation"
            ],
            "birthdate": {
              "original": "1970-01-15",
              "normalized": "1970-01-15"
            },
            "type": "Person",
            "idNumber": "123456-78901",
            "name": "Smith John",
            "address": {
              "isoCode": "EE"
            }
          }
        ]
      },
      "identifiers": {
        "primaryRegistrationNumber": "12345678901",
        "otherIdentifiers": [
          {
            "type": "LV_VAT_CD",
            "value": "LV12345678901"
          }
        ]
      },
      "companyName": "SIA \"Example Company\"",
      "aliases": [
        {
          "name": "Example Co",
          "type": "Trading Name"
        }
      ],
      "registrationAuthority": "Register of Enterprises of the Republic of Latvia",
      "registrationDate": {
        "original": "2006-05-15",
        "normalized": "2006-05-15"
      },
      "status": {
        "original": "Registered",
        "normalized": "Active"
      },
      "legalForm": {
        "original": "Limited liability company"
      },
      "links": {
        "document": "/orders/335390/download",
        "data": "/orders/335390/download?format=json"
      }
    }
  }
}
```

### Field mapping changes

#### Activity data

**Key improvements:**

* `activities` array is now populated with activity codes and descriptions (previously missing)
* `description` is now included for all activities
* `classificationScheme` field is now included (e.g., "NACErev2")

#### Address structure

The address structure has been enhanced with better parsing:

* `type` now uses standardized descriptions (e.g., "Registered Address" instead of "Address of the local main office")
* `rawAddressLines` array provides the original address components
* Address fields are now properly parsed (previously `buildingName` contained street address data)
* `streetNumber` and `streetName` fields now provide the street address separately
* `postcode` is now populated
* `country` is now populated (e.g., "Latvija")
* `secondaryPostalCode` provides additional postal code information

#### Capital and shareholdings

**Key improvements:**

* `capital` array is now populated with capital information (previously missing)
* `shareholdings` array is now included with detailed shareholder information
* Shareholder details include: `registrationNumber`, `name`, `type` (Corporation), `percentage`, `count`, `totalNominalValue`, and `address`
* `currency` uses ISO codes (e.g., "EUR")
* `classCode` and `type` fields are now populated (e.g., "APM")
* `description` and `classDescription` now use standardized values (e.g., "Paid capital")
* `totalCapital` object provides aggregate capital information with `totalValue` and `currency`
* `quantity` field provides the share quantity

#### Legal form

**Key changes:**

* `legalForm.original` now provides English translated legal form (e.g., "Limited liability company" instead of "Sabiedrība ar ierobežotu atbildību")

#### Status

**Key changes:**

* `status.original` now provides English translation (e.g., "Registered" instead of "Active")
* `status.normalized` continues to provide normalized status (e.g., "Active")

#### Registration date

**Key changes:**

* `registrationDate` now uses correct date with ISO format
* Date accuracy improved (was "2006-05-16", now "2006-05-15")

#### Identifiers

**Key changes:**

* `otherIdentifiers` array is now included with VAT numbers and other identifiers
* Each identifier contains `type` and `value` (e.g., `{"type": "LV_VAT_CD", "value": "LV12345678901"}`)
* `primaryRegistrationNumber` continues to contain the company registration number

#### Aliases

**Key changes:**

* `aliases` array now contains structured objects with `name` and `type` fields
* Previously contained empty objects (`{}`)

#### Representatives

**Key improvements:**

* Representatives are now correctly mapped to `individuals` array instead of `corporations`
* Previously, individual representatives were incorrectly mapped to `corporations`
* Individual representatives now include:
  * `birthdate` with `original` and `normalized` values
  * `role` with both `original` (Latvian code like "VLO") and `normalized` (English translation) values
  * `startDate` for appointment dates
  * `powers` array for representation rights (e.g., "Right of sole representation")
  * `address` with `isoCode`

## Additional resources

* [Lite Profile Documentation](/documentation/features/verify-basic-details-v2)
* [Enhanced Profile Documentation](/documentation/features/perform-a-kyb-check-v2)
* [Search API Documentation](/documentation/features/search-for-a-company-v2)