Skip to content
Dreeve

Search activities

GET
/api/v1/activities
curl --request GET \
  --url http://localhost:8080/api/v1/activities \
  --header 'Authorization: Bearer <token>'

Returns activities newest first. All filters are optional

GET /api/v1/activities?filters[from]=2023-09-04&filters[to]=2023-09-04&pagination[size]=50

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
filters
object
from

Only activities that started on this day or later

string format: date
to

Only activities that started on this day or earlier

string format: date
sportType

One sport type, or several separated by commas

string
hasGpx
string
Allowed values: true false
pagination
object
page
integer
default: 1 >= 1
size
integer
default: 25 >= 1 <= 100

Responses

Section titled “Responses”

200

Section titled “200”

A page of activities, newest first.

Media typeapplication/json
object
activities
required
Array<object>
object
id
required
string
name
required
string
description
required
string
sportType
required

Strava’s sport type vocabulary.

string
workoutType
string | null
worldType
required
string
importSource
required
string
startDateLocal
required
string
distanceInMeter
required
integer
elevationInMeter
required
integer
movingTimeInSeconds
required
integer
elapsedTimeInSeconds
required
integer
averageSpeedInKmPerHour
required
number
maxSpeedInKmPerHour
required
number
calories
integer | null
kilojoules
integer | null
averageHeartRate
integer | null
maxHeartRate
integer | null
averagePower
integer | null
maxPower
integer | null
averageCadence
integer | null
isCommute
required
boolean
deviceName
string | null
gearId
string | null
location
required
object
countryCode
required

Lowercased ISO 3166-1 alpha-2.

string | null
state
required
string | null
city
required
string | null
passedThroughCountries
required

Lowercased ISO 3166-1 alpha-2 codes, empty when not reverse geocoded.

Array<string>
startLatLng

The starting point as [latitude, longitude], null without GPS data.

Array<number> | null
>= 2 items <= 2 items
encodedPolyline
string | null
hasGpx
required

Whether GET /api/v1/activities/{activityId}/gpx will return a file for this activity.

boolean
images
required
Array<object>
object
id
required
string
url
required

Where the image is served. With demo mode enabled, visitors who are not logged in get a placeholder photo instead.

string format: uri
pagination
required
object
page
required
integer
size
required
integer
total
required
integer
totalPages
required
integer
Example
{
  "activities": [
    {
      "id": "activity-9756441741",
      "name": "Evening Ride",
      "sportType": "Ride",
      "worldType": "realWorld",
      "importSource": "stravaApi",
      "startDateLocal": "2023-09-04T21:05:38",
      "gearId": "gear-b12659861",
      "location": {
        "countryCode": "be",
        "state": "West-Vlaanderen",
        "city": "Brugge"
      },
      "passedThroughCountries": [
        "be",
        "nl"
      ],
      "startLatLng": [
        51.2,
        3.18
      ],
      "images": [
        {
          "id": "activityImage-0a8cdfbb-63b4-4f0f-a09d-faedd5a00753",
          "url": "https://dreeve.example.com/files/activities/0a8cdfbb-63b4-4f0f-a09d-faedd5a00753.jpg"
        }
      ]
    }
  ]
}

400

Section titled “400”
Media typeapplication/json

Every error uses this shape.

object
error
required

A stable, machine readable code.

string
Allowed values: invalid_token missing_file unsupported_media_type unsupported_file_type file_too_large import_mode_not_files gpx_not_available not_found method_not_allowed bad_request forbidden internal_error
message
required
string
Examples
ExampleunknownSportType
{
  "error": "bad_request",
  "message": "\"filters[sportType]\" contains an unknown sport type."
}

401

Section titled “401”

The Authorization header was missing, malformed, or did not match the configured key.

Media typeapplication/json

Every error uses this shape.

object
error
required

A stable, machine readable code.

string
Allowed values: invalid_token missing_file unsupported_media_type unsupported_file_type file_too_large import_mode_not_files gpx_not_available not_found method_not_allowed bad_request forbidden internal_error
message
required
string
Examples
ExampleinvalidToken
{
  "error": "invalid_token",
  "message": "A valid API token is required. Send it in the Authorization header as a Bearer token."
}

Headers

Section titled “Headers”
WWW-Authenticate
string