Clever Developer Docs

Testing Your Sync

To test your integration with Clever, you have several options for testing with sandbox districts. You can test your sync against two precreated data sets - Clever USD and Certification ISD - or create your own custom sandbox district.

Testing with Clever USD

When you sign up for a dev app, a sandbox district is automatically created, populated with the Clever USD dataset, and linked to your dev app. The naming convention is {dev app name} Sandbox, and you can find it listed as a district in your dashboard on the "Home" tab.

Clever USD has:

  • 239 schools
  • 8,412 or more teachers
  • 56,635 or more students
  • 25,843 or more sections
  • 460,000 or more enrollments
  • 6 school admins

Each dev app is given its own sandbox dataset so the instance is unique to your app. If you'd like to modify any data in this sandbox district, please reach out to [email protected] with an email address not already registered with Clever (i.e. not the same one as you used to create your dev app) requesting that we add you as an admin to your sandbox district.

You can download the CSVs used to populate your default sandbox district here.

Testing with Certification ISD

Another option is you can connect to a centralized dataset that:

1) Contains known edge cases and "unclean data" you can use to verify that your integration can handle these correctly. This allows you to test the worst of the worst district data. To facilitate the generation of these edge cases, this dataset automatically rotates between 3 days of data every 3 days.

The full list of edge cases and the users that fulfill each one can be found in this spreadsheet. Certification ISD Edge Cases.

The raw data can be found here: Certification ISD.

2) Allows you to test Events syncs. If you are looking to test events, one option is you can leverage the automatic rotating nature of this sandbox to process the event stream.

If you'd like to do this, please reach out to [email protected] with the name of your dev app and a request to connect to the Certification ISD sandbox district.

Note that, unlike the Clever USD auto-created sandboxes, this sandbox is centrally managed by Clever and therefore read-only; you won't be able to make any changes to this sandbox.

Creating your own custom sandbox district

To perform testing with a new custom sandbox where you upload your own data, check out our guide to creating your own custom sandbox district.

Updated 6 months ago

Testing Your Sync


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.