Source: https://seerepo.com/docs/api-events
Markdown source: https://seerepo.com/docs/api-events.md
Description: The commits since a date, in plain words.

# What changed

`GET https://seerepo.com/api/v1/repos/:repo/events`

Returns the commits since a date, newest first: when, which agent or person, what changed in plain words and the modules each touched. By default the last 24 hours; at most the last 90 days and 200 commits.

## Request

| Parameter | Where | Description |
|---|---|---|
| `repo` | path | The repo's id, or owner/name with %2F. |
| `since` | query | A date, like 2026-10-19 or 2026-10-19T08:00:00Z. |

```sh
curl "https://seerepo.com/api/v1/repos/6ad79fd8e89233277ded17c9/events?since=2026-10-19" \
  -H "Authorization: Bearer $SEEREPO_KEY"
```

## Response

| Field | Type | Description |
|---|---|---|
| `data.since` | string | Where the list starts. |
| `data.total` | number | How many commits there are since then. Above 200, `commits` holds the newest 200. |
| `data.commits[].at` | string | When. |
| `data.commits[].sha` | string | The commit, short. |
| `data.commits[].what` | string | What changed, in plain words. |
| `data.commits[].message` | string | The commit's message as written. |
| `data.commits[].agents[]` | string | The agents that signed it; empty when none did, and then `person` says who wrote it. |
| `data.commits[].person` | string\|null | Who made it, by their login or name, when SeeRepo knows. |
| `data.commits[].worlds[]` | string | The modules it touched. |
| `data.commits[].reach` | object\|null | How far it got: the other `files` it reaches and the `pages` it gets to, measured with the code of its push. null on a commit older than this. |

### Example

```json
{
  "status": "success",
  "data": {
    "since": "2026-10-19T00:00:00.000Z",
    "total": 1,
    "commits": [
      {
        "sha": "a1b2c3d",
        "at": "2026-10-20T16:07:36.685Z",
        "what": "The pricing page shows the yearly price.",
        "message": "fix pricing",
        "agents": [
          "Claude"
        ],
        "person": null,
        "files": 2,
        "worlds": [
          "Checkout"
        ]
      }
    ]
  }
}
```

## Authentication

An API key as `Authorization: Bearer sr_…`. See [Authentication](/docs/api#authentication).

## Errors

| Code | `code` | When |
|---|---|---|
| 400 | `bad_since` | since isn't a date. |
| 402 | `plan_required` | A repo on the free look: its commits in plain words come with a plan, as on its page. Its counts are in `/figures`. |

Besides the ones every endpoint has (401, 404, 429), see [Errors](/docs/api#errors).
