---
title: "Retrieves running and saved lab instances available to this API consumer"
slug: "retrieves-running-and-saved-lab-instances-available-to-this-api-consumer-1"
updated: 2025-08-07T14:39:28Z
published: 2025-08-07T14:41:42Z
canonical: "docs.skillable.com/retrieves-running-and-saved-lab-instances-available-to-this-api-consumer-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieves running and saved lab instances available to this API consumer

Get/runningandsavedlabs

The **RunningAndSavedLabs** command retrieves all lab instances launched by this API Consumer that are currently running or saved. **NOTE**: there are no query parameters for this command.

SecurityAPI Key: api_keyHeader parameter nameapi_key

All methods require an API key, which must be obtained from Skillable. This key is used by Skillable to validate your account. The key can be passed as an HTTP request header with the header name "api_key".

Responses200

OK Response.

<select class='api-response-data' aria-label='Media type'><option value='690fa724-4061-4321-89fd-f8f206c24519'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='07df1a77-af86-4544-97c2-1d60e911c2ce'>Example of retrieving all lab instances launched by thi...</option>
</select>Example of retrieving all lab instances launched by this API Consumer that are currently running or saved

```json
{
  "RunningLabs": [
    {
      "Id": 3497,
      "UserId": "5843",
      "UserFirstName": "John",
      "UserLastName": "Doe",
      "LabProfileId": 5,
      "LabProfileName": "Demo Lab 1",
      "LabProfileNumber": "LAB001",
      "Start": 1338223121,
      "Expires": 1338244721,
      "IsExam": false
    }
  ],
  "SavedLabs": [
    {
      "Id": 3493,
      "UserId": "5158",
      "UserFirstName": "Sally",
      "UserLastName": "Smith",
      "LabProfileId": 1,
      "LabProfileName": "Demo Lab 2",
      "LabProfileNumber": "LAB002",
      "Start": 1337987655,
      "Expires": 1338592455,
      "IsExam": false
    }
  ],
  "Status": 1,
  "Error": null
}
```

Expand Allobject  RunningLabs Array of object   

Array of LabInstance objects for running labs.

object  Idinteger  (int64)    

The unique identifier of the lab instance.

UserIdstring    

The ID of the user the lab instance belongs to.

UserFirstNamestring    

The first name of the user the lab instance belongs to.

UserLastNamestring    

The last name of the user the lab instance belongs to.

LabProfileIdinteger  (int32)    

The unique identifier of the lab profile the lab instance is based on.

LabProfileNamestring    

The number/code of the lab profile the lab instance is based on.

LabProfileNumberstring    

The name of the lab profile the lab instance is based on.

Startinteger  (int64)    

When the lab instance was started (in Unix epoch time).

Expiresinteger  (int64)    

When the lab will expire (in Unix epoch time).

IsExamboolean    

Indicates whether the lab is scored.

SavedLabs Array of object   

Array of LabInstance objects for saved labs.

object  Idinteger  (int64)    

The unique identifier of the lab instance.

UserIdstring    

The ID of the user the lab instance belongs to.

UserFirstNamestring    

The first name of the user the lab instance belongs to.

UserLastNamestring    

The last name of the user the lab instance belongs to.

LabProfileIdinteger  (int32)    

The unique identifier of the lab profile the lab instance is based on.

LabProfileNamestring    

The number/code of the lab profile the lab instance is based on.

LabProfileNumberstring    

The name of the lab profile the lab instance is based on.

Startinteger  (int64)    

When the lab instance was started (in Unix epoch time).

Expiresinteger  (int64)    

When the lab will expire (in Unix epoch time).

IsExamboolean    

Indicates whether the lab is scored.

Statusinteger  (int32)    

Indicates the status of the API request. 0 = Error 1 = Success

Errorstring   | null  

In the event of an error, this will contain a detailed error message.