# Scoris — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and analyze Lithuanian companies with detailed business intelligence including financial reports, employee salary data, and performance rankings. Find top companies in your industry, compare financial metrics, and access comprehensive company profiles all in one place.

**Category:** Business Directories | **Website:** [scoris.lt/](https://scoris.lt/) | **Docs:** [parse.bot/marketplace/1570fc84-8984-40f1-982b-64898512fce8/scoris-lt-api](https://parse.bot/marketplace/1570fc84-8984-40f1-982b-64898512fce8/scoris-lt-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### filter_companies

Search and filter Lithuanian companies using criteria such as company size and legal status. Returns paginated results with company code, name, VAT code, and Scoris rating. Useful for market analysis and finding companies by category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name_part` | string | No | Filter by company name fragment |
| `size` | string | No | Company size filter. Accepted values: Stambi, Vidutinė, Smulki, Mikro |
| `status` | string | No | Legal status filter (e.g. Veikiantis for active companies) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/filter_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name_part":"<string>","size":"<string>","status":"<string>"}'
```

### get_company_basic_info

Get detailed basic information about a Lithuanian company including registration details, KPI metrics (profit, share capital, employee count, average salary), shareholder structure, and similar companies. The company_code is the numeric ID returned by search_companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_code` | string | Yes | The unique company registration code (numeric ID from search_companies results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/get_company_basic_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_code":"<string>"}'
```

### get_company_employees_salaries

Get employee count and salary statistics over time for a company, including employee turnover rate and average salary trends extracted from chart data. Returns time-series data for employee counts and salaries plus summary statistics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_code` | string | Yes | The unique company registration code (numeric ID from search_companies results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/get_company_employees_salaries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_code":"<string>"}'
```

### get_company_financials

Get multi-year financial statements and VMI tax arrears history for a company. Returns data organized by section with dynamic keys based on company name. Each section contains an array of row objects mapping column headers to values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_code` | string | Yes | The unique company registration code (numeric ID from search_companies results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/get_company_financials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_code":"<string>"}'
```

### get_top_companies

Get top company rankings from the Scoris database across multiple categories including largest companies, most profitable, top debtors, highest salaries, best/worst ratings, newest companies, and more. Returns all ranking categories with top 3 companies each.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/get_top_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_companies

Search for Lithuanian companies by name or keyword. Returns up to 10 matching results with company IDs, names, VAT codes, and addresses. The search is fuzzy and matches partial names. Each result's id field serves as the company_code for other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term (e.g. company name or keyword) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scoris-lt-api-1570fc84/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```