API Migration from TheChecker
API Migration from TheChecker
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 mostly the same and likely will require minimal or no changes for a majority of our users. All endpoints will remain the same unless otherwise stated below. There are no plans to deprecate this API at anytime 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 and not per API Key and were 100 / second / IP Address.
Bulk Verification API (JSON)
Send email list
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
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 besides total and verified will return 0 until the verification has completed.
The following undocumented fields have been deprecated: file, zip, and paid.
Bulk Verification API (File)
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 of the difference. Please include the full request and response, including all headers, and all information necessary for our team to replicate the issue.
Endpoints
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
Updated on: 12/07/2021
Thank you!