Skip to main content
The CertWatch API allows you to programmatically manage certificates, notification channels, and retrieve monitoring data.

Base URL

All API requests are made to:
https://api.certwatch.app/v1

Authentication

All API endpoints require authentication using Bearer tokens.
curl https://api.certwatch.app/v1/certificates \
  -H "Authorization: Bearer YOUR_API_KEY"
See Authentication for details on obtaining and managing API keys.

Rate Limits

PlanRequests per minute
Pro60
Team300
Enterprise1000
Rate limit headers are included in all responses:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1704067200

Response Format

All responses are JSON formatted:
{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123"
  }
}

Error Responses

{
  "error": {
    "code": "invalid_request",
    "message": "The domain field is required",
    "details": { ... }
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

SDKs

Official SDKs coming soon:
  • JavaScript/TypeScript
  • Python
  • Go

Endpoints