List Smart IA Sessions
Provides a general purpose endpoint to search both "In Progress" and "Completed" Smart IA Sessions
A POST
version of this endpoint is provided if a large number of filters are required.
Returns a paginated list of completed and in progress sessions
Query parameters
-
startDate
object Filter the results by session start date
Supports either a ISO 8601 formatted date or a Unix timestamp. For example
startDate[gt]=1688200245
orstartDate[lt]=2023-07-15T12:00:00.000Z
The following operators cannot be used together
gt
andgte
lt
andlte
-
endDate
object Filter the results by session end date
Supports either a ISO 8601 formatted date or a Unix timestamp. For example
endDate[gt]=1688200245
orendDate[lt]=2023-07-15T12:00:00.000Z
The following operators cannot be used together
gt
andgte
lt
andlte
-
userId
array[string(uuid)] Filter the results by user ID.
Multiple identifiers can be specified by repeating the query parameter. e.g.
userId=value1&userId=value2
This parameter supports a maximum of 30 identifiers.
At least
1
but not more than30
elements. -
testId
array[string(uuid)] Filter the results by test ID.
Multiple identifiers can be specified by repeating the query parameter. e.g.
testId=value1&testId=value2
This parameter supports a maximum of 30 identifiers.
At least
1
but not more than30
elements. -
subject
array[string] Filter the results by test subject.
Multiple identifiers can be specified by repeating the query parameter. e.g.
subject=value1&subject=value2
This parameter supports a maximum of 30 identifiers.
At least
1
but not more than30
elements. -
limit
integer(int32) Specify the pagination limit, defaults to 100
-
offset
integer(int32) Specify the pagination offset, defaults to 0.
Cannot be used with
cursor
-
cursor
string(byte) | null Provide the next or previous page cursor
-
status
string Filter sessions by status
Values are
IN_PROGRESS
orCOMPLETED
. -
sort
object Specify the sort order of the results.
The default sort order is
sort[field]=startDate&sort[direction]=asc
curl \
--request GET 'https://connect.century.tech/api/v1/smart-ia/sessions' \
--header "x-api-key: $API_KEY"
{
"data": [
[
{
"test": {
"name": "English Smart Initial Assessment",
"testId": "c5a77fda-7174-446f-a4f5-0f47ccbf15ce",
"subject": "English",
"testVersionId": "38444333-7450-49d5-922d-eb16a8f30589"
},
"user": {
"emails": [
"john.doe@email.com"
],
"gender": "male",
"userId": "2716be03-cec0-4027-a373-46b53fb6a08d",
"fullName": "John Doe",
"lastName": "Doe",
"username": "john_doe",
"firstName": "John",
"externalId": "External_ID_123"
},
"result": {
"level": "L1 - Lower",
"duration": "PT1H30M",
"createdDate": "2023-07-10T15:30:00.000Z"
},
"status": "COMPLETED",
"endDate": "2023-07-10T15:30:00.000Z",
"sessionId": "d93ba3c3-2482-4b0d-8b99-42a20e68e11e",
"startDate": "2023-07-10T14:00:00.000Z"
},
{
"test": {
"name": "English Smart Initial Assessment",
"testId": "c5a77fda-7174-446f-a4f5-0f47ccbf15ce",
"subject": "English",
"testVersionId": "38444333-7450-49d5-922d-eb16a8f30589"
},
"user": {
"gender": "female",
"userId": "b4334e39-0fa9-4278-8b61-c7aa7e6c8d5e",
"fullName": "Jane Doe",
"lastName": "Doe",
"username": "jane_doe",
"firstName": "Jane"
},
"status": "IN_PROGRESS",
"sessionId": "9f8a38c6-9194-480e-bb5f-9155b7636580",
"startDate": "2023-07-10T14:00:00.000Z"
}
]
],
"pagination": {
"limit": 30,
"total": 300,
"offset": 100,
"nextCursor": "eyJsaW1pdCI6MSxiZWZvcmU6IiIsc29ydDpbWyJlbmREYXRlIiwiZGVzYyJdXX0=",
"previousCursor": "eyJsaW1pdCI6MSxiZWZvcmU6IiIsc29ydDpbWyJlbmREYXRlIiwiZGVzYyJdXX0="
}
}