---

Table of Contents

Key Entities
Authentication
Pagination
Rate Limits

---

Key Entities

The grade passback API contains two new object types that don’t appear in the Clever Data API Schema: Assignments and Submissions.

• An assignment is an activity that can be completed by a student. Amongst other fields, it includes a due date as well as a potential score.
• A submission is a specific student’s attempt at completing the assignment.

---

Authentication

Authentication for the grade passback API uses the same district-app token as a rostering connection. This token should be passed as a Bearer token in the header of the request.

---

Pagination

Pagination for the grade passback API works slightly differently than in the data API. For requests that return more than one page of results, a “next” link will be provided, but there will not be a “previous” link. This relative link is only valid for two hours after the original request is made.

---

Rate Limits

The Grade Passback API has the same rate limits as the Clever data API , 1200 requests per minute per Bearer token. Note that some requests, especially those for creating and updating assignments or submissions, may take longer than requests to the data API, so make sure not to set request timeouts too short (we recommend between 15 and 60 seconds).