# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/international-fencing-federation/`
**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 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/credits/international-fencing-federation/get-athlete-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/international-fencing-federation/get-athletes-search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/international-fencing-federation/get-competition-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/international-fencing-federation/get-competitions-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/international-fencing-federation/get-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","gender":"<string>","level":"<string>","page":"<integer>","query":"<string>","season":"<string>","type":"<string>","weapon":"<string>"}'
```

## Next steps

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