---
title: "List GitHub connections"
method: GET
path: "/api/v1/apps/github/installations"
tags: ["Raff Apps"]
---

# List GitHub connections

`GET /api/v1/apps/github/installations`

## Request

- Base URL: `https://api.rafftechnologies.com`
- URL: `https://api.rafftechnologies.com/api/v1/apps/github/installations`
- Auth: API key in header `X-API-Key`

The GitHub accounts and organizations connected to Raff Apps. Connect
GitHub once in the dashboard (Apps, Deploy an app, GitHub). Use a
connection's `id` as `github_installation_id` when you create an app
from a repository.

## Response `200`

GitHub connections

- object
  - `success` boolean
  - `installations` AppGitHubConnection[]
    - `id` string, uuid: Use as `github_installation_id`
    - `installation_id` integer: GitHub's own installation number
    - `github_login` string
    - `account_type` string: The GitHub account type (a user or an organization)
    - `status` string
    - `suspended` boolean
    - `settings_url` string: Where to change which repositories Raff can see
    - `created_at` string, date-time

## Other responses

- `401`: Authentication required

## Changes

- **2026-10-19** `e80a4b1b5024`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/apps/github/installations/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) - [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rafftechnologies/apis/raff-api/revisions/3d30cde0acb4?raw)