Retrieve namespace subscription

GET

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

• GitLab REST API

Retrieves GitLab subscription details for a specified namespace.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the namespace

Responses

200

OK

Media typeapplication/json

object

plan

object

code

string

name

string

trial

boolean

auto_renew

boolean

upgradable

boolean

exclude_guests

boolean

usage

object

seats_in_subscription

integer

seats_in_use

integer

max_seats_used

integer

seats_owed

integer

billing

object

subscription_start_date

string format: date

subscription_end_date

string format: date

trial_ends_on

string format: date

Example^generated

{
  "plan": {
    "code": "example",
    "name": "example",
    "trial": true,
    "auto_renew": true,
    "upgradable": true,
    "exclude_guests": true
  },
  "usage": {
    "seats_in_subscription": 1,
    "seats_in_use": 1,
    "max_seats_used": 1,
    "seats_owed": 1
  },
  "billing": {
    "subscription_start_date": "2026-04-15",
    "subscription_end_date": "2026-04-15",
    "trial_ends_on": "2026-04-15"
  }
}

404

Not Found