GET /export#
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/export
Endpoint réservé aux formules PARTNER. Un compte qui n'y a pas droit reçoit
403 forbidden.
Catalogue complet en un seul document JSON. Le document est envoyé en flux : lisez-le en continu plutôt que de le charger en mémoire.
Le nombre d'exports est limité par jour (selon la formule). Un export compte aussi pour une requête dans votre quota journalier.
L'export n'est pas disponible avec une clé de test (th_test_) : l'appel est refusé en 403 forbidden et n'entame pas votre allocation d'export. Utilisez une clé de production, depuis un de vos domaines autorisés.
Si le flux échoue côté Trail Horizon (erreur interne en cours d'envoi), l'export est remboursé : il ne compte plus dans votre allocation journalière et vous pouvez le relancer. Si vous coupez vous-même la connexion, il reste décompté.
Réponse 200#
En-tête Content-Type: application/json; charset=utf-8.
{
"generatedAt": "2026-10-27T12:00:00.000Z",
"data": [
{
"id": "clx1a2b3c0000abcd1234efgh",
"slug": "trail-des-cretes-fictives",
"name": "Trail des Crêtes Fictives",
"url": "https://trailhorizon.fr/races/europe/france/auvergne-rhone-alpes/trail-des-cretes-fictives?utm_source=partner-votre-slug&utm_medium=api&utm_campaign=race-data",
"nextEditionDate": "2027-06-12T00:00:00.000Z",
"lastEditionDate": "2026-06-13T00:00:00.000Z",
"firstEditionDate": "2019-06-15T00:00:00.000Z",
"updatedAt": "2026-10-20T08:30:00.000Z",
"status": "ACTIVE",
"verifiedAt": "2026-10-15T10:00:00.000Z",
"averageRating": 4.5,
"location": {
"city": "Exempleville",
"lat": 45.1234,
"lon": 6.5678,
"region": "Auvergne-Rhône-Alpes",
"country": "France",
"continent": "Europe"
},
"links": {
"website": "https://exemple.org/trail",
"registration": "https://exemple.org/trail/inscriptions",
"facebook": "https://facebook.com/exemple-trail",
"instagram": "https://instagram.com/exemple_trail",
"youtube": null
},
"images": {
"logo": "https://files.example.com/trail-des-cretes/logo.png",
"card": "https://files.example.com/trail-des-cretes/card.jpg",
"coverDesktop": "https://files.example.com/trail-des-cretes/cover-desktop.jpg",
"coverPhone": "https://files.example.com/trail-des-cretes/cover-phone.jpg"
},
"formats": [
{
"id": "clx9z8y7x0001abcd5678ijkl",
"name": "Le Grand Tour",
"type": "STANDARD",
"distance": 52.4,
"elevation": 3100,
"category": "50K",
"price": 85,
"currency": "EUR",
"startAt": "2027-06-12T05:00:00.000Z",
"hasStartTime": true,
"timezone": "Europe/Paris",
"duration": null,
"traceUrl": "https://tracedetrail.fr/trace/0000",
"registrationStatus": "NOT_YET_OPEN",
"registrationOpensAt": "2027-01-15T08:00:00.000Z",
"maxParticipants": 800,
"practicalInfo": "Matériel obligatoire : Veste imperméable, EMERGENCY_BLANKET\nDépart : Place du village\nArrivée : Place du village\nTemps limite : 14 h 0 min\nRavitaillements : Col des Exemples (km 18)",
"practicalInfoStructured": {
"requiredGear": [
{
"code": "WATERPROOF_JACKET",
"label": null,
"quantity": null
},
{
"code": "EMERGENCY_BLANKET",
"label": null,
"quantity": null
}
],
"recommendedGear": [],
"start": {
"location": "Place du village",
"details": null
},
"finish": {
"location": "Place du village",
"details": null
},
"access": null,
"timeLimit": {
"totalMinutes": 840,
"cutoffs": []
},
"aidStations": [
{
"name": "Col des Exemples",
"km": 18,
"kind": "FULL"
}
],
"kidsAgeRange": null,
"relay": null,
"stageRace": null,
"notes": null
},
"rankingTypes": [
"ITRA"
],
"tags": [
"panoramique",
"technique"
]
},
{
"id": "clx9z8y7x0002abcd5678mnop",
"name": "La Petite Boucle",
"type": "STANDARD",
"distance": 21.2,
"elevation": 1100,
"category": "20K",
"price": 38,
"currency": "EUR",
"startAt": "2027-06-12T08:30:00.000Z",
"hasStartTime": true,
"timezone": "Europe/Paris",
"duration": null,
"traceUrl": null,
"registrationStatus": "NOT_YET_OPEN",
"registrationOpensAt": "2027-01-15T08:00:00.000Z",
"maxParticipants": 400,
"practicalInfo": null,
"practicalInfoStructured": null,
"rankingTypes": [],
"tags": []
}
]
}
],
"count": 1
}
Exemple#
curl -H "Authorization: Bearer th_live_VOTRE_CLE" \
-H "X-TrailHorizon-Origin: votre-domaine.fr" \
"https://trailhorizon.fr/api/v1/export"
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. |