---
title: "List git namespaces by provider"
method: GET
path: "/v1/integrations/git-namespaces"
tags: ["integrations"]
---

# List git namespaces by provider

`GET /v1/integrations/git-namespaces`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/integrations/git-namespaces`
- Auth: HTTP bearer

Lists git namespaces for a supported provider. Supported providers are `github`, `gitlab` and `bitbucket`. If the provider is not provided, it will try to obtain it from the user that authenticated the request.

## Query parameters

- `host` string: The custom Git host if using a custom Git provider, like GitHub Enterprise Server
- `provider` 'github' | 'github-limited' | 'github-custom-host' | 'gitlab' | 'bitbucket'
- `viewerMetadata` boolean: When true, includes the viewer object for each namespace.

## Response `200`

- object[]
  - `id` union, required
    - string
    - number
  - `installationId` number
  - `isAccessRestricted` false | true
  - `name` string
  - `ownerType` string, required
  - `provider` string, required
  - `requireReauth` false | true
  - `slug` string, required
  - `viewer` object
    - `canCreateApp` false | true
    - `role` union
      - string
      - number

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `429`
- `500`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 2 info
  - added the new optional `query` request parameter `viewerMetadata`
  - added the optional property `items/viewer` to the response with the `200` status
- **2026-01-22** `c12186034433`: 1 info
  - endpoint added
- **2025-04-22** `661a2f6357c1`: 1 breaking
  - api path removed without deprecation
- **2025-03-19** `37b482c58c92`: 1 warning, 6 info
  - deleted the `query` request parameter `teamId`
  - added the new optional `query` request parameter `host`
  - added the new enum value `github-custom-host` to the `query` request parameter `provider`
  - added the non-success response with the status `401`
  - …3 more

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/integrations/git-namespaces/get.md)

---

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