API Access

Authorization: Bearer YOUR_API_KEY

{
  "status": boolean,
  "count": int,
  "total_records": int,
  "total_pages": int,
  "current_page": int,
  "limit": int,
  "workouts": [
    {
      "id": int,
      "title": string,
      "body_weight": int,
      "workout_perform_date": string, // ISO date or datetime
      "total_volume": int,
      "totalLiftedWeight": int,
      "user": {
        "username": string
      },
      "exercises": [
        {
          "exercise_id": int,
          "excercise_name": string,
          "exercise_type": string, // e.g. "weight_reps"
          "exercise_image": string, // URL
          "exercise_rest_time": int,
          "sets": [
            {
              "id": string,
              "weight": string, // or float as string
              "reps": string, // or int as string
              "rir": string,
              "duration": string,
              "distance": string,
              "set_type_id": string,
              "is_completed": boolean,
              "record_type": string,
              "record_level": string,
              "record_value": string
            }
            // ... more sets ...
          ]
        }
        // ... more exercises ...
      ]
    }
    // ... more workouts ...
  ]
}

{
  "status": boolean,
  "count": int,
  "total_records": int,
  "total_pages": int,
  "current_page": int,
  "limit": int,
  "workouts": [
    {
      "id": string, // or int
      "title": string,
      "description": string | null,
      "workout_duration": string, // e.g. "01:06:25"
      "total_volume": string, // or int as string
      "workout_perform_date": string // ISO date or datetime, e.g. "2025-07-15 06:42:09"
    }
    // ... more workouts ...
  ]
}

import requests
import json

API_KEY = 'YOUR_API_KEY' # Replace with your actual API key
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

params = {
    'limit': 2,
    'page': 1,
}

response = requests.get(f'{BASE_URL}/api/v1/workouts/summary', headers=headers, params=params)
print(json.dumps(response.json(), indent=2))

{
  "status": true,
  "count": 10,
  "current_page": 1,
  "limit": 10,
  "exercises": [
    {
      "id": "31",
      "name": "Rear Lunge",
      "image_name": "https://apilyfta.com/static/GymvisualPNG/00781101-Barbell-Rear-Lunge_Thighs_small.png",
      "equipment_id": "[\"1\"]",
      "body_part_id": "[\"19\",\"1\"]",
      "Target_muscles_id": "[\"13\",\"27\"]",
      "Synergist_muscles_id": "[\"3\",\"32\"]",
      "exercise_type": "weight_reps"
    },
    // ... more exercises ...
  ]
}

{
  "status": true,
  "data": {
    "results": [
      {
        "id": "2657",
        "name": "Band Bench Press",
        "image_name": "https://apilyfta.com/static/GymvisualPNG/12541101-Band-Bench-Press_Chest_small.png",
        "equipment_id": "[\"11\"]",
        "body_part_id": "[\"2\"]",
        "Target_muscles_id": "[\"24\",\"25\"]",
        "Synergist_muscles_id": "[\"8\",\"44\"]",
        "exercise_type": null
      }
      // ... more catalog exercises ...
    ],
    "pagination": {
      "limit": 10,
      "offset": 0,
      "total": 108,
      "hasMore": true
    }
  }
}

import requests
import json

API_KEY = 'YOUR_API_KEY' # Replace with your actual API key
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

# Example: Search the Lyfta exercise catalog
params = {
    'search': 'bench press',
    'limit': 10,
    'offset': 0,
}

response = requests.get(
    f'{BASE_URL}/api/v1/exercises/library',
    headers=headers,
    params=params,
)

if response.status_code == 200:
    data = response.json()
    print("Exercise library results:")
    print(json.dumps(data, indent=2)) # Pretty print
else:
    print(f"Error {response.status_code}:", response.text)

params = {
  'duration': 365, // in days
  'exercise_id': 2, // from the performed exercise list ids
}

{
  "status": true,
  "weight_unit": "kg",
  "data": [
    {
      "date": "2025-07-21",
      "best_weight": 110,
      "best_reps": 15,
      "best_volume": 800,
      "estimated_rm": "128"
    },
    {
      "date": "2025-07-14",
      "best_weight": 120,
      "best_reps": 15,
      "best_volume": 1000,
      "estimated_rm": "133"
    },
    {
      "date": "2025-06-30",
      "best_weight": 80,
      "best_reps": 20,
      "best_volume": 1600,
      "estimated_rm": "133"
    }
    // ... more records ...
  ]
}

{
  "status": true,
  "count": 2,
  "total_records": 14,
  "total_pages": 7,
  "current_page": 1,
  "limit": 2,
  "collections": [
    {
      "id": 52,
      "title": "Favorites",
      "image": "",
      "pinned": "1",
      "workout_ids": [15447045, 11683978],
      "workout_count": 7,
      "date_created": "2023-02-22T22:25:22.000Z",
      "date_updated": "2026-09-03T13:48:30.916Z"
    }
  ]
}

import requests
import json

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

response = requests.get(
    f'{BASE_URL}/api/v1/collections',
    headers=headers,
    params={'limit': 20, 'page': 1},
)

print(json.dumps(response.json(), indent=2))

{
  "status": true,
  "data": {
    "id": 52,
    "title": "Favorites",
    "description": "",
    "image": "",
    "pinned": "1",
    "workout_ids": [15447045, 11683978],
    "workout_count": 7,
    "workouts": [
      {
        "id": 15447045,
        "title": "Lyfta icon test",
        "picture": "https://cdnlyfta.com/images/original/example.null",
        "color": "#EB7E83",
        "duration": null,
        "exercise_count": 4
      }
    ]
  }
}

import requests
import json

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

response = requests.get(
    f'{BASE_URL}/api/v1/collections/52',
    headers=headers,
    params={'view': 'summary'},
)

print(json.dumps(response.json(), indent=2))

{
  "status": true,
  "count": 1,
  "total_records": 69,
  "total_pages": 69,
  "current_page": 1,
  "limit": 1,
  "templates": [
    {
      "id": 1158669,
      "title": "Full Body day",
      "picture": "https://apilyfta.com/uploads/workouts/example.jpg",
      "color": "#EB445A",
      "exercise_count": 7,
      "date_created": "2023-09-25T19:44:15.000Z",
      "date_updated": "2024-07-12T09:58:54.000Z",
      "collection_id": 103385,
      "collection_title": "Zyzz 5-day split"
    }
  ]
}

import requests
import json

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

response = requests.get(
    f'{BASE_URL}/api/v1/templates',
    headers=headers,
    params={'limit': 20, 'page': 1},
)

print(json.dumps(response.json(), indent=2))

{
  "status": true,
  "data": {
    "id": 1158669,
    "title": "Full Body day",
    "note": "",
    "color": "#EB445A",
    "picture": "https://apilyfta.com/uploads/workouts/example.jpg",
    "user_id": "35",
    "exercises": [
      {
        "exercise_id": 7,
        "excercise_name": "Deadlift",
        "exercise_type": "",
        "exercise_image": "https://apilyfta.com/static/GymvisualPNG/example.png",
        "sets": [
          { "set_type_id": 0, "reps": "12", "weight": "" }
        ]
      }
    ]
  }
}

import requests
import json

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

response = requests.get(
    f'{BASE_URL}/api/v1/templates/1158669',
    headers=headers,
)

print(json.dumps(response.json(), indent=2))

{
  "status": true,
  "count": 1,
  "total_records": 1,
  "total_pages": 1,
  "current_page": 1,
  "limit": 50,
  "from": "2026-08-01",
  "to": "2026-09-14",
  "workouts": [
    {
      "id": "251981",
      "source": "calendar",
      "template_id": "15303093",
      "title": "Upper Body 1",
      "scheduled_date": "2026-08-20",
      "scheduled_time": "08:00:00",
      "status": "scheduled",
      "is_completed": false,
      "note": null
    }
  ]
}

import requests
import json

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

# Defaults: from = today, to = +90 days, incomplete only
upcoming = requests.get(f'{BASE_URL}/api/v1/schedule', headers=headers)
print(json.dumps(upcoming.json(), indent=2))

# Include completed items in a date range
completed = requests.get(
    f'{BASE_URL}/api/v1/schedule',
    headers=headers,
    params={
        'from': '2026-09-08',
        'to': '2026-09-14',
        'include_completed': 'true',
    },
)
print(json.dumps(completed.json(), indent=2))

{
  "status": true,
  "data": {
    "id": 12345,
    "title": "My Program",
    "description": "Optional program description",
    "goal": "Optional goal, e.g. strength or hypertrophy",
    "image": "https://cdnlyfta.com/images/original/example.jpeg"
  }
}

{
  "status": false,
  "message": "Title is required"
}

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "status": true,
  "message": "Template created successfully",
  "collectionId": 42,
  "data": {
    "id": 9812,
    "title": "Push day",
    "description": "Chest and shoulders",
    "note": "",
    "color": "#178B76",
    "picture": "https://cdnlyfta.com/images/original/example.jpeg",
    "user_id": 1001,
    "create_date": "2026-06-15 10:30:00",
    "update_date": "2026-06-15 10:30:00",
    "exercises": []
  }
}

{
  "status": false,
  "message": "collectionId is required"
}

{
  "status": true,
  "data": [
    {
      "username": "Hemant (test user)1",
      "photo": "https://cdnlyfta.com/images/original/profilePic_69933e5d8a0836.499124082785.jpeg",
      "first": "Hemant",
      "last": "(test user)1",
      "status": "1",
      "client_id": "dj152auh"
    }
    // ... more clients ...
  ]
}

params = {
  'client_id': 'dj152auh', // from GET /api/v1/clients
  'limit': 10,
  'page': 1,
}

import requests
import json

API_KEY = 'YOUR_API_KEY' # Same key as the personal data endpoints
BASE_URL = 'https://my.lyfta.app'

headers = {
    'Authorization': f'Bearer {API_KEY}',
}

# Step 1: Fetch active clients and collect their client_id values
clients_response = requests.get(f'{BASE_URL}/api/v1/clients', headers=headers)

if clients_response.status_code != 200:
    print(f"Error {clients_response.status_code}:", clients_response.text)
    exit()

clients_data = clients_response.json()
active_clients = [
    client for client in clients_data.get('data', [])
    if str(client.get('status')) == '1'
]

for client in active_clients:
    client_id = client['client_id']
    print(f"Active client: {client.get('username')} (client_id={client_id})")

    # Step 2: Pass client_id to other endpoints to fetch that client's data
    params = {
        'client_id': client_id,
        'limit': 10,
        'page': 1,
    }

    workouts_response = requests.get(
        f'{BASE_URL}/api/v1/workouts',
        headers=headers,
        params=params,
    )

    if workouts_response.status_code == 200:
        print(json.dumps(workouts_response.json(), indent=2))
    else:
        print(f"Error {workouts_response.status_code}:", workouts_response.text)