# Scoris — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/scoris/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/scoris/filter-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scoris/get-company-basic-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scoris/get-company-employees-salaries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scoris/get-company-financials \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scoris/get-top-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scoris/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.