API Documentation
REST Endpoints
Complete reference for all TrustCyber REST API endpoints.
The TrustCyber REST API provides programmatic access to your assessment data, findings, reports, and organization information. All responses are returned in JSON format.
Assessments
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/assessments | List all assessments for your organization |
| GET | /v1/assessments/:id | Get a specific assessment by ID |
| GET | /v1/assessments/latest | Get the most recent assessment |
| POST | /v1/assessments/trigger | Trigger a new assessment run |
bash
# Get the latest assessment
curl -X GET "https://api.trustcyber.com/v1/assessments/latest" \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"id": "asmnt_01HXYZ",
"status": "completed",
"completedAt": "2025-03-15T14:32:00Z",
"scores": {
"risk": 68,
"compliance": 71,
"ransomwareExposure": 42,
"copilotReadiness": 55
}
}Findings
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/findings | List all findings (supports filtering by severity, status) |
| GET | /v1/findings/:id | Get a specific finding |
| PATCH | /v1/findings/:id | Update finding status |
bash
# List critical findings
curl -X GET "https://api.trustcyber.com/v1/findings?severity=critical&status=open" \
-H "Authorization: Bearer YOUR_API_KEY"