Results Endpoint
Retrieve individual scan results or list your scan history programmatically.
GET /api/v1/scan/{id}
Retrieve a specific scan result by its UUID. Returns the same response format as the scan endpoint.
Request
curl https://zeodyn.com/api/v1/scan/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer zd_live_xxxxx"Returns 200 OK with the full scan result, or 404 Not Found if the scan does not exist or has expired. Scan results are retained for 30 days.
Response (200 OK)
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://example.com",
"score": 72,
"band": "Strong Foundation",
"dimensions": [ ... ],
"recommendations": [ ... ],
"scannedAt": "2026-02-22T10:30:00.000Z"
}GET /api/v1/scans
List your scan history with pagination. Returns scans in reverse chronological order.
Request
curl "https://zeodyn.com/api/v1/scans?page=1&limit=20" \
-H "Authorization: Bearer zd_live_xxxxx"Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| page | integer | 1 | Page number (1-indexed) |
| limit | integer | 20 | Results per page (max 100) |
Response (200 OK)
{
"scans": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://example.com",
"overallScore": 72,
"band": "Strong Foundation",
"bandLabel": "Strong Foundation",
"createdAt": "2026-02-22T10:30:00.000Z"
}
],
"total": 42,
"page": 1,
"pages": 3
}The list endpoint returns summary data for each scan. To retrieve the full dimension breakdown and recommendations, fetch the individual scan using its id.
Error responses
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 404 | Scan not found or expired |
| 429 | Rate limit exceeded |