IonWarp logoIonWarp
Get started
IonWarp Docs
Get Started

Your First Scorecard

Checks, levels, and how the score ratchets.

Checklist step

This page is step first_scorecard of the onboarding checklist the product shows you, told API-first.

A scorecard is a set of Checks evaluated against your repository, grouped into Scorecard Levels.

List checksGET /api/v1/checks

curl "https://ionwarp.com/api/v1/checks?scorecard_id=ai-readiness" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
Which checks are failing on the AI readiness scorecard?
data_query {
  "collection": "scorecard_checks",
  "where": {
    "scorecard_id": "ai-readiness"
  }
}

{
  "object": "list",
  "data": [
    {
      "object": "check",
      "id": "obj_123",
      "level": "ci-cd",
      "milestone": "automation",
      "title": "CI runs on every pull request",
      "description": "A CI workflow runs the test suite on every pull request.",
      "status": "failed",
      "severity": "high",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

The score ratchets. A level you reach is a level you keep unless a check actually regresses — the number is meant to be a floor you defend, not a weather report. Starting a scan is a verb with a state machine behind it, so it is its own endpoint rather than a field write.

Beyond the checklist: Plans, Swarms and Quick Actions automate the loop, and Learnings is what it remembers.

On this page

No Headings
IonWarp logoIonWarp

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans