API Reference
- : Read passages
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: created_at.
passages listed
missing or invalid token
token valid but lacks the passages:read scope
bank not shared with the caller district
invalid pagination parameter
GET /api/v2/banks/{bank_id}/passages HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read passages
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
passage found
passage not in the bank
GET /api/v2/banks/{bank_id}/passages/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read questions
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: created_at.
questions listed
bank not shared with the caller district
GET /api/v2/banks/{bank_id}/questions HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{}
],
"meta": {},
"links": {}
}- : Read questions
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
question found
unknown question in this bank
GET /api/v2/banks/{bank_id}/questions/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read banks
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name, created_at.
banks listed
missing or invalid token
token valid but lacks the banks:read scope
invalid pagination parameter
GET /api/v2/banks HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read banks
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
bank found
bank not shared with the caller district
GET /api/v2/banks/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read class objectives
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name.
class objectives listed
missing or invalid token
token valid but lacks the class_objectives:read scope
invalid pagination parameter
GET /api/v2/class_objectives HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read class objectives
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
class objective found
class objective not in the caller district
GET /api/v2/class_objectives/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read objectives (standards)
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name, created_at.
objectives listed
missing or invalid token
token valid but lacks the objectives:read scope
classroom not in the caller district
GET /api/v2/classrooms/{classroom_id}/objectives HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{}
],
"meta": {},
"links": {}
}- : Read classrooms
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: title, created_at.
classrooms listed
missing or invalid token
token valid but lacks the classrooms:read scope
invalid pagination parameter
GET /api/v2/classrooms HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read classrooms
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
classroom found
classroom not in the caller district
GET /api/v2/classrooms/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read materials
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: title, created_at, updated_at.
materials listed
missing or invalid token
curriculum_map_id is not in the caller district
GET /api/v2/curriculum_maps/{curriculum_map_id}/materials HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{}
],
"meta": {},
"links": {}
}- : Read objectives (standards)
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name, created_at, updated_at.
objectives listed
missing or invalid token
curriculum_map_id is not in the caller district
GET /api/v2/curriculum_maps/{curriculum_map_id}/objectives HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{}
],
"meta": {},
"links": {}
}- : Read curriculum maps
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: title, created_at, updated_at.
curriculum maps listed
missing or invalid token
token valid but lacks the curriculum_maps:read scope
invalid pagination parameter
GET /api/v2/curriculum_maps HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read curriculum maps
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
curriculum map found
curriculum map not in the caller district
GET /api/v2/curriculum_maps/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read schools
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name, created_at.
schools listed
missing or invalid token
district_id is not the caller district
invalid pagination parameter
GET /api/v2/districts/{district_id}/schools HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read schools
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
school found
school not in the caller district
GET /api/v2/districts/{district_id}/schools/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read the district
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
returns the caller district
missing or invalid token
token valid but lacks the districts:read scope
GET /api/v2/districts HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{}
],
"meta": {},
"links": {}
}- : Read the district
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
the caller district
any other district id
GET /api/v2/districts/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read assessment items
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: id.
items listed
missing or invalid token
token valid but lacks the items:read scope
material not in the caller district
GET /api/v2/materials/{material_id}/items HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read materials
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: title, created_at, updated_at.
materials listed
missing or invalid token
token valid but lacks the materials:read scope
invalid pagination parameter
GET /api/v2/materials HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {
"title": "text",
"description": "text",
"total_score": 1,
"privacy_level": 1,
"draft": true,
"available": true,
"created_at": "text",
"updated_at": "text",
"objective": {},
"subject": {},
"teacher": {}
},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read materials
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
material found
material not in the caller district
GET /api/v2/materials/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {
"id": "text",
"type": "text",
"attributes": {
"title": "text",
"objective": {},
"subject": {},
"teacher": {},
"items": [
{
"id": "text",
"item_type": 1,
"points": 1,
"objective": {}
}
]
},
"relationships": {}
}
}- : Read pathways
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name.
pathways listed
missing or invalid token
token valid but lacks the pathways:read scope
invalid pagination parameter
GET /api/v2/pathways HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read pathways
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
pathway found
pathway not in the caller district
GET /api/v2/pathways/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read reports
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Report slug. Supported: item_analysis.
item_analysis: required. The tracker/classroom to analyze.
item_analysis: optional. Narrows to one assessment in the classroom.
report rows returned
missing or invalid token
token valid but lacks the reports:read scope
unknown report name
missing required filter
GET /api/v2/reports/{report_name} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {
"report_name": "text",
"columns": [
"text"
],
"rows": [
{
"question_number": 1,
"item_title": "text",
"standard": "text",
"item_type": "text",
"dok": 1,
"points": 1,
"percent_correct": 1
}
]
},
"meta": {}
}- : Read sections
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: name, created_at.
sections listed
missing or invalid token
token valid but lacks the sections:read scope
invalid pagination parameter
GET /api/v2/sections HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read sections
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
section found
section not in the caller district
GET /api/v2/sections/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read teachers
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
Comma-separated; prefix with - for descending. Allowed: last_name, created_at.
teachers listed
missing or invalid token
token valid but lacks the teachers:read scope
invalid pagination parameter
GET /api/v2/teachers HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"type": "text",
"attributes": {},
"relationships": {}
}
],
"meta": {},
"links": {}
}- : Read teachers
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
teacher found
teacher not in the caller district
GET /api/v2/teachers/{id} HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {}
}- : Read assessments
OAuth 2.0 Client Credentials. Exchange your client_id/client_secret at the token URL for a short-lived Bearer token, then call the API with it.
tracker tree returned
missing or invalid token
token valid but lacks the assessments:read scope
tracker not in the caller district
GET /api/v2/trackers/{tracker_id}/assessments HTTP/1.1
Host: api.masteryconnect.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": {
"id": "text",
"type": "text",
"attributes": {
"name": "text",
"subject": "text",
"teacher": "text",
"school": "text",
"archived": true,
"created_at": "text",
"updated_at": "text",
"standards": [
{
"id": "text",
"name": "text",
"assessments": [
{
"id": "text",
"title": "text",
"assessment_items": [
{}
]
}
]
}
]
}
}
}Last updated
Was this helpful?