---
title: "List detector custom hosts"
method: GET
path: "/v1/detector-custom-hosts"
tags: ["Custom Hosts"]
---

# List detector custom hosts

`GET /v1/detector-custom-hosts`

List the custom hosts configured on the workspace, grouped by secret detector.

Only secret detectors that support custom hosts are returned.

## Response `200`

List of secret detectors with their custom hosts

- object[]
  - `detector_name` string, required
  - `checker_default_base_url` string, uri, nullable, required — Base URL of the default instance used when no custom host applies
  - `custom_hosts` object[], required
    - `base_url` string, uri, required
    - `is_active` boolean, required — Whether the workspace enabled secret checking against this host
    - `status` 'valid' | 'unreachable' | 'invalid', required — Result of a connectivity check from the GitGuardian instance to the host.

## Other responses

- `401` — Invalid API key
- `403` — Permission denied
- `503` — API under maintenance

## Changes

- **2026-09-21** `c17bab6cefbb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitguardian/apis/gitguardian-api/changes/v1/detector-custom-hosts/get.md)

---

[API](https://skmtc.dev/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.dev/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gitguardian/apis/gitguardian-api/revisions/1193ff4a5c36?raw)