A run represents a single scan execution against a project's linked repositories. The Runs API lets you trigger new scans, list past runs with their status and duration, and retrieve the detailed mismatch report for any completed run. Runs are triggered automatically on push events but can also be started manually through the API.
Each run object includes a status field that progresses through queued, scanning, and completed states. Poll the run endpoint or subscribe to webhooks to know when results are ready. The response includes a summary with total mismatches by severity and a link to the full mismatch list, which is paginated for large projects.