# International Fencing Federation — 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 explore detailed fencer profiles, track athlete rankings, and review competition results and tournament brackets from the International Fencing Federation. Get comprehensive match histories and stay updated on world rankings across all fencing competitions.

**Category:** Sports | **Website:** [fie.org/](https://fie.org/) | **Docs:** [parse.bot/marketplace/f7565d04-a922-47ca-ba25-e51912f39df3/fie-org-api](https://parse.bot/marketplace/f7565d04-a922-47ca-ba25-e51912f39df3/fie-org-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-fie-org-api-f7565d04/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_athlete_profile

Retrieve detailed profile for a specific fencer by numeric ID. Includes biographical information (family, club, handedness, injuries, awards), competition results for a given season, and opponent match history with scores.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID (e.g. '24108'). |
| `category` | string | No | Category: s (senior), j (junior). |
| `season` | string | No | Season year for results filtering. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fie-org-api-f7565d04/get_athlete_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","category":"<string>","season":"<string>"}'
```

### get_athletes_search

Search for fencers by name with optional filters. Returns a paginated list of athletes matching the search criteria. Results include basic athlete info (id, name, country, gender, age). Use the athlete id to fetch a full profile via get_athlete_profile.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name filter (e.g. 'ESTONIA'). |
| `gender` | string | No | Comma-separated gender codes: f (female), m (male). |
| `is_team` | boolean | No | If true, search for team athletes only. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search by athlete name (last name recommended, e.g. 'LEHIS'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fie-org-api-f7565d04/get_athletes_search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","gender":"<string>","is_team":"<boolean>","page":"<integer>","query":"<string>"}'
```

### get_competition_detail

Retrieve details, results, and participants for a specific competition. Includes competition metadata (name, location, dates, weapon, gender, fencerCount, nationCount), registered athletes with rankings, tableau brackets with bout scores, and pool data with match results. Use competition_id and season from get_competitions_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | Numeric competition ID (e.g. '113'). |
| `season` | string | Yes | Season year (e.g. '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fie-org-api-f7565d04/get_competition_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>","season":"<string>"}'
```

### get_competitions_list

List FIE competitions with filters for season, status, weapon, gender, and more. Returns paginated results of competitions. Each competition includes season, competitionId, name, location, country, weapon, gender, category, type, dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Competition category filter. |
| `from_date` | string | No | Start date filter in YYYY-MM-DD format. |
| `gender` | string | No | Comma-separated gender codes: f (female), m (male). |
| `level` | string | No | Competition level filter. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search by competition name. |
| `season` | string | No | Season year (e.g. '2025') or '-1' for all seasons. |
| `status` | string | No | Status filter: 'previous' for past competitions, 'upcoming' for future. |
| `to_date` | string | No | End date filter in YYYY-MM-DD format. |
| `type` | string | No | Comma-separated competition types. |
| `weapon` | string | No | Comma-separated weapon codes: e (epee), f (foil), s (sabre). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fie-org-api-f7565d04/get_competitions_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","from_date":"<string>","gender":"<string>","level":"<string>","page":"<integer>","query":"<string>","season":"<string>","status":"<string>","to_date":"<string>","type":"<string>","weapon":"<string>"}'
```

### get_rankings

Retrieve FIE world rankings with filters for weapon, gender, level, and season. Returns top-ranked fencers (top 3) and paginated full rankings list. Each fencer includes id, name, country, rank, points, weapon.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name filter (e.g. 'ITALY'). |
| `gender` | string | No | Gender: f (female), m (male). |
| `level` | string | No | Level: s (senior), j (junior), c (cadet). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search by athlete name within rankings. |
| `season` | string | No | Season year. |
| `type` | string | No | Ranking type: i (individual), t (team). |
| `weapon` | string | No | Weapon: s (sabre), e (epee), f (foil). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fie-org-api-f7565d04/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","gender":"<string>","level":"<string>","page":"<integer>","query":"<string>","season":"<string>","type":"<string>","weapon":"<string>"}'
```