List events

Your organization’s races that are on sale, soonest first.

GET /events

List events

cURL

curl --request GET \
  --url https://connect.laces.run/v1/events \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "code": 200,
  "message": "Events retrieved successfully",
  "data": {
    "events": [
      {
        "event_id": "q3Zk9mVx",
        "name": "Kampala City 10K",
        "handle": "kampala-city-10k",
        "short_code": "K10",
        "description": "A flat, fast 10K through the city centre.",
        "cover": "https://laces.run/images/example-cover.jpg",
        "venue": "Kololo Airstrip",
        "event_type": "run",
        "status": "open",
        "visibility": "public",
        "starts_at": "2026-11-15T04:00:00.000Z",
        "ends_at": "2026-11-15T09:00:00.000Z",
        "timezone": "Africa/Kampala",
        "currency": "UGX",
        "reg_opens_at": "2026-09-01T00:00:00.000Z",
        "reg_closes_at": "2026-11-13T20:00:00.000Z",
        "payments_enabled": true
      }
    ],
    "next_cursor": "eyJpZCI6InEzWms5bVZ4In0",
    "has_more": true
  }
}

Authorizations

bearerAuthoauth2publishableKey

Authorization · string · header · required

A token from POST /oauth/token, valid 1 hour. Paste it as LCSTOK-…-X (without the word Bearer).

Query Parameters

limit · integer · default: 20

1 to 50. Larger values are clamped to 50.

Required range: x >= 1

cursor · string

next_cursor from the previous page.

Response

200

application/json

A page of events.

code · integer · required

HTTP status, repeated in the body.

Example:

200

message · string · required

Example:

"Events retrieved successfully"

data · object · required

Show child attributes