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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-volley-ru-api-8390f06e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-volley-ru-api-8390f06e/get_match_lineup \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-volley-ru-api-8390f06e/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>","date":"<string>"}'
```