---
title: "Retrieve namespace subscription"
method: GET
path: "/api/v4/namespaces/{id}/gitlab_subscription"
tags: ["namespaces"]
---

# Retrieve namespace subscription

`GET /api/v4/namespaces/{id}/gitlab_subscription`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/namespaces/{id}/gitlab_subscription`
- Auth: none declared

Retrieves GitLab subscription details for a specified namespace.

## Path parameters

- `id` integer, required

## Response `200`

Retrieve namespace subscription

- APIEntitiesGitlabSubscription: API_Entities_GitlabSubscription model
  - `plan` object, required
    - `code` string, required
    - `name` string, required
    - `trial` boolean, required
    - `auto_renew` boolean, required
    - `upgradable` boolean, required
    - `exclude_guests` boolean, required
  - `usage` object, required
    - `seats_in_subscription` integer, required
    - `seats_in_use` integer, required
    - `max_seats_used` integer, required
    - `seats_owed` integer, required
  - `billing` object, required
    - `subscription_start_date` string, date, required
    - `subscription_end_date` string, date, required
    - `trial_ends_on` string, date, required

---

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