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

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

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/integrations/search-repo/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/4191ba96b0c1/schema)