---
title: "List GitHub repositories available to Box"
method: GET
path: "/repos"
tags: ["Box"]
---

# List GitHub repositories available to Box

`GET /repos`

Returns GitHub repositories grouped by installation plus the current selected repositories for new Boxes.

## Query parameters

- `sync` boolean
- `limit` integer
- `cursor` string, nullable
- `sort` 'asc' | 'desc'
- `q` string
- `selected` boolean

## Response `200`

Repository groups and current Box repository selection.

- ReposResponse
  - `ok` boolean, required
  - `type` string, required — Stable success envelope discriminator added by v1.
  - `installations` RepositoryInstallation[], required
    - `type` string
    - `accountLogin` string
    - `accountAvatarUrl` string, uri, nullable
    - `repositories` Repository[]
      - `id` integer — GitHub repository id.
      - `databaseId` string — Internal repository id used when selecting repositories.
      - `name` string
      - `fullName` string
      - `private` boolean
      - `permissions` string
      - `pushedAt` string, date-time, nullable
  - `environmentId` string, required
  - `selectedRepositories` SelectedRepository[], required
    - `id` integer — GitHub repository id.
    - `databaseId` string — Internal repository id used when selecting repositories.
    - `name` string
    - `fullName` string
    - `private` boolean
    - `permissions` string
    - `pushedAt` string, date-time, nullable
    - `baseBranch` string
    - `setupRoutineId` string, nullable
    - `setupScript` string
    - `setupBlocking` boolean
    - `preCommitHooks` object[]
      - `id` string
      - `script` string
      - `blocking` boolean
  - `pageInfo` PageInfo
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required
    - `limit` integer, required

## Other responses

- `401` — Missing or invalid bearer token.
- `409` — Request conflicts with current account or box state.

---

[API](https://skmtc.dev/ascii/apis/box-public-api-v1.md) · [All operations](https://skmtc.dev/ascii/apis/box-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ascii/box-public-api-v1/revisions/82d576f82046/schema)