---
title: "Get the GitLab integration"
method: GET
path: "/integrations/gitlab"
---

# Get the GitLab integration

`GET /integrations/gitlab`

## Request

- Base URL: `https://app.gecko.security/api/v1`
- URL: `https://app.gecko.security/api/v1/integrations/gitlab`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Current GitLab connection state for the team, including the stored token expiry date. Never returns credentials.

## Response `200`

Success

- GitLabIntegration
  - `object` 'gitlab_integration', required
  - `enabled` boolean, required
  - `instance_url` string, nullable, required
  - `auth_mode` 'service_account_token' | 'oauth', nullable, required
  - `token_expires_at` string, nullable, required
  - `last_validated_at` string, nullable, required
  - `tracked_repositories_count` integer, required

## Other responses

- `401`: Authentication error
- `403`: Authorization error
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/gecko/apis/gecko-security-api.md) - [All operations](https://skmtc.dev/gecko/apis/gecko-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gecko/apis/gecko-security-api/revisions/9da49dae8b07?raw)