News and Updates

How to Stay Up-to-Date

If you want to stay up-to-date on the latest news from Clever, we recommend subscribing to our product newsletter. Clever sends out one newsletter per month to share API changes, upcoming product releases, and opportunities to provide roadmap feedback. To subscribe, please e-mail [email protected].

API & Documentation Change-log

If you have feedback, feature requests, or questions, please reach out to [email protected].

Upcoming Changes

June 2018

  • June 29: Official EOL of all deprecated features in v1.1 (see April 2017 for more details).


With the release of API v1.2, we are no longer adding new features to v1.1.

Recent & Historical Changes

September 2017

  • September 20, 2017: Feature update - If a district is sharing by users (and their associated enrollments), sections.enrollments will only show students shared with you. Previously, we would show all students, which required applications to handle 404s for unshared students. More info here.
  • September 18, 2017: Removed Instant Login sample code from Libraries and Sample Code - the examples are deprecated and no longer follow our best practices.

April 2017

  • April 18: We're officially deprecating several legacy features that have very little usage. While they are deprecated, we will continue to support the features through June 2018, though no new customers may use these features from now on.
  • page parameter
  • count parameter
  • created_since parameter
  • sort parameter
  • distinct parameter
  • Using the limit parameter with a value greater than 10,000
  • - use instead
  • v1.1/push/events endpoint - use v1.1/events instead
  • Multipart form data

March 2017

March 14: Added API versioning policy to API Policy page.

February 2017

  • February 8: Removed several non-technical guides that were very out of date - see our Help Center instead.
  • Feburary 8: Removed references to several extremely inactive Google Groups & one broken link
  • February 8: Fixed references to point to [email protected] (our actual developer-facing support email)

January 2017

  • January 18: Added documentation on debugging instant login for school & district admins
  • January 17: Removed section on password migration - officially deprecated June 30th, 2016
  • January 3: Removed iOS recommendations - we are redoing our IL recommendations on iOS and will redo this shortly.

November 2016

  • November 7: New developer applications will automatically have a district sandbox attached and populated with our standard set of district data.
  • November 16: Increased support for Student Contacts in Aeries.

October 2016

  • October 31: Instant Login bearer token API responses:
  • We found a bug where /v1.1/students/{id}/sections and /v1.1/teachers/{id}/sections return all sections associated with the user, even if they are not explicitly shared by the district. These endpoints will now only return explicity shared sections.
  • We will no longer return null values for response fields. In places where a null value would previously have been returned for a field, that field will now be omitted from the response. This affects the term.start_date, term.end_date, dob, and period fields.
  • Removed iep and ell from responses NOTE: iep_status and ell_status are unaffected; these are legacy fields
  • For Secure Sync Customers: Added credentials.district_username to /v1.1/school_admins/{id} response
  • .google_apps object will not be returned if it is empty
  • email will be properly populated by on the /me endpoint
  • October 27: Updated sandbox data set to exclude nces_id, which is no longer accepted in the schools.csv file. We update nces_id in our database automatically.

July 2016

  • July 20: Updated our logout best practices to more clearly reflect our suggested approach for handling users logging out of applications.

June 2016

  • June 30: Feature retirement: district passwords will no longer be returned in API responses. We recommend using Instant Login to authenticate users instead.
  • Jun 28: Removed references to deprecated and unsupported parameters on the API explorer.

April 2016

  • Apr 6: Reorganize doc index, create new step-by-step Secure Sync index
  • Apr 4: Deprecate UserVoice for product feedback

March 2016

February 2016

  • Feb 8: Clever now supports MDR Numbers for matching districts and schools.

January 2016

  • January 31: Feature retirement: simple pagination with 'page' parameters will no longer be supported. Use cursored pagination with relative links, starting_after, and ending_before parameters instead.
  • January 31: and retired; use and instead.
  • Jan 20: Added Product Newsletters section with Dec and Jan newsletters
  • Jan 7: Updated docs to reflect Matchmaker changes

December 2015

  • Dec 22: Added Submit Product Feedback UserVoice forum link
  • Dec 10: Added realistic sandbox data to the Custom Sandbox Districts
  • Dec 4: Updated dates on Migrating Off District Passwords.

November 2015

  • Nov 20: Added district to Student Contacts.
  • Nov 12: Added some tips on processing authorization codes.

October 2015

  • Oct 30: Added documentation around mdr_number sometimes appearing in school objects.
  • Oct 19: Updated Student Contacts documentation with information about our new bulk retrieval methods.
  • Oct 19: Updated Events documentation with more detail about processing events.

August 2015

  • Aug 27: Documented Matchmaker, a service we provide for Secure Sync.
  • Aug 20: Added answers to many frequently asked questions.
  • Aug 19: Added documentation around How Districts Add Applications.

July 2015

  • July 20: Added a guide to our guides and guidance for working with Instant Login Districts.
  • July 17: School admins are now documented as part of Admins.
  • July 15: Clarified our support for Student Contacts.
  • July 10: Documented Instant Login Links, a new way districts can link to your application from any portal.

June 2015

  • June 18: Launched with full documentation of all Clever developer products.
  • June 03: Clever now supports District Administrators in the Data API and with Clever Instant Login.

Archived changes

March 2015

  • March 1: Feature retirement: API keys are no longer accepted when authenticating API requests. Use bearer tokens instead.

February 2015

  • February 18: "Log in with Clever" buttons no longer require a district_id. When omitted, Clever will provide students and teachers with a district picker interface.

January 2015

  • January 26: Introduced a new API method: /sections/{id}/teachers.
    Sections now return relative links for "teachers".
  • January 15: Updated resource association documentation to indicate support for sections with multiple teachers or "co-teachers."

October 2014

  • October 9: Updated API to always return properly escaped rel links.
  • October 6: /me now contains an array of "links".

September 2014

  • September 5: Added GET /oauth/tokens endpoint, which lists every district token granted to a given application. Added documentation for this endpoint.

August 2014

  • August 28: Clarified that API key rate-limiting is live, and API keys authentication will be fully removed on March 1, 2015.
  • August 22: districts.created events are no longer returned when pulling events using token auth.
  • August 17: Removed range_paging metadata to improve performance.
  • August 15: Removed "lowest" and "highest" parameters from range_paging metadata. Made entries_remaining, pages_remaining counts in range_paging exclusive of current page. Fixed bug that caused "next" rel links to appear on the final page of a query. Add documentation for range_paging and paging objects to guide.
  • August 13: Restricted numeric-paging to the first 100 pages of results.
  • August 13: Replaced references to to /oauth/tokens.

July 2014

  • July 30: Fixed a bug introduced by range-based pagination rollout that prevented queries on Events that used the "created_since" and "page" parameters together.
  • July 29: Each OAuth app now has a single set of credentials, rather than two. Each developer has a dev app and a prod app.
  • July 25: Released range-based pagination, an improved way to iterate through large data sets. See "starting_after" and "ending_before" parameters.
  • July 24: Fixed a bug that could cause token-authenticated requests to the /events endpoint to return events scoped to an API_KEY, rather than a token.
  • July 17: Updated the URL and parameters for obtaining district tokens via OAuth
  • July 15: Fixed bug in /me endpoint. "type" property now exists inside of "data" object, matching spec. We will maintain the "type" property outside of the "data" object until 12/31/2014, to preserve backwards compatibility.

June 2014

  • Added support for Instant Login initiated from a developer's website

August 12, 2012

  • API Version 1.1 published

Did this page help you?