MasteryConnect REST API

Read-only, district-scoped access to your MasteryConnect assessment and mastery data over a REST API secured with OAuth 2.0.

The MasteryConnect REST API (v2) gives a district programmatic, read-only access to its own assessment data — schools, classrooms, sections, teachers, materials, assessment items, item banks, curriculum maps, standards and reports — so you can move that data into a warehouse, a dashboard, or an in-house integration.

Every request is authenticated with an OAuth 2.0 Bearer token and scoped to the single district that issued the credential. The API never returns another district's data.

Before you write any code, read the key concepts. The MasteryConnect data model draws a few distinctions — Material vs. Assessment, Section vs. Classroom, Kid vs. Student — that the endpoint names alone will not tell you.

Start Here

Key Concepts

Learn how the entities relate before you query them.

Getting Started

Get a token and make your first call, end to end.

Authentication

Exchange client credentials for a short-lived Bearer token.

Build Your Integration

Conventions

Response envelope, pagination, filtering, sorting and embeds.

Errors

The error envelope and every machine-readable error code.

Rate Limits & Policies

Request budgets, page caps and the headers that report them.

Reports

Pre-computed tabular extracts, such as item analysis.

API Reference

Every endpoint, parameter and response, ready to try.

At a Glance

Base URL	https://api.masteryconnect.com
Authentication	OAuth 2.0 client credentials → Bearer token
Token lifetime	2 hours (never longer than the credential itself)
Methods	GET only — the API is read-only
Response format	JSON, in a JSON:API-shaped envelope
Default page size	25 items (maximum 100)
Rate limit	300 requests per minute, per district

Availability

The API must be turned on for your district before any credential will work. Ask your MasteryConnect representative or Instructure Support to enable it; see Getting Started for what that involves.

Where To Get Help

Support

To report a bug or request a new endpoint, open a ticket with Instructure Support.

Status

Check platform availability and incident history.