# Volley — 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.

> Access real-time Russian volleyball match schedules, results, and team lineups from the official VFV federation database. Plan your viewing, track team performance, and stay updated on roster compositions for matches across all major Russian volleyball competitions.

**Category:** Sports | **Website:** [volley.ru/](https://volley.ru/) | **Docs:** [parse.bot/marketplace/8390f06e-5e37-48a1-99cc-6d3a6c8307c3/volley-ru-api](https://parse.bot/marketplace/8390f06e-5e37-48a1-99cc-6d3a6c8307c3/volley-ru-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/volley/`
**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

### Get match lineup

Retrieve team rosters for a specific match including player names, jersey numbers, positions, and physical attributes. Positions are fetched from individual player profiles, which adds latency proportional to roster size (~27 requests). Coaching staff data is not available on the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Match identifier from volley.ru (obtainable from get_matches results). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/volley/get-match-lineup \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### Get matches

Retrieve volleyball matches from a competition. Returns match list with IDs, teams, dates, scores, set results, stage, and venue. Results are auto-iterated from a single competition page. When a date filter is applied, only matches on that specific date are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | No | Competition identifier from volley.ru (e.g. from a calendar page URL). When omitted, defaults to Кубок России 2026 Мужчины. |
| `date` | string | No | Filter matches to a specific date in ISO format YYYY-MM-DD (e.g. 2026-05-17). When omitted, all matches in the competition are returned. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/volley/get-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>","date":"<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.