---
title: "List git repositories linked to namespace by provider"
method: GET
path: "/v1/integrations/search-repo"
tags: ["integrations"]
---

# List git repositories linked to namespace by provider

`GET /v1/integrations/search-repo`

## Request

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

Lists git repositories linked to a namespace `id` for a supported provider. A specific namespace `id` can be obtained via the `git-namespaces`  endpoint. Supported providers are `github`, `gitlab` and `bitbucket`. If the provider or namespace is not provided, it will try to obtain it from the user that authenticated the request.

## Query parameters

- `query` string
- `namespaceId` union
  - string
  - number
  - string
  - number
- `provider` 'github' | 'github-limited' | 'github-custom-host' | 'gitlab' | 'bitbucket' | 'cursor-origin'
- `installationId` string
- `host` string: The custom Git host if using a custom Git provider, like GitHub Enterprise Server
- `teamId` string
- `slug` string

## Response `200`

- union
  - object
  - object
    - `error` object, required
      - `code` 'installation_not_found', required
      - `message` string, required
  - object
    - `gitAccount` object, required
      - `namespaceId` string, nullable, required
      - `provider` string, required
    - `repos` object[], required
      - `defaultBranch` string, required
      - `id` string, required
      - `name` string, required
      - `namespace` string, required
      - `owner` object, required
        - `id` string, required
        - `name` string, required
      - `ownerType` 'team' | 'user', required
      - `private` false | true, required
      - `provider` 'cursor-origin', required
      - `slug` string, required
      - `updatedAt` number, required
      - `url` string, required
  - object
    - `gitAccount` object, required
      - `namespaceId` union, required
        - string
        - number
      - `provider` 'bitbucket' | 'cursor-origin' | 'github' | 'github-custom-host' | 'github-limited' | 'gitlab' | 'vercel', required
    - `repos` object[], required
      - `defaultBranch` string, required
      - `id` union, required
        - string
        - number
      - `name` string, required
      - `namespace` string, required
      - `owner` object, required
        - `id` union, required
          - string
          - number
        - `name` string, required
      - `ownerType` 'team' | 'user', required
      - `private` false | true, required
      - `provider` 'bitbucket' | 'cursor-origin' | 'github' | 'github-custom-host' | 'github-limited' | 'gitlab' | 'vercel', required
      - `slug` string, required
      - `updatedAt` number, required
      - `url` string, required

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

## Changes

- **2026-08-22** `3157f7f3ef33`: 1 warning
  - added the new `user` enum value to the `oneOf[subschema #3]/repos/items/ownerType` response property for the response status `200`
- **2026-08-12** `b7b824605094`: 2 warning
  - added the new `cursor-origin` enum value to the `oneOf[subschema #4]/gitAccount/provider` response property for the response status `200`
  - added the new `cursor-origin` enum value to the `oneOf[subschema #4]/repos/items/provider` response property for the response status `200`
- **2026-08-06** `b8027f4efeda`: 1 breaking, 2 info
  - added `subschema #2, subschema #3` to the response body `oneOf` list for the response status `200`
  - added the new enum value `cursor-origin` to the `query` request parameter `provider`
  - added the non-success response with the status `502`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 2 warning
  - added the new `vercel` enum value to the `oneOf[subschema #2]/gitAccount/provider` response property for the response status `200`
  - added the new `vercel` enum value to the `oneOf[subschema #2]/repos/items/provider` response property for the response status `200`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/integrations/search-repo/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)