Wingfield Logo
Wingfield Partner API
Session

List sessions for user

GET
/api/v1/users/{userId}/sessions

Retrieve a paginated list of sessions for a connected user from latest to oldest. By default, sessions are returned only when all participants are linked to your external service.

Path Parameters

userId*string

User ID (UUID).

Formatuuid

Query Parameters

offset?integer

Number of items to skip.

Default0
Range0 <= value
limit?integer

Maximum number of items to return.

Default50
Range1 <= value <= 100
sessionType?string

Optional filter by session type.

sportType?string

Optional filter by sport type.

Value in"TENNIS" | "PADEL" | "PICKLEBALL"
from?string

Optional ISO 8601 timestamp lower bound.

Formatdate-time
to?string

Optional ISO 8601 timestamp upper bound.

Formatdate-time

Error Responses

400

invalid_schema

Request validation failed.

400

invalid_filter_time_range

A filter time range is ordered incorrectly.

401

missing_api_token

No authentication token provided.

401

invalid_api_token

Invalid or expired authentication token.

403

scope_permission_denied

Insufficient permissions for this operation.

403

user_access_denied

Service is not granted access to the user.

curl -X GET "https://dev.wingfield.systems/api/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/sessions"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "type": "string",
      "durationSeconds": 0,
      "startedAt": "2019-08-24T14:15:22Z",
      "sportType": "TENNIS",
      "workoutId": "string"
    }
  ],
  "totalCount": 0
}
{
  "error": {
    "type": "invalid_schema",
    "message": "string",
    "issues": [
      {}
    ]
  }
}
{
  "error": {
    "type": "missing_api_token",
    "message": "string"
  }
}
{
  "error": {
    "type": "scope_permission_denied",
    "message": "string"
  }
}