API Documentation

Professional REST APIs for accessing comprehensive Latvian company registry data and European banking information with advanced search capabilities and real-time updates.

Fast & Reliable

High-performance APIs with 50-100ms response times and 99.9% uptime

Secure

Token-based authentication with granular permissions and IP whitelisting

Developer Friendly

RESTful design with comprehensive documentation and code examples

Quick Start

Get started with our RESTful APIs in minutes. All endpoints require authentication and return JSON responses.

Base URL

https://api.clients.lv/api

Available APIs

3 APIs

Companies API

UNIFIED

Unified API for accessing comprehensive Latvian company registry data. Single endpoint with conditional data blocks including company details, VAT status, liquidation information, shareholders, and equity capital.

Conditional Data Blocks Permission-Based Multiple Data Sources Advanced Search

View Documentation

4 endpoints • 5 data blocks

VAT Validation API

VALIDATION

Validate European VAT numbers with comprehensive format checking for all 28 EU countries. Database validation and company data retrieval available for Latvian VAT numbers with real-time status verification.

EU VAT Validation 28 Countries Latvian Database Company Data

View Documentation

2 endpoints • EU + Latvia

IBAN-to-BIC Mapping

AUTONOMOUS

Autonomous IBAN-to-BIC lookup without external API dependencies. Provides exact-match bank identification from official central bank sources for 6 European countries.

IBAN Validation BIC Resolution Official Sources Exact Match Only

View Documentation

1 endpoint • 6 countries

Authentication & Permissions

Permission-Based API Access

All API endpoints require authentication using Bearer tokens. Different data blocks are included in responses based on your token's specific permissions, allowing for granular access control.

Required Permission

companies:read

Basic company registry data and search functionality

Optional Data Blocks

companies_pvn:read VAT data

companies_participants:read Shareholders

companies_equity:read Equity capital

companies_liquidations:read Liquidation status

Other APIs

vat:read VAT number validation

banks:read European & Latvian banks

Request Format

cURL Example

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Accept: application/json" \
     https://api.clients.lv/api/companies?name=SIA

Rate Limiting

API requests are intelligently limited to ensure fair usage and optimal system performance for all users.

Default Limits

Per Hour 1,000 requests

Per Minute 100 requests

Response Headers

Limit X-RateLimit-Limit

Remaining X-RateLimit-Remaining

Response Format

All API responses are returned in JSON format with conditional data blocks based on your token's permissions.

Basic Response

companies:read only

JSON Response

{
  "current_page": 1,
  "data": [
    {
      "regcode": "40203029397",
      "name": "SIA \"Example Company\"",
      "type": "SIA",
      "address": "Rīga, Brīvības iela 1-1",
      "registered": "2020-01-15T00:00:00.000000Z",
      "has_vat_data": true,
      "has_equity_data": true,
      "has_participant_data": true,
      "has_liquidation_data": false
    }
  ],
  "total": 1500
}

Enhanced Response

with additional permissions

Enhanced JSON Response

{
  "regcode": "40203029397",
  "name": "SIA \"Example Company\"",
  "type": "SIA",
  "address": "Rīga, Brīvības iela 1-1",
  "registered": "2020-01-15T00:00:00.000000Z",

  "vat_data": {
    "is_vat_payer": true,
    "vat_number": "LV40203029397",
    "vat_status": "active"
  },

  "participants_data": {
    "summary": {
      "total_count": 2,
      "natural_persons": 1,
      "legal_entities": 1
    }
  },

  "equity_data": {
    "latest_equity": {
      "amount": 50000,
      "currency": "EUR",
      "formatted_amount": "50,000.00 EUR"
    }
  }
}

HTTP Status Codes

Code	Status	Description
200	OK	Request successful
400	Bad Request	Invalid request parameters
401	Unauthorized	Authentication required or invalid
404	Not Found	Resource not found
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error occurred