API Reference

Authorization: Bearer YOUR_API_KEY

https://app.certforge.xyz/api/v1        (cloud)
https://your-host/api/v1                (self-hosted)

GET /api/v1/certs

{
  "certs": [
    {
      "id": "cert_abc123",
      "domains": ["api.internal.corp.com"],
      "dtp_id": "internal-services",
      "environment": "production",
      "issued_at": "2026-01-01T00:00:00Z",
      "expires_at": "2027-01-01T00:00:00Z",
      "days_remaining": 228,
      "status": "active"
    }
  ],
  "total": 1
}

GET /api/v1/certs/{id}

POST /api/v1/certs/{id}/revoke
Content-Type: application/json

{ "reason": "key_compromise" }

GET /api/v1/approvals?status=pending

GET /api/v1/approvals/{id}

POST /api/v1/approvals/{id}/approve

POST /api/v1/approvals/{id}/reject
Content-Type: application/json

{ "reason": "Domain not in approved list" }

GET /api/v1/audit?event_type=certificate.&days=30&limit=100

GET  /api/v1/platform/orgs
POST /api/v1/platform/orgs
GET  /api/v1/platform/orgs/{id}

{
  "error": "certificate not found",
  "code": "not_found"
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1716030060

POST https://your-host:8443/v1/enroll