---
title: "List GitHub App installations"
method: GET
path: "/v1/repository-connections/installations"
tags: ["Git"]
---

# List GitHub App installations

`GET /v1/repository-connections/installations`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/repository-connections/installations`
- Auth: API key in cookie `__Host-better-auth.session_token`

Returns the team's GitHub App installations and a signed link that installs the app for more accounts or repositories.

## Query parameters

- `teamId` string: Team whose GitHub App installations to read. Required unless the deprecated `spaceId` is sent.
- `returnSpaceId` string: A Space in that team to come back to after a new install: the returned `installUrl` lands on its Builds page. Omit it to land on the team's New space screen.
- `spaceId` string: Deprecated. Use `teamId`. A Space whose team to read; it also acts as the return Space.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `readiness` object, required
      - `canAuthorize` boolean, required
      - `canInstall` boolean, required
      - `webhookReady` boolean, required
      - `codeStorageReady` boolean, required
      - `ready` boolean, required
    - `installUrl` string, uri, nullable, required
    - `installations` object[], required
      - `id` string, required
      - `accountLogin` string, required
      - `accountType` string, nullable, required
      - `htmlUrl` string, uri, nullable, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)