---
title: "List custom sources"
method: GET
path: "/v1/sources/custom-sources"
tags: ["Sources"]
---

# List custom sources

`GET /v1/sources/custom-sources`

List custom sources for the authenticated account.

**⚠️ Beta Version**: This endpoint is in beta and may be subject to changes in future releases.

## Query parameters

- `cursor` string
- `page` integer
- `per_page` integer
- `search` string — Custom sources matching this search.
- `ordering` 'id' | '-id' | 'name' | '-name'

## Response `200`

Custom Source List

- object[]
  - `id` string — The ID of the custom source
  - `source_uuid` string — Unique identifier for the custom source
  - `name` string — The name of the custom source
  - `description` string, nullable — The description of the custom source
  - `use_only_detectors_with_validators` boolean — When true, scans of this source only keep secrets whose detector supports validity checks.

## Other responses

- `400` — Invalid data
- `401` — Invalid API key
- `503` — API under maintenance

---

[API](https://skmtc.net/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.net/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitguardian/gitguardian-api/revisions/511b067cdcb1/schema)