API Reference
API Reference
REST API for integrating Certus into your workflows. All endpoints require a Bearer token.
Authentication
Pass your API key as: Authorization: Bearer YOUR_API_KEY
Base URL: https://api.getcertus.app
Rate limits
Starter: 60 req/min · Professional: 300 req/min · Enterprise: custom
GET
/v1/certificatesList all certificates for the authenticated organisation.
| Parameter | Type | Description |
|---|---|---|
limit | integer | Max results (default 20, max 100) |
status | string | Filter: verified | pending |
POST
/v1/certificatesGenerate a new Human Authenticity Certificate from a workflow session.
| Parameter | Type | Description |
|---|---|---|
session_id | string | Workflow session ID from the extension |
deliverable_name | string | Human-readable name for the deliverable |
GET
/v1/certificates/:idRetrieve a specific certificate by ID.
| Parameter | Type | Description |
|---|---|---|
id | string | Certificate UUID |
GET
/v1/certificates/:id/verifyPublic endpoint — verify a certificate without authentication.
GET
/v1/usageReturn current billing period usage for users, certificates, and storage.