RESTful API for submitting outputs, verifying seals, fetching dashboards, and receiving quality alerts. Built for CI/CD integration and enterprise procurement requirements.
https://api.certifyai.io/v1
/certify
Submit an agent output for certification grading. Returns a scoring report and, if passing, issues a certified seal.
| Field | Type | Description |
|---|---|---|
| agent_idrequired | string | Unique identifier for the agent being certified |
| industryrequired | string | One of: finance, healthcare, legal, government |
| use_caserequired | string | Specific use case (e.g., investment_recommendation) |
| output_textrequired | string | The agent output to grade |
| metadata | object | Optional: model_version, deployment_date, customer_tier |
{
"seal_id": "CERT-FIN-2026-A8X2K9",
"status": "passed",
"overall_score": 87,
"pass_threshold": 72,
"dimensions": {
"domain_knowledge": 91,
"adversarial_robustness": 84,
"explainability": 79,
"consistency": 88,
"compliance_format": 92
},
"valid_until": "2026-07-15T00:00:00Z",
"issued_at": "2026-04-15T12:00:00Z",
"seal_signature": "sha256:3f2a8b7c..."
}# Submit output for certification curl -X POST https://api.certifyai.io/v1/certify \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "finance-advisor-v3", "industry": "finance", "use_case": "investment_recommendation", "output_text": "Based on your risk profile and...", "metadata": { "model_version": "gpt-4-turbo", "customer_tier": "enterprise" } }'
/seal/:id
Retrieve the full details and current status of any seal by its ID. Use this to build verification widgets or compliance dashboards.
| Field | Type | Description |
|---|---|---|
| idrequired | string | The seal ID (e.g., CERT-FIN-2026-A8X2K9) |
{
"seal_id": "CERT-FIN-2026-A8X2K9",
"agent_id": "finance-advisor-pro-v3.2",
"industry": "finance",
"standard": "Finance Agent Certification",
"status": "valid",
"overall_score": 87,
"issued_at": "2026-01-15T00:00:00Z",
"valid_until": "2026-04-15T00:00:00Z",
"days_remaining": -2,
"seal_signature": "sha256:3f2a8b7c9d1e..."
}/dashboard
Fetch the full compliance dashboard data for your organization: all agents, their certification status, scores, and any active alerts.
| Field | Type | Description |
|---|---|---|
| status | string | Filter: certified, at_risk, pending, expired |
| industry | string | Filter: finance, healthcare, legal, government |
| limit | integer | Max results (default 50, max 200) |
{
"organization": "acme-financial",
"summary": {
"total_agents": 18,
"certified": 12,
"at_risk": 3,
"pending_review": 2,
"expired": 1
},
"agents": [
{
"agent_id": "finance-advisor-pro-v3.2",
"industry": "finance",
"status": "certified",
"score": 87,
"seal_id": "CERT-FIN-2026-A8X2K9",
"valid_until": "2026-07-15T00:00:00Z",
"last_graded": "2026-04-15T12:00:00Z",
"score_trend": "stable"
}
],
"alerts": [
{
"agent_id": "credit-underwrite-v1.8",
"severity": "warning",
"message": "Output quality dropped below threshold on 2026-04-14",
"timestamp": "2026-04-14T09:22:00Z"
}
]
}/webhook
Register a webhook URL to receive real-time quality alerts when agent output degrades below threshold, or when a seal is approaching expiry.
curl -X POST https://api.certifyai.io/v1/webhook \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-system.com/webhooks/certifyai", "events": ["quality.degraded", "seal.expiring", "seal.expired"], "secret": "whsec_your_signing_secret" }'