---
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`

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[]
  - `provider` string, required
  - `slug` string, required
  - `id` union, required
    - string
    - number
  - `ownerType` string, required
  - `name` string
  - `isAccessRestricted` false | true
  - `installationId` number
  - `requireReauth` false | true
  - `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`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)