Skip to main content

Assessments

Assessments endpoint returns all observations from the account.

Deprecated Endpoint

The /envscales endpoint is deprecated. Please use /observation-data for all new integrations. The old endpoint will continue to work but may be removed in future versions.

Current API

Base URL: https://api.teachstone.com/observation-data

Headers: Authorization: Bearer <token>

GET /v1/assessments
Status: 200 OK
Content-Type: application/json

{
"assessments": [
{
"id": 290,
"observer_external_id": null,
"observer_guid": "00ufqojg3iFcEIHzt2p7",
"age_level": "Pre-K",
"classroom_external_id": "181",
"taken_at": "2022-09-22",
"local_time_zone": "America/New_York",
"template": "class_1st",
"status": "open",
"includes_environments": true,
"created_at": "2022-09-22T13:02:20.463Z",
"updated_at": "2022-09-22T13:02:20.484Z",
"observer": "Farias, Emanuel",
"classroom": "classroom 181",
"classroom_guid": "18157a0d-5d15-4a4c-a3a2-5b0fc416cb15",
"center": "Center 12",
"center_guid": "e9d0313d-611a-45e8-a232-d8ee922220c9",
"assessment_detail_url": "https://api.teachstone.com/observation-data/v1/assessments/290",
"cycle_ids": [
461,
462
],
},
{
"id": 291,
"observer_external_id": null,
"observer_guid": "00ufqojg3iFcEIHzt2p7",
"age_level": "Pre-K",
"classroom_external_id": "181",
"taken_at": "2022-09-22",
"local_time_zone": "America/New_York",
"template": "class_1st",
"status": "open",
"includes_environments": false,
"created_at": "2022-09-22T13:03:45.368Z",
"updated_at": "2022-09-22T13:03:45.388Z",
"observer": "Farias, Emanuel",
"classroom": "classroom 181",
"classroom_guid": "18157a0d-5d15-4a4c-a3a2-5b0fc416cb15",
"center": "Center 12",
"center_guid": "e9d0313d-611a-45e8-a232-d8ee922220c9",
"assessment_detail_url": "https://api.teachstone.com/observation-data/v1/assessments/291",
"cycle_ids": [
463
],
}
],
"per_page": 50,
"total_pages": 1,
"current_page": 1,
"total_count": 2
}

Filters

You can filter the list of assessments using query parameters.

parameters
q
page
per_page
age_level
external_account_id
start_date
end_date
created_start_date
created_end_date
updated_start_date
updated_end_date

You can also combine multiple parameters, example: /assessments?age_level=Pre-K&start_date=2022-04-01&end_date=2022-05-01&page=1