List recent evidence runs for a target

GET

https://api.recursiv.io/api/v1/evidence/runs

GET

/api/v1/evidence/runs

curl -G https://api.recursiv.io/api/v1/evidence/runs \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d limit=20 \
     -d target_id=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
     -d target_type=agent

{
  "meta": {
    "has_more": false,
    "limit": 20,
    "offset": 0
  },
  "runs": [
    {
      "completed_at": "2024-06-01T12:05:00Z",
      "result_summary": "All checks passed successfully.",
      "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "started_at": "2024-06-01T12:00:00Z",
      "status": "completed",
      "target_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "target_type": "agent"
    },
    {
      "completed_at": "2024-05-31T15:35:00Z",
      "result_summary": "Timeout error during evidence collection.",
      "run_id": "b2c3d4e5-f678-90ab-cdef-234567890abc",
      "started_at": "2024-05-31T15:30:00Z",
      "status": "failed",
      "target_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "target_type": "agent"
    }
  ]
}

Query parameters

target_typeenumRequired

Allowed values:

target_idstringRequiredformat: "uuid"

limitintegerOptional<=100Defaults to 20

Response

Recent runs

Errors

401

Unauthorized Error