Skip to content
wanderer Documentation

list

GET
/list

Lists all lists.

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="abc"
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
avatar
required
string
collectionId
required
string
collectionName
required
string
created
required
string
description
required
string
id
required
string
name
required
string
public
required
boolean
trails
required
Array<string>
updated
required
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": 4,
  "totalPages": 1,
  "items": [
    {
      "author": "3mugf953w4a9fg5",
      "avatar": "",
      "collectionId": "r6gu2ajyidy1x69",
      "collectionName": "lists",
      "created": "2025-01-02 22:29:19.092Z",
      "description": "This list was updated by the wanderer API",
      "id": "4yql7587j64qdo5",
      "name": "Updated API List",
      "public": false,
      "trails": [],
      "updated": "2025-01-02 22:39:36.944Z",
      "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",
      "avatar": "640px_mont_saint_michel_vu_du_ciel_MvWoudBkPE.jpg",
      "collectionId": "r6gu2ajyidy1x69",
      "collectionName": "lists",
      "created": "2024-09-09 22:10:07.972Z",
      "description": "La Véloscénie is a 450-kilometre (280 mi) cycle route that takes you on an adventure from Paris to Mont-Saint-Michel on the Channel coast. From the capital to the beaches, passing through numerous hamlets and stunning towns such as Chartres, this journey westwards has many surprises in store.\r\n\r\nWe suggest you complete this journey in seven stages. This is a challenging pace, but should still leave you time to discover the many attractions en route. Cathedrals, castles, lakes, stunning landscapes and historic villages will show you that you don't have to wait for Mont-Saint-Michel to be amazed.\r\n\r\nThe itinerary alternates between little-used secondary roads, greenways and trails. This trip is best ridden on a bike that can handle rougher trails, like a touring, hybrid or gravel bike.\r\n\r\nParis is easy to reach from anywhere in France, but the choice is more limited if you want to leave from Mont-Saint-Michel. The nearest railway station is in Pontorson, 10 kilometres (6 mi) from Mont-Saint-Michel. From Pontorson, direct trains to Paris leave every evening, around 6pm on weekdays and at weekends, only between June and the end of September. Bikes can be taken on board free of charge by prior arrangement. Apart from this seasonal service, there are other ways of returning to Paris, with at least one train change required. For more information: veloscenic.com/reaching-the-veloscenic-cycle-route\r\n\r\nAlthough the route is accessible all year round, some accommodation and tourist attractions are likely to close in the low season, so it’s best to ride in spring or summer. While some stages end in big cities, others end in more rural areas and you’ll need to book your accommodation in advance. It’s not necessary to book restaurants along the route, but it is best to plan stops for refreshments, as not all the villages you pass through have restaurants or shops.",
      "id": "bdv9iukn4d2lf2i",
      "name": "From Paris to Mont-Saint-Michel — La Véloscénie",
      "public": false,
      "trails": [
        "jou2tcf0y8jj9m3",
        "ilyvsa4xr52lxlr",
        "2y8o7bwmor4yltt",
        "gmh81mczhjp834l",
        "6hpvcyosmqr8uk8",
        "iql9fifaxnb5u6m",
        "y9hjysn5xhbmi86",
        "fehuzqkfi49hkwn",
        "fmin7pbj8urtxx0",
        "14y4qxqbqh0n10m",
        "6fv6krwusycttbl",
        "66jj108gizquc2r",
        "wbuwzu8tp48hljg",
        "x3lo6ru4ly753w6",
        "h91u3vl8n5ekune",
        "bzodytd0vd2e56g",
        "oy1auygew9fvha0",
        "6atd6i73bzle0ar",
        "iz2ohx9hbn8irrc",
        "2o9c3pxfvrzclud",
        "btn09xkl7ab0n9k",
        "ek2cb00tw4v4fav"
      ],
      "updated": "2024-12-27 00:55:25.917Z",
      "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",
      "avatar": "dscn0010_xN987yGxE0.jpg",
      "collectionId": "r6gu2ajyidy1x69",
      "collectionName": "lists",
      "created": "2024-12-30 17:41:00.152Z",
      "description": "Hallo",
      "id": "dci7qk44birm2bn",
      "name": "Liste mit Oachkatzerl",
      "public": true,
      "trails": [
        "ovo0m6pxxjupfp9",
        "yesm2tqc6jok8jq",
        "z94vgei3jdc37k4"
      ],
      "updated": "2024-12-30 18:58:44.269Z",
      "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",
      "avatar": "caret_right_solid_iUtggzDoh7.svg",
      "collectionId": "r6gu2ajyidy1x69",
      "collectionName": "lists",
      "created": "2024-12-13 12:46:49.620Z",
      "description": "",
      "id": "m59tuo2yyretv7z",
      "name": "Flomp's List 2",
      "public": false,
      "trails": [
        "ovo0m6pxxjupfp9"
      ],
      "updated": "2024-12-27 00:55:21.456Z",
      "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>
Examples

Exception

{
  "message": "invalid_params",
  "detail": [
    {
      "code": "too_small",
      "minimum": 0,
      "type": "number",
      "inclusive": false,
      "exact": false,
      "message": "Number must be greater than 0",
      "path": [
        "page"
      ]
    }
  ]
}

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": {}
  }
}