Events

Events are a core resource on letsdothis.com. You can use the Marketplace API to search for events that match your criteria.

GETmarketplace/v1/events/search

Search events

This endpoint allows you to search for events on letsdothis.com. You must provide a query parameter to specify your search term. You can include additional query parameters to filter and paginate your search results as needed.

Query Parameters

Name
query
Type
string
Description
Required. The search term to filter events by title.
Name
pageSize
Type
number
Description
The maximum number of results to return per page. Default is 20.
Name
searchAfter
Type
string
Description
A cursor token to fetch the next page of results.
Name
searchBefore
Type
string
Description
A cursor token to fetch the previous page of results.
Name
skip
Type
number
Description
The number of results to skip (optional, for advanced use).

Properties

Name
title
Type
string
Description
The title of the event.
Name
distances
Type
string[]
Description
The available distances for the event.
Name
location
Type
string
Description
The address of the event location.
Name
startDate
Type
string
Description
The start date of the event (ISO string).

Pagination

You can paginate your search results using the following query parameters:

pageSize (number): The maximum number of results to return per page. Default is 20.
searchAfter (string): A cursor token to fetch the next page of results.
searchBefore (string): A cursor token to fetch the previous page of results.
skip (number): The number of results to skip (optional, for advanced use).

The response includes a page object with pagination information:

totalResults: The total number of results available for the query.
first: The token for the first result in the current page of results.
last: The token for the last result in the current page of results.

To fetch the next page, use the last cursor from the response as the searchAfter parameter in your next request. To fetch the previous page, use the first cursor as the searchBefore parameter.

Note: You must include your API key as a bearer token in the Authorization header for every request.

Request

GET

/v1/events/search

curl "https://api.letsdothis.com/marketplace/v1/events/search?query=Box" \
  -H "Authorization: Bearer {your_api_key}"

{
    "data": [
        {
            "title": "Box Hill Triathlon June 2025",
            "location": "Buckland Park Lake, Pk Lk Dr, Betchworth RH3 7FE, UK",
            "distances": [],
            "startDate": "2025-06-22T00:00:00.000Z"
        },
        {
            "title": "Box End Swim 3 of 3",
            "location": "Box End Park Watersports, Box End Rd, Bedford MK43 8RN, UK",
            "distances": [
                "750 m",
                "1500 m",
                "3800 m",
                "5000 m",
                "2500 m"
            ],
            "startDate": "2025-08-23T00:00:00.000Z"
        },
        {
            "title": "Box Hill Vertical KM - November 2025",
            "location": "Box Hill, Box Hill, Tadworth KT20 7LF, UK",
            "distances": [
                "12.5 mi"
            ],
            "startDate": "2025-11-29T00:00:00.000Z"
        },
        {
            "title": "Box End Swim 2 of 3",
            "location": "Box End Park Watersports, Box End Rd, Bedford MK43 8RN, UK",
            "distances": [
                "750 m",
                "1500 m",
                "3800 m",
                "5000 m",
                "2500 m"
            ],
            "startDate": "2025-07-12T00:00:00.000Z"
        },
        {
            "title": "Sox 10k",
            "location": "Ipsden, Wallingford OX10 6AS, UK",
            "distances": [
                "10 km"
            ],
            "startDate": "2025-09-07T00:00:00.000Z"
        }
    ],
    "page": {
        "totalResults": 5,
        "last": "CIqRBhV04LVAIg5aDGcWQp/etbjw6MHqxw==",
        "first": "COGdCBUKccJAIg5aDGdJiDygE94pbSc6qQ==",
        "prev": "",
        "next": ""
    }
}