← Back to Platform

API Changelog

Track API changes, breaking updates, and new features. Stay current with versioned releases and migration guides.

Stay Updated: Get notified when we ship API changes, new endpoints, and breaking updates.

Subscribe to Updates

Latest Releases

v1.0 Launch

🚀 Public API Launch

ThinkKits API is now publicly available! Our REST API provides programmatic access to school profiles, funding data, and analytics.

Core Endpoints

  • GET /schools — Search and filter K-12 schools
  • GET /schools/{nces_id} — Detailed school profiles
  • GET /districts — District-level data and demographics
  • GET /funding — Federal funding eligibility and amounts
  • GET /erate — E-Rate vendor and procurement data
  • GET /grants — Grant opportunities and deadlines

Authentication

  • API key authentication via X-API-Key header
  • Tier-based rate limiting (3–100 requests/day)
  • JSON Web Token support for advanced integrations

Response Format

  • Consistent JSON structure with data, meta, and links fields
  • Pagination via cursor-based navigation
  • Rate limit headers on all responses
  • Error responses follow RFC 7807 Problem Details format

Deprecation Notice Template

Deprecation Notice

When we deprecate API features, we'll provide at least 90 days notice and migration guidance. Deprecated endpoints will return a Sunset header with the retirement date.

Example HTTP/1.1 200 OK Content-Type: application/json Sunset: "Sun, 01 Jan 2028 00:00:00 GMT" Link: <https://thinkkits.com/help-center/docs/api-changelog.html>; rel="sunset" { "data": [...], "deprecated": true, "deprecation_notice": "This endpoint will be removed on Jan 1, 2028. Migrate to /v2/schools.", "migration_url": "https://thinkkits.com/help-center/docs/api-changelog.html#v2-migration" }

Migration Guide Template

General Migration Process

When we release breaking changes, follow this process to update your integration:

  1. Review the changelog for your affected endpoints and data fields
  2. Test against our sandbox API at https://api-sandbox.thinkkits.com
  3. Update your client libraries to handle new response formats
  4. Deploy to staging and run your integration tests
  5. Monitor error rates after production deployment
  6. Contact support if you encounter issues during migration
Need Help?

Our API team offers migration assistance for Business tier customers. Contact us to schedule a consultation.

Upcoming Changes

Here's what's planned for future API releases:

v1.1 Feature

Enhanced Analytics Endpoints

  • Bulk school comparison endpoint
  • Demographic trend analysis
  • Funding gap analysis by district
  • Custom report generation API

Webhook Support

  • Real-time notifications for school data changes
  • Grant deadline alerts
  • E-Rate filing period notifications
v2.0 Breaking

GraphQL API

  • Unified GraphQL endpoint for all data types
  • Real-time subscriptions via WebSocket
  • Advanced filtering and aggregation
Migration Required

v2.0 will include breaking changes. REST API v1.x will be supported until Q4 2027.

Questions about API changes? Contact our API team.

← Full API Documentation · Rate Limits · Back to Platform

Was this article helpful?

← Back to Help Center