DEVELOPER API REFERENCE v1

Pan-European Corporate Data API

Connect 40M+ verified European companies directly to your CRM, ERP, and underwriting systems with sub-50ms latency.

Database Size

23,000,000+

Official European Entities
Average Latency

< 45ms

Indexed Primary Key Engine
Uptime SLA

99.98%

Redundant Node Cluster
Live Registries

NL, PL, DK, LT

Real-time KVK / CVR Fallback
Architecture

API Overview & Architecture

The Rekvi.app REST API provides programmatic access to official business registry records, financial statements, executive networks, and credit risk evaluations across Europe.

Pan-European Coverage

Netherlands (KVK), Poland (KRS/CEIDG), Denmark (CVR), Lithuania (JAR), Estonia, Latvia, etc.

Live Fallback Engine

Recently registered companies not yet synced are retrieved on-demand directly from government registries.

Deterministic JSON

Unified schema across all jurisdictions: registration code, VAT, address, directors, financials.

Getting Started

Quickstart & Integration Flow

Start querying 40M+ companies in less than 2 minutes using standard REST endpoints and JSON payloads.

Base URLhttps://rekvi.app/api/v1
Quick cURL Test:
curl -H "Authorization: Bearer YOUR_API_KEY" "https://rekvi.app/api/v1/search?q=tavoweb&country=lt"
Security

Authentication & Security

Authenticate all API requests using a Bearer token or custom header. API keys can be generated and managed directly in your dashboard.

Standard

Authorization Bearer

Authorization: Bearer rk_live_9a7f4...

Recommended standard HTTP header convention.

Alternative

X-API-Key Header

X-API-Key: rk_live_9a7f4...

Supported for custom gateways and reverse proxies.

Security Best Practice:

Never expose production API keys in client-side code. Always issue requests from secure backend services or serverless workers with environment variables.

Enterprise Integrations

CRM, ERP & Underwriting Integrations

Streamline automated VAT validation, customer KYC onboarding, invoice enrichment, and supplier solvency checks across multiple jurisdictions.

Checkout & Onboarding

Auto-fill company name, VAT code, and official legal address automatically when a business registers.

Automated KYC & AML

Verify company active status, bankruptcy flags, and debt registry records before credit terms approval.

ERP Registry Sync

Keep accounting records, suppliers, and customer master files in sync with European national registries.

REST Specifications

REST Endpoints Reference

GET/api/v1/company/:country/:code
Auth: Required

Retrieve complete registry details, corporate address, NACE/SBI industry activities, executive directors, workforce, balance sheets, and credit risk scores.

Path Parameters

ParameterTypeDescription
:countrystring2-letter ISO country code (`lt`, `nl`, `pl`, `dk`, `de`, `lu`, etc.).
:codestringOfficial national registration code (e.g. Lithuanian code `619051` or `302485641`).

Example Dossier JSON Response

{
  "success": true,
  "data": {
    "id": "LT_619051",
    "country": "LT",
    "registration_code": "619051",
    "vat_code": null,
    "name": "TavoWEB",
    "legal_form": "UAB",
    "status": "ACTIVE",
    "registration_date": "2011-02-01",
    "deregistration_date": null,
    "registered_address": "Girionių g 60, Kaunas",
    "postal_code": "45488",
    "municipality": "Kaunas",
    "share_capital": null,
    "currency": "EUR",
    "nace": {
      "code": "00.00",
      "description": "IT paslaugos"
    },
    "management": {
      "director_name": "Mindaugas Bartusevičius",
      "officers": []
    },
    "workforce": {
      "employees": 1,
      "avg_salary": 1200
    },
    "contacts": {
      "phone": "+37069370376",
      "email": "[email protected]",
      "website": "https://www.tavoweb.lt"
    },
    "financials": [],
    "vehicles": [],
    "credit_risk": {
      "score": 15,
      "rating": "A1"
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-10-11T18:46:20.306Z",
    "quota_remaining": 98
  }
}
GET/api/v1/usage
Auth: Required

Verify your API key health, active subscription tier, and remaining weekly quota.

Example Response (200 OK)

{
  "status": "active",
  "plan": "pro",
  "weekly_limit": 100,
  "calls_used": 14,
  "calls_remaining": 86,
  "rate_limit_per_minute": 60,
  "billing_cycle_reset": "2026-11-02T00:00:00Z"
}
Code Integrations

Multi-Language Code Snippets

Ready-to-use code examples for common programming languages and integration stacks.

# 1. Ieškoti įmonės pagal pavadinimą arba kodą
curl -X GET "https://rekvi.app/api/v1/search?q=tavoweb&country=lt" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 2. Gauti pilną įmonės dosjė (finansai, vadovai, reitingas)
curl -X GET "https://rekvi.app/api/v1/company/lt/619051" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. Tikrinti API kvotą ir limitus
curl -X GET "https://rekvi.app/api/v1/usage" \
  -H "X-API-Key: YOUR_API_KEY"
Interactive Playground

Interactive API Console

Test live API endpoints directly in your browser. Enter your key to inspect real JSON responses.

Rate Limits

Rate Limits & Quota Tiers

API rate limits are enforced per minute and tracked on a weekly quota (Free: 10 req/week, Pro: 100 req/week, Enterprise: 10,000 req/week). HTTP 429 Too Many Requests is returned if exceeded.

Subscription PlanWeekly QuotaPer-Minute Rate LimitSupport & SLA
Free Developer10 calls / week10 req / minCommunity Docs
Pro Integration100 calls / week60 req / minStandard Email SLA
Enterprise Scale10,000 calls / week600 req / minDedicated Slack & 99.98% SLA

Standard Rate Limit Headers

X-RateLimit-Limit

Maximum allowed calls in the active minute window.

X-RateLimit-Remaining

Remaining calls before HTTP 429 throttling.

X-RateLimit-Reset

Unix epoch timestamp when the current rate limit resets.

Error Handling

HTTP Status Codes & Errors

Status CodeMeaningAction Required
200 OKRequest succeeded. Valid JSON payload returned.Process the response.
400 Bad RequestMissing query string, query too short, or invalid country format.Verify required parameters and parameter lengths.
401 UnauthorizedMissing or invalid API key header.Generate or verify your key in /dashboard/api-keys.
404 Not FoundCompany registration code not found in national registry.Confirm country and legal registration number.
429 Too Many RequestsRate limit per minute or weekly quota exhausted.Slow down requests or upgrade subscription tier.
500 Server ErrorInternal server or national government registry timeout.Retry request with exponential backoff.

Ready to build your integration?

Log in to your dashboard, generate an instant API key, and connect 40M+ European companies to your workflows today.