Skip to content

list

GET
/trail

Lists all trails.

Parameters

Query Parameters

page
number

Page number starting at 1

Example
1
perPage
number

Items per page

Example
5
sort
string

Sort string (-/+)

Example
-created
filter
string
Example
name="MyTrail"
expand
string
Example
author
requestKey
string

Unique request key. Prevents auto cancel when sending multiple requests.

Example
my-key

Responses

200

object
page
required
integer
perPage
required
integer
totalItems
required
integer
totalPages
required
integer
items
required
Array<object>
object
author
required
string
category
required
string
collectionId
required
string
collectionName
required
string
created
required
string
date
required
string
description
required
string
difficulty
required
string
distance
required
number
duration
required
integer
elevation_gain
required
number
elevation_loss
required
integer
gpx
required
string
id
required
string
lat
required
number
location
required
string
lon
required
number
name
required
string
photos
required
Array<string>
public
required
boolean
summit_logs
required
Array<string>
thumbnail
required
integer
updated
required
string
waypoints
required
Array<string>
expand
required
object
author
required
object
avatar
required
string
bio
required
string
collectionId
required
string
collectionName
required
string
created
required
string
id
required
string
private
required
boolean
username
required
string
Examples

Success

{
"page": 1,
"perPage": 5,
"totalItems": 53,
"totalPages": 11,
"items": [
{
"author": "3mugf953w4a9fg5",
"category": "x5y2ikswxzoznek",
"collectionId": "e864strfxo14pm4",
"collectionName": "trails",
"created": "2024-10-06 09:33:11.404Z",
"date": "2024-10-06 00:00:00.000Z",
"description": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.\n\nLorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.\n\nLorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.\n\nLorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.\n\nLorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.",
"difficulty": "easy",
"distance": 7504.162098327643,
"duration": 0,
"elevation_gain": 840.19189453125,
"elevation_loss": 0,
"gpx": "breitenstein_3_DvymxgjEm5.gpx",
"id": "074jf18neqwfbsr",
"lat": 47.71215663291514,
"location": "",
"lon": 11.964081572368741,
"name": "Breitenstein",
"photos": [],
"public": false,
"summit_logs": [],
"thumbnail": 0,
"updated": "2024-11-05 21:54:20.799Z",
"waypoints": [
"43570e9537dd83a",
"2efed4a4b90e8b3",
"d1ae45c1f4e6353",
"69de69fdb3b47b5",
"162d22a68a1a98b",
"04328b07923294e"
],
"expand": {
"author": {
"avatar": "pexels_photo_2230444_WILu8cRHVb.jpg",
"bio": "ex aliqua velit deserunt ea exercitation do. Velit ullamco elit culpa eiusmod officia irure aute Lorem in ullamco labore ex. Officia ea qui in exercitation amet. Consequat laboris id duis enim Lorem dolore fugiat excepteur sunt. Sint consectetur duis tempor deserunt non. Ex amet sunt eu commodo.\n\nMollit labore cupidatat qui enim consectetur irure. Ea et reprehenderit ipsum adipisicing duis proident tempor esse excepteur dolor dolore anim consectetur aliqua. Laborum culpa eiusmod id ea consectetur do sit reprehenderit consequat voluptate mollit commodo. Ullamco aute ea minim enim et cupidatat ipsum cillum fugiat. Proident consectetur commodo Lorem do incididunt labore pariatur esse ea officia adipisicing. Do et sint culpa proident enim irure aliqua dolore magna. Laborum Lorem sunt amet occaecat occaecat mollit consectetur laborum ut.",
"collectionId": "xku110v5a5xbufa",
"collectionName": "users_anonymous",
"created": "2024-06-29 19:23:47.731Z",
"id": "3mugf953w4a9fg5",
"private": false,
"username": "Flomp"
}
}
},
{
"author": "3mugf953w4a9fg5",
"category": "x5y2ikswxzoznek",
"collectionId": "e864strfxo14pm4",
"collectionName": "trails",
"created": "2024-09-14 14:18:27.538Z",
"date": "2024-09-14 00:00:00.000Z",
"description": "",
"difficulty": "easy",
"distance": 18487.660615835353,
"duration": 0,
"elevation_gain": 209.55000000000015,
"elevation_loss": 0,
"gpx": "blob_BaoYdHnfYw.gpx",
"id": "14y4qxqbqh0n10m",
"lat": 48.311547246,
"location": "",
"lon": 0.993056622,
"name": "Thiron-Gardais - Nogent-le-Rotrou",
"photos": [],
"public": true,
"summit_logs": [],
"thumbnail": 0,
"updated": "2024-12-08 21:26:17.269Z",
"waypoints": [],
"expand": {
"author": {
"avatar": "pexels_photo_2230444_WILu8cRHVb.jpg",
"bio": "ex aliqua velit deserunt ea exercitation do. Velit ullamco elit culpa eiusmod officia irure aute Lorem in ullamco labore ex. Officia ea qui in exercitation amet. Consequat laboris id duis enim Lorem dolore fugiat excepteur sunt. Sint consectetur duis tempor deserunt non. Ex amet sunt eu commodo.\n\nMollit labore cupidatat qui enim consectetur irure. Ea et reprehenderit ipsum adipisicing duis proident tempor esse excepteur dolor dolore anim consectetur aliqua. Laborum culpa eiusmod id ea consectetur do sit reprehenderit consequat voluptate mollit commodo. Ullamco aute ea minim enim et cupidatat ipsum cillum fugiat. Proident consectetur commodo Lorem do incididunt labore pariatur esse ea officia adipisicing. Do et sint culpa proident enim irure aliqua dolore magna. Laborum Lorem sunt amet occaecat occaecat mollit consectetur laborum ut.",
"collectionId": "xku110v5a5xbufa",
"collectionName": "users_anonymous",
"created": "2024-06-29 19:23:47.731Z",
"id": "3mugf953w4a9fg5",
"private": false,
"username": "Flomp"
}
}
},
{
"author": "znhd3hgrxl85c9f",
"category": "x5y2ikswxzoznek",
"collectionId": "e864strfxo14pm4",
"collectionName": "trails",
"created": "2024-11-15 18:50:36.223Z",
"date": "2024-11-15 00:00:00.000Z",
"description": "",
"difficulty": "easy",
"distance": 283396.31855792465,
"duration": 0,
"elevation_gain": 0,
"elevation_loss": 0,
"gpx": "2024_10_22_04_28_2024_10_22_21_29_UUGET8zBuk.gpx",
"id": "267r63tmbyezpck",
"lat": 41.754053,
"location": "",
"lon": -2.484733,
"name": "Gassi",
"photos": [],
"public": true,
"summit_logs": [
"e980ffa422f1603"
],
"thumbnail": 0,
"updated": "2024-11-16 12:49:33.814Z",
"waypoints": [],
"expand": {
"author": {
"avatar": "screenshot_2024_06_30_at_22_55_34_jpeg_grafik_1024_1024_pixel_skaliert_89_GnBqL3uYqZ.png",
"bio": "",
"collectionId": "xku110v5a5xbufa",
"collectionName": "users_anonymous",
"created": "2024-06-30 21:02:11.693Z",
"id": "znhd3hgrxl85c9f",
"private": false,
"username": "John"
}
}
},
{
"author": "3mugf953w4a9fg5",
"category": "x5y2ikswxzoznek",
"collectionId": "e864strfxo14pm4",
"collectionName": "trails",
"created": "2024-09-14 14:18:26.946Z",
"date": "2024-09-14 00:00:00.000Z",
"description": "",
"difficulty": "easy",
"distance": 10942.463179990422,
"duration": 0,
"elevation_gain": 66.64999999999999,
"elevation_loss": 0,
"gpx": "blob_ZjF1DuT8Rl.gpx",
"id": "2o9c3pxfvrzclud",
"lat": 48.626390603,
"location": "",
"lon": -0.960178937,
"name": "Mortain - St-Hilaire-du-Harcouët",
"photos": [],
"public": true,
"summit_logs": [],
"thumbnail": 0,
"updated": "2024-12-08 21:26:17.888Z",
"waypoints": [],
"expand": {
"author": {
"avatar": "pexels_photo_2230444_WILu8cRHVb.jpg",
"bio": "ex aliqua velit deserunt ea exercitation do. Velit ullamco elit culpa eiusmod officia irure aute Lorem in ullamco labore ex. Officia ea qui in exercitation amet. Consequat laboris id duis enim Lorem dolore fugiat excepteur sunt. Sint consectetur duis tempor deserunt non. Ex amet sunt eu commodo.\n\nMollit labore cupidatat qui enim consectetur irure. Ea et reprehenderit ipsum adipisicing duis proident tempor esse excepteur dolor dolore anim consectetur aliqua. Laborum culpa eiusmod id ea consectetur do sit reprehenderit consequat voluptate mollit commodo. Ullamco aute ea minim enim et cupidatat ipsum cillum fugiat. Proident consectetur commodo Lorem do incididunt labore pariatur esse ea officia adipisicing. Do et sint culpa proident enim irure aliqua dolore magna. Laborum Lorem sunt amet occaecat occaecat mollit consectetur laborum ut.",
"collectionId": "xku110v5a5xbufa",
"collectionName": "users_anonymous",
"created": "2024-06-29 19:23:47.731Z",
"id": "3mugf953w4a9fg5",
"private": false,
"username": "Flomp"
}
}
},
{
"author": "3mugf953w4a9fg5",
"category": "x5y2ikswxzoznek",
"collectionId": "e864strfxo14pm4",
"collectionName": "trails",
"created": "2024-09-14 14:18:27.604Z",
"date": "2024-09-14 00:00:00.000Z",
"description": "",
"difficulty": "easy",
"distance": 23920.21858179372,
"duration": 0,
"elevation_gain": 238.07999999999996,
"elevation_loss": 0,
"gpx": "blob_oyW3EXsfqS.gpx",
"id": "2y8o7bwmor4yltt",
"lat": 48.8029381,
"location": "",
"lon": 2.1264017,
"name": "Versailles - St-Rémy-lès-Chevreuse",
"photos": [],
"public": true,
"summit_logs": [],
"thumbnail": 0,
"updated": "2024-12-08 21:26:16.840Z",
"waypoints": [],
"expand": {
"author": {
"avatar": "pexels_photo_2230444_WILu8cRHVb.jpg",
"bio": "ex aliqua velit deserunt ea exercitation do. Velit ullamco elit culpa eiusmod officia irure aute Lorem in ullamco labore ex. Officia ea qui in exercitation amet. Consequat laboris id duis enim Lorem dolore fugiat excepteur sunt. Sint consectetur duis tempor deserunt non. Ex amet sunt eu commodo.\n\nMollit labore cupidatat qui enim consectetur irure. Ea et reprehenderit ipsum adipisicing duis proident tempor esse excepteur dolor dolore anim consectetur aliqua. Laborum culpa eiusmod id ea consectetur do sit reprehenderit consequat voluptate mollit commodo. Ullamco aute ea minim enim et cupidatat ipsum cillum fugiat. Proident consectetur commodo Lorem do incididunt labore pariatur esse ea officia adipisicing. Do et sint culpa proident enim irure aliqua dolore magna. Laborum Lorem sunt amet occaecat occaecat mollit consectetur laborum ut.",
"collectionId": "xku110v5a5xbufa",
"collectionName": "users_anonymous",
"created": "2024-06-29 19:23:47.731Z",
"id": "3mugf953w4a9fg5",
"private": false,
"username": "Flomp"
}
}
}
]
}

400

object
message
required
string
detail
required
Array<object>
object
code
string
minimum
integer
type
string
inclusive
boolean
exact
boolean
message
string
path
Array<string>

x-400:Invalid sort/expand/filter

object
message
required
string
detail
required
object
code
required
integer
message
required
string
data
required
object
Examples

Exception

{
"message": "Something went wrong while processing your request.",
"detail": {
"code": 400,
"message": "Something went wrong while processing your request.",
"data": {}
}
}