Cycle Scores (CLASS 2nd ed)
Fetch scores for a specific cycle from a CLASS 2nd edition observation.
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>
/v1/class_2nd/assessments/:assessment_id/cycles/:cycle_id- Success
Status: 200 OK
Content-Type: application/json
{
"id": 356,
"cycle_number": 1,
"start_time": "2022-06-10T09:00:00.000Z",
"end_time": "2022-06-10T09:20:00.000Z",
"number_of_adults": 1,
"number_of_children": 9,
"content_and_format": [
{
"content_name": "literacy",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 1
}
],
"formats": []
},
{
"content_name": "math",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 1
}
],
"formats": [
"small_group"
]
},
{
"content_name": "sel",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 2
}
],
"formats": [
"transitions_routines"
]
},
{
"content_name": "science",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 2
}
],
"formats": [
"transitions_routines"
]
},
{
"content_name": "social_cultural_studies",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 3
}
],
"formats": [
"other"
]
},
{
"content_name": "art_music",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 2
}
],
"formats": [
"small_group"
]
},
{
"content_name": "other",
"questions": [
{
"question": "How much time do children spend in learning?",
"value": 2
},
{
"question": "How many children spend time in learning?",
"value": 2
},
{
"question": "How active is children’s engagement in learning?",
"value": 2
}
],
"formats": [
"small_group"
]
}
],
"scores": {
"dimensions": [
{
"name": "Positive Climate",
"dimension_score": 4,
"indicators": [
{
"name": "Relationships",
"indicator_score": "low"
},
{
"name": "Enjoyment",
"indicator_score": "mid"
},
{
"name": "Positive communication",
"indicator_score": "mid"
},
{
"name": "Respect",
"indicator_score": "mid"
}
]
},
{
"name": "Negative Climate",
"dimension_score": 6,
"indicators": [
{
"name": "Expressed Negativity",
"indicator_score": "mid"
},
{
"name": "Punitive control",
"indicator_score": "high"
},
{
"name": "Disrespect",
"indicator_score": "high"
},
{
"name": "Severe negativity",
"indicator_score": "high"
}
]
},
{
"name": "Educator Sensitivity",
"dimension_score": 4,
"indicators": [
{
"name": "Awareness",
"indicator_score": "mid"
},
{
"name": "Responsiveness",
"indicator_score": "mid"
},
{
"name": "Problem Resolution",
"indicator_score": "mid"
},
{
"name": "Child comfort",
"indicator_score": "mid"
}
]
},
{
"name": "Regard for Child Perspectives",
"dimension_score": 4,
"indicators": [
{
"name": "Child-centered",
"indicator_score": "mid"
},
{
"name": "Support for autonomy and leadership",
"indicator_score": "mid"
},
{
"name": "Child expression",
"indicator_score": "mid"
},
{
"name": "Allows movement",
"indicator_score": "mid"
}
]
},
{
"name": "Behavior Management",
"dimension_score": 6,
"indicators": [
{
"name": "Behavior expectations",
"indicator_score": "high"
},
{
"name": "Proactive",
"indicator_score": "high"
},
{
"name": "Redirection of behavior",
"indicator_score": "mid"
},
{
"name": "Child behavior",
"indicator_score": "high"
}
]
},
{
"name": "Productivity",
"dimension_score": 3,
"indicators": [
{
"name": "Opportunities for learning",
"indicator_score": "high"
},
{
"name": "Routines",
"indicator_score": "mid"
},
{
"name": "Transitions",
"indicator_score": "mid"
},
{
"name": "Preparation",
"indicator_score": "low"
}
]
},
{
"name": "Instructional Learning Formats",
"dimension_score": 6,
"indicators": [
{
"name": "Effective facilitation",
"indicator_score": "mid"
},
{
"name": "Variation in approach",
"indicator_score": "mid"
},
{
"name": "Child interest",
"indicator_score": "high"
},
{
"name": "Clarity of learning objectives",
"indicator_score": "high"
}
]
},
{
"name": "Concept Development",
"dimension_score": 4,
"indicators": [
{
"name": "Analysis and reasoning",
"indicator_score": "mid"
},
{
"name": "Creativity",
"indicator_score": "low"
},
{
"name": "Integration",
"indicator_score": "mid"
},
{
"name": "Connections to everyday lives",
"indicator_score": "mid"
}
]
},
{
"name": "Quality of Feedback",
"dimension_score": 6,
"indicators": [
{
"name": "Scaffolding",
"indicator_score": "high"
},
{
"name": "Feedback loops",
"indicator_score": "high"
},
{
"name": "Prompting thought processes",
"indicator_score": "high"
},
{
"name": "Providing information",
"indicator_score": "high"
},
{
"name": "Encouragement and Affirmation",
"indicator_score": "high"
}
]
},
{
"name": "Language Modeling",
"dimension_score": 5,
"indicators": [
{
"name": "Frequent conversations",
"indicator_score": "high"
},
{
"name": "Open-ended questions",
"indicator_score": "mid"
},
{
"name": "Communication extensions",
"indicator_score": "high"
},
{
"name": "Narration",
"indicator_score": "mid"
},
{
"name": "Advanced language",
"indicator_score": "high"
}
]
}
]
}
}
Field Types
| field | type | note |
|---|---|---|
| id | integer | |
| cycle_number | integer | |
| start_time | string | format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z' |
| end_time | string | format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z' |
| number_of_adults | null | integer | |
| number_of_children | null | integer | |
| content_and_format | Array of Content Format MetaData Value | see available Content Areas |
| dimensions | Array of Dimension Scores Metadata Value | see Dimension Scores for further explanation |
ContentFormatMetaDataValue
Generic object to represent a Content value. In UI it is a checkbox to represent each number to be assigned.
{
"content_name": string,
"questions": [
{
"question": string,
"value": integer
}
],
"formats": array
}
The field value inside the questions array can be a number from 1 to 3. For further explanation see Time, Number and Engagement
DimensionScoresMetadataValue
Generic object to represent a Dimension Scores value. In UI it is a block with indicators to assign scores.
{
"name": string,
"dimension_score": integer,
"indicators": array
}
Activity Settings
These items measure children’s exposure to, and engagement in, various content areas. Content areas are the subject areas or topics of the classroom activities, whether planned or impromptu. Content occurs as part of specific curricular activities, discussions, facilitation, or exploration in the setting.
Content Areas
The subject area or topic of classroom activities.
| Content Areas |
|---|
| Literacy |
| Math |
| Social and emotional learning (SEL) |
| Science |
| Social studies |
| Art or music |
Time, Number and Engagement
| 1 | 2 | 3 | |
|---|---|---|---|
| Time: The relative time spent in a particular content area or content related learning activity. | Children do not spend time learning about this content area. Either no content is included or it only occurs in fleeting moments. | Children spend some time (less than or equal to 50%) in learning about this content area. Content clearly occurs, but not consistently across the observation period. | Children spend most of their time (more than 50%) in learning about this content area. Content occurs for more than half of the observation period. |
| Number: The relative number of children spent in a particular content area or content related learning activity. | Few children (1-2) participate in learning about this content area. | Some children (less than or equal to 50%) participate in learning about this content area. | Many children (more than 50%) participate in learning about this content area. |
| Engagement: The degree of engagement in a particular content area or content related learning activity. | Children are not actively engaged in learning about this content area. They are either passively engaged or disengaged. | Children are sometimes actively engaged in learning about this content area, but at other times they are either passively engaged or disengaged. | Children are frequently actively engaged in learning about this content area. |
Formats
API returns abbreviation
| Abbreviation | Formats |
|---|---|
| centers_free_play | Centers / Free Play |
| independent_work | Independent work / 1:1 |
| small_group | Small group |
| transitions_routines | Transitions / Routines |
| whole_group | Whole group |
| other | Other |
Dimension Scores
| field | type | note |
|---|---|---|
| name | string | |
| dimension_score | null | integer | number from 1 to 7 |
| indicators | Array of Indicator Score |
Indicator Score
| field | type | note |
|---|---|---|
| name | string | |
| indicator_score | string | low | mid | high | N/A (Not Applicable) |