> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scorecard API

> Aggregated action outcomes over the decision log.

```
GET /v1/cofounder/scorecard
```

See [Autopilot Scorecard](../capabilities/autopilot-scorecard) for the conceptual overview.

## GET — fetch the scorecard

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/cofounder/scorecard?appId=6479581124&days=30" -H "X-API-Key: $KEY"
```

Query params:

| Param   | Default         | Notes                    |
| ------- | --------------- | ------------------------ |
| `appId` | (all your apps) | Filter to one app        |
| `days`  | 30              | Window, clamped to 7–180 |

Response:

```jsonc theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "windowDays": 30,
    "totals": {
      "proposed": 6,          // still waiting for review
      "applied": 9,
      "approvedPending": 1,   // approved, not executed yet
      "rejected": 3,
      "measured": 5,          // applied actions with a before/after snapshot
      "positive": 3,
      "negative": 1,
      "neutral": 1
    },
    "byType": [
      { "actionType": "asc_metadata_update", "applied": 4, "positive": 3, "negative": 1, "neutral": 0 }
    ],
    "recent": [
      {
        "actionId": "uuid",
        "appId": "6479581124",
        "actionType": "asc_metadata_update",
        "title": "Update subtitle (en-US)",
        "status": "applied",
        "proposedAt": "2026-06-12T08:00:00Z",
        "appliedAt": "2026-06-12T08:42:00Z",
        "direction": "positive",            // positive | negative | neutral | pending
        "measuredOutcome": "revenue +$41.20 | downloads +6.3%"
      }
    ]
  }
}
```

`direction` is a heuristic over the before/after snapshots (revenue delta ≥ \$1 wins; else downloads ±2%; else neutral). `pending` means the 14-day measurement window hasn't produced a snapshot pair yet.
