API Migration from TheChecker

Learn how to migrate from the TheChecker API to Emailable.

View as Markdown

This information is specifically for users migrating from TheChecker API.

Please review the following breaking changes listed below when migrating from TheChecker to Emailable. Our API will remain largely the same and likely require minimal or no changes for most of our users. All endpoints will remain the same unless otherwise stated below. There are no plans to deprecate this API in the future beyond the changes already listed here.

Additionally, usage of TheChecker API endpoints will only work when using API Keys migrated from TheChecker. Emailable API Keys will not work.

Breaking Changes

General

Rate limits are now 25 / second / API Key for all endpoints. If you need higher rate limits, please contact support.

Please note that previous API rate limits were tracked per IP Address, not per API Key, and were 100/second/IP Address.

Bulk Verification API (JSON)

Send email list

Plain Text
POST https://api.thechecker.co/v2/verifications

Nothing has changed unless you send over 100k emails per request. Please note that the previous limit was 1M emails.

Check verification status

Plain Text
GET https://api.thechecker.co/v2/verifications/:verification_id

Nothing has changed unless you requested this endpoint during verification processing or you used any of the undocumented fields in the response.

  • All counts, except total and verified, will return 0 until verification is complete.
  • The following undocumented fields have been deprecated: file, zip, and paid.

Bulk Verification API (File)

Plain Text
POST https://api.thechecker.co/v2/verifications
GET https://api.thechecker.co/v2/verifications/:verification_id
DELETE https://api.thechecker.co/v2/verifications/:verification_id

This endpoint has been deprecated. We will no longer accept files at this endpoint for verification. We recommend you switch to the Emailable Batch API, which returns a more comprehensive set of verification data. Alternatively, you can also use the existing Bulk Verification API (JSON).

No Changes

The following endpoints should function exactly how they did prior to migration.

If you encounter any differences, please email api-bugs@emailable.com with a detailed explanation. Please include the full request and response, including all headers, and all information necessary for our team to replicate the issue.

Endpoints

Plain Text
GET https://api.thechecker.co/credit-balance
GET https://api.thechecker.co/v2/verify
GET https://api.thechecker.co/v2/verifications/:verification_id/json
DELETE https://api.thechecker.co/v2/verifications/:verification_id
Was this page helpful?

Thank you for helping improve our documentation.

Related articles