> For the complete documentation index, see [llms.txt](https://valor-biomechanics.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://valor-biomechanics.gitbook.io/api/reference/api-reference/sessions.md).
# sessions
## Retrieving Sessions within your Organization
## Retrieve recorded movement session(s).
`GET` `https://487q8d7goe.execute-api.us-east-1.amazonaws.com/production/sessions`
Obtains all of the recorded movement sessions (excluding free sessions) or specific sessions within your Valor account based on query parameters.
#### Query Parameters
| Name | Type | Description |
| --------- | ------ | --------------------------------------------------------------------------------------------------- |
| athleteID | String | Valor ID of a specific athlete to retrieve subset of sessions (can be extracted from athletes call) |
| limit | String | Limited number of total sessions to return (used for pagination) |
#### Headers
| Name | Type | Description |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Authorization\* | String | JWT Bearer Token for authentication:
Bearer \
|
| X-Continuation-Token\* | String | Continuation token required for paginating requests. Can be found within the response. Default value should be an empty string encoded as a JSON |
{% tabs %}
{% tab title="200: OK Sessions successfully retrieved" %}
```json
{
"statusCode": 200,
"X-Continuation-Token": "{Continuation Token}", //null when all sessions retrieved
"body": [] //Array of sessions found
}
```
{% endtab %}
{% tab title="404: Not Found No sessions found for the organization" %}
```json
{
"message": "String type - this will contain more details about the problem encountered"
}
```
{% endtab %}
{% tab title="500: Internal Server Error Endpoint request timed out" %}
```json
{
"message": "String type - this will contain more details about the problem encountered"
}
```
{% endtab %}
{% endtabs %}
{% hint style="warning" %}
**Note:** When retrieving multiple sessions it is highly recommended to paginate your requests using the limit & X-Continuation-Token parameters. **See examples below:**
{% endhint %}
{% tabs %}
{% tab title="Python" %}
```python
import requests
import json
# Define the API endpoint
api_url = 'your_api_url'
# Initialize an empty list to store all items
all_items = []
# Default continuation token should be an emptry string wrapped in a json
continuation_token = json.dumps("")
# Replace 'your_jwt_token' with your actual JWT token
jwt_token = 'your_jwt_token'
while True:
# Create headers with the X-Continuation-Token and JWT token
headers = {
'X-Continuation-Token': continuation_token, # Include the continuation token
'Authorization': f'Bearer {jwt_token}'
}
# Define query parameters
params = {
'limit': '', # Replace with the limit you need (Default = '')
'athleteID': '' # Replace with the athlete ID you need (Default = '')
}
# Make the API request with the headers and query parameters
response = requests.get(api_url, headers=headers, params=params)
if response.status_code == 200:
data = response.json()
items = json.loads(data.get('body'))
# Append the items from the current page to the list
all_items.extend(items)
# Check if there's a next page
continuation_token = data.get('X-Continuation-Token')
if continuation_token != "null":
continuation_token = json.dumps(continuation_token)
if continuation_token == "null":
# No more pages to fetch, exit the loop
break
else:
print(f"Error: {response.status_code}")
break
```
{% endtab %}
{% tab title="JavaScript (Node.js)" %}
```javascript
const axios = require('axios');
const jwtToken = 'your_jwt_token_here'; // Replace with your JWT token
let continuationToken = JSON.stringify(''); // Initialize continuation token as empty JSON parameter
const apiUrl = 'your_api_url_here'; // Replace with your API endpoint URL
const allItems = [];
const fetchData = async () => {
while (true) {
const headers = {
Authorization: `Bearer ${jwtToken}`,
'X-Continuation-Token': continuationToken,
};
const params = {
'limit': '', // Replace with the limit you need (Default = '')
'athleteID': '' // Replace with the athleteID you need (Default = '')
};
try {
const response = await axios.get(apiUrl, { headers, params });
const data = response.data;
const items = JSON.parse(data.body);
allItems.push(...items);
continuationToken = data['X-Continuation-Token'];
if (continuationToken !== 'null') {
continuationToken = JSON.stringify(continuationToken)
}
if (continuationToken === 'null') {
break; // No more pages to fetch
}
} catch (error) {
console.error('Error:', error);
break;
}
}
// Process allItems as needed
console.log(allItems.length);
};
fetchData();
```
{% endtab %}
{% tab title="JavaScript (React.js)" %}
```javascript
import React, { useEffect, useState } from 'react';
import axios from 'axios';
const YourComponent = () => {
const [data, setData] = useState(null);
const jwtToken = 'your_jwt_token_here'; // Replace with your JWT token
let continuationToken = JSON.stringify(''); // Initialize continuation token as empty JSON
const apiUrl = 'your_api_url_here'; // Replace with your API endpoint URL
useEffect(() => {
const fetchData = async () => {
const allItems = [];
while (true) {
const headers = {
Authorization: `Bearer ${jwtToken}`,
'X-Continuation-Token': continuationToken,
};
const params = {
'limit': '', // Replace with the limit you need (Default = '')
'athleteID': '' // Replace with the athleteID you need (Default = '')
};
try {
const response = await axios.get(apiUrl, { headers, params });
const data = response.data;
const items = JSON.parse(data.body);
allItems.push(...items);
continuationToken = data['X-Continuation-Token'];
if (continuationToken !== 'null) {
continuationToken = JSON.stringify(continuationToken);
}
if (continuationToken === 'null') {
break; // No more pages to fetch
}
} catch (error) {
console.error('Error:', error);
break;
}
}
// Process allItems as needed
setData(allItems);
};
fetchData();
}, []);
return (
{data ? (
{JSON.stringify(data, null, 2)}
) : (
Loading data...
)}