Source: https://seerepo.com/docs/api-repos
Markdown source: https://seerepo.com/docs/api-repos.md
Description: The maps your API key reads.

# List your repos

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

Lists the maps the key's account reads: its own repos and the ones shared with it. Each one has the id the other endpoints take. They come in the order of your panel: your own first, as you ordered them (or as the panel orders them when you haven't), then the ones shared with you, by name.

A repo can have a second branch SeeRepo follows. It isn't listed as a repo of its own: it comes inside `branches`, with the id that reads its map.

## Request

It takes no parameters.

```sh
curl "https://seerepo.com/api/v1/repos" \
  -H "Authorization: Bearer $SEEREPO_KEY"
```

## Response

| Field | Type | Description |
|---|---|---|
| `data[].id` | string | The repo's id. |
| `data[].name` | string | Its name in SeeRepo. |
| `data[].fullName` | string | owner/name, as on GitHub. |
| `data[].owner` | boolean | true if it's yours, false if it was shared with you. |
| `data[].lastPushAt` | string\|null | The last push SeeRepo read. |
| `data[].branch` | string\|null | The branch this map follows. |
| `data[].branches[]` | array | Its second branch, if SeeRepo follows one: `id` (the id of its map), `branch`, and `frozen` (null, or `{ reason, since, merged }` when it's no longer read; `reason` is `"branch"` when the branch was deleted on GitHub, and `merged` says whether it was merged first). |

### Example

```json
{
  "status": "success",
  "data": [
    {
      "id": "6ad79fd8e89233277ded17c9",
      "name": "tienda",
      "fullName": "ana/tienda",
      "owner": true,
      "lastPushAt": "2026-10-20T16:07:36.685Z",
      "branch": "main",
      "branches": [
        { "id": "6ad7a0c1e89233277ded17d2", "branch": "redesign", "frozen": null }
      ]
    }
  ]
}
```

## Authentication

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

## Errors

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