API Documentation

The v1 API serves the same records the website publishes. Company data always requires an account key. A Free key returns entity name, classification, country, status, verification state, website, overview and record timestamps. A Premium key adds contacts, leadership, branches, financial bands, certifications, technology and commercial signals.

Base URL: https://varosyanllc.com. Every response carries X-Request-Id, X-Api-Version, X-Api-Tier and rate limit headers.

• GET /api/public/v1/companies

  Search records. Parameters: q, country, category, status, verified, city, legal_form, licence_status, activity, incorporated_from, incorporated_to, has_website, has_email, has_phone, has_address, has_registry, sort, page, page_size.

• GET /api/public/v1/companies/{country}/{slug}

  One record with registration details, branches, people, record events and commercial signals.

• GET /api/public/v1/countries

  Indexed countries and coverage state.

• GET /api/public/v1/categories

  Classifications with record counts. Optional country parameter.

• GET /api/public/v1/coverage

  Totals for records, active records, countries and classifications.

These call live reference endpoints from your browser. Company endpoints require an account key, which you should use only from your own server-side systems.

Company data endpoints require a key. Create one on API keys with any account, then send it from server-side code:

curl "https://varosyanllc.com/api/public/v1/companies?country=QA&q=trading&page_size=5" \
  -H "Authorization: Bearer vk_live_..."

Free account: 100 requests per rolling 24 hours, with everything a signed-in visitor sees on the website. Premium account: 5,000 requests per rolling 24 hours and the complete record, including financials, technology and signals. Exceeding the limit returns HTTP 429 with code rate_limited. Errors are machine readable:

{
  "error": { "code": "not_found", "message": "No record matches that country and slug." },
  "request_id": "5f2c…"
}

{
  "data": [{
    "id": "…",
    "name": "Registered entity name",
    "slug": "registered-entity-name-123456",
    "country_code": "QA",
    "category": "Trading",
    "status": "Active",
    "verified": false,
    "url": "https://varosyanllc.com/qatar/company/registered-entity-name-123456"
  }],
  "page": 1,
  "page_size": 25,
  "total": 76136,
  "total_pages": 3046,
  "tier": "anonymous"
}