CoreLab developers

Public API v1

Use a CoreLab API key to inspect DNS, certificates, and email configuration from your own backend. Free accounts include 5,000 units each calendar month.

Authentication

Send your key with either header. If both are present they must match.

Authorization: Bearer cl_live_your_key
X-API-Key: cl_live_your_key
GET

DNS lookup

https://corelab.web.id/api/v1/dns?domain=example.com&types=A,MX,NS

Quota: One unit per unique record type

GET

SSL inspection

https://corelab.web.id/api/v1/ssl?domain=example.com

Quota: One unit

POST

Email validation

https://corelab.web.id/api/v1/email/validate
{ "email": "[email protected]" }

Quota: One unit

Quota headers

  • X-Quota-Limit
  • X-Quota-Remaining
  • X-Quota-Reset (Unix timestamp)
  • X-Request-Id
  • Retry-After (HTTP 429)

Error format

{ "error": { "code": "QUOTA_EXCEEDED", "message": "...", "requestId": "..." } }

API keys are intended for server-side use. Never expose them in browser JavaScript or public repositories.