# GitLab REST API

**Provider:** GitLab
**Category:** developer
**Base URL:** `https://gitlab.com/api/v4`
**Auth:** bearer — `PRIVATE-TOKEN: glpat-...`
**Rate Limit:** 2,000 requests/min (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://docs.gitlab.com/ee/api/rest/

## Description

The GitLab REST API provides programmatic access to the full GitLab platform. Create and manage repositories, trigger and monitor CI/CD pipelines, manage merge requests and code reviews, handle issues, milestones, and project boards, manage users and groups, access audit logs, and configure webhooks. Supports both GitLab.com and self-hosted instances.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://gitlab.com/api/v4/projects` | List projects accessible to the current user |
| POST | `https://gitlab.com/api/v4/projects/{id}/repository/commits` | Create a commit with file changes |
| GET | `https://gitlab.com/api/v4/projects/{id}/pipelines` | List CI/CD pipelines for a project |
| POST | `https://gitlab.com/api/v4/projects/{id}/pipeline` | Create (trigger) a new pipeline |
| GET | `https://gitlab.com/api/v4/projects/{id}/merge_requests` | List merge requests for a project |
| GET | `https://gitlab.com/api/v4/projects/{id}/issues` | List issues with filtering and sorting |

## Authentication

Use a Personal Access Token (PAT), Group Token, or Project Token in the PRIVATE-TOKEN header, or as a Bearer token.

```
PRIVATE-TOKEN: glpat-...
```

## Sample Request

```bash
curl "https://gitlab.com/api/v4/projects?owned=true&order_by=last_activity_at" \
  -H "PRIVATE-TOKEN: $GITLAB_TOKEN"
```

## Sample Response

```json
{
  "id": 12345,
  "name": "my-project",
  "path_with_namespace": "mygroup/my-project",
  "default_branch": "main",
  "last_activity_at": "2024-03-15T10:00:00.000Z",
  "visibility": "private",
  "star_count": 42
}
```

## Pricing Details

Free: 400 CI/CD min/mo, 5GB storage. Premium $29/user/mo: 10k CI/CD min, code ownership, security dashboard. Ultimate $99/user/mo: unlimited security scanning, compliance.

---

*Source: [API Map](https://apimap.dev/apis/gitlab/) — CC BY 4.0*