# Racecenter Letour — 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.

> Track live Tour de France race updates by accessing real-time rider positions, detailed stage information, and current general classification standings. Monitor how your favorite cyclists are performing throughout each stage and their overall ranking in the competition.

**Category:** Sports | **Website:** [racecenter.letour.fr/en](https://racecenter.letour.fr/en) | **Docs:** [parse.bot/marketplace/6b367818-afc0-4257-9227-8ea9f878f34f/racecenter-letour-fr-api](https://parse.bot/marketplace/6b367818-afc0-4257-9227-8ea9f878f34f/racecenter-letour-fr-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/racecenter-letour/`
**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 general classification

Returns the general classification (overall standings) after a given stage. Each entry includes rider position, time, gap to leader, and bonuses/penalties. Available once intermediate or final timing for the stage has been published.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | Yes | Stage number (1-21) after which to retrieve the GC standings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/racecenter-letour/get-general-classification \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```

### Get live positions

Returns live rider group positions during a stage. Each group contains its GPS coordinates, speed, distance remaining, time gap to the leader, jersey indicators, and the list of riders in that group. Data updates every few seconds during the race; returns empty groups when the stage is not active.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | Yes | Stage number (1-21) to get live positions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/racecenter-letour/get-live-positions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```

### Get stage info

Returns stage details for the current Tour de France edition. When stage_number is supplied, returns that single stage; when omitted, returns all 21 stages. Each stage includes route (departure/arrival cities), distance, scheduled times, type code, and cancellation status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stage_number` | integer | No | Stage number (1-21). Omit to retrieve all stages. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/racecenter-letour/get-stage-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"stage_number":"<integer>"}'
```

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