GET /races/{id}/editions#
Version générique : tous les champs sont listés avec la formule minimale qui y donne accès (FREE, PRO, PARTNER). Envoyez votre clé API (
Authorization: Bearer th_live_…) ou connectez-vous à votre espace développeur pour obtenir la version personnalisée.
GET https://trailhorizon.fr/api/v1/races/{id}/editions
Endpoint réservé aux formules PARTNER. Un compte qui n'y a pas droit reçoit
403 forbidden.
Historique des éditions par année et par format. Les formats archivés et les éditions brouillon (non confirmées) sont exclus ; années les plus récentes d'abord.
L'endpoint est disponible si l'historique est activé pour votre formule et que le champ history.editions fait partie de votre compte ; sinon 403 forbidden.
Paramètres#
| Paramètre | Emplacement | Type | Requis | Description |
|---|---|---|---|---|
id | chemin | string | oui | Identifiant de la course (id). |
Réponse 200#
Chaque clé n'est présente que si le champ correspondant est autorisé pour votre compte (formatId et name : formats.id, formats.name ; startAt, distance, elevation, price, currency : champs formats.* du même nom). status est toujours présent.
{
"data": {
"raceId": "clx1a2b3c0000abcd1234efgh",
"editions": [
{
"edition": "2027",
"year": 2027,
"formats": [
{
"formatId": "clx9z8y7x0001abcd5678ijkl",
"name": "Le Grand Tour",
"status": "CONFIRMED",
"startAt": "2027-06-12T05:00:00.000Z",
"distance": 52.4,
"elevation": 3100,
"price": 85,
"currency": "EUR"
},
{
"formatId": "clx9z8y7x0002abcd5678mnop",
"name": "La Petite Boucle",
"status": "CONFIRMED",
"startAt": "2027-06-12T08:30:00.000Z",
"distance": 21.2,
"elevation": 1100,
"price": 38,
"currency": "EUR"
}
]
},
{
"edition": "2026",
"year": 2026,
"formats": [
{
"formatId": "clx9z8y7x0001abcd5678ijkl",
"name": "Le Grand Tour",
"status": "DONE",
"startAt": "2026-06-13T05:00:00.000Z",
"distance": 51.8,
"elevation": 3050,
"price": 80,
"currency": "EUR"
}
]
}
]
}
}
Exemple#
curl -H "Authorization: Bearer th_live_VOTRE_CLE" \
-H "X-TrailHorizon-Origin: votre-domaine.fr" \
"https://trailhorizon.fr/api/v1/races/clx1a2b3c0000abcd1234efgh/editions"
Erreurs#
| Statut | Code | Signification |
|---|---|---|
| 401 | missing_api_key | Header Authorization absent. |
| 401 | invalid_api_key | Clé mal formée ou inconnue. |
| 401 | api_key_revoked | Clé révoquée. |
| 403 | account_suspended / account_revoked | Compte suspendu ou révoqué. |
| 403 | tos_not_accepted | Conditions d'utilisation de l'API jamais acceptées (refus immédiat). |
| 403 | tos_outdated | Nouvelle version des conditions non acceptée dans le délai de grâce. |
| 403 | origin_required | Header X-TrailHorizon-Origin absent. Voir Domaines autorisés. |
| 403 | origin_not_allowed | Origine invalide, ou qui ne correspond à aucun domaine autorisé rattaché à la clé. |
| 403 | origin_suspended | Domaine suspendu (au-delà de la limite de votre formule) ou déclaré Non conforme après revue. |