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

# List Sources

`GET /sources`

## Query parameters

- `type` 'repository' | 'documentation' | 'research_paper' | 'huggingface_dataset' | 'local_folder' | 'slack' | 'google_drive', nullable — Filter by source type
- `query` string, nullable — Search by name or identifier
- `status` string, nullable — Filter by status
- `category_id` string, nullable — Filter by category
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- SourceListResponse — Response for listing sources.
  - `items` Source[] — List of sources
    - `id` string, required — Source identifier
    - `type` 'repository' | 'documentation' | 'research_paper' | 'huggingface_dataset' | 'local_folder' | 'slack' | 'google_drive', required — Source type
    - `identifier` string, nullable — Canonical identifier (repo slug, URL, or folder path)
    - `display_name` string, nullable — Human-readable name
    - `status` string, nullable — Indexing status
    - `created_at` string, nullable — Creation timestamp (ISO)
    - `updated_at` string, nullable — Last update timestamp (ISO)
    - `category_id` string, nullable — Category assignment
    - `is_global` boolean, nullable — Whether the source is global/shared
    - `global_source_id` string, nullable — Global source ID if applicable
    - `global_namespace` string, nullable — Global namespace if applicable
    - `metadata` object — Type-specific metadata
    - `curation` SourceCurationSummary — Compact curation info embedded into source responses.
      - `trust_signals` SourceTrustSignals — Trust and curation signals attached to a source.
        - `trust_level` 'low' | 'medium' | 'high' — User or team trust preference for the source
        - `trust_tier` 'low' | 'medium' | 'high' | 'verified' — Effective trust tier after derived verified/global signals
        - `scope` 'private' | 'organization' | 'global' — Ownership scope of the source
        - `is_global` boolean — Whether the source references a shared global source
        - `is_verified` boolean — Whether the source has a Nia-verified overlay
        - `overlay_available` boolean — Whether a curated overlay is attached
        - `annotation_count` integer — Number of saved annotations for this source
      - `overlay_summary` string, nullable — Short overlay summary if one exists
      - `recommended_queries` string[] — Suggested prompts from the overlay
  - `pagination` PaginationInfo, required — Pagination metadata.
    - `total` integer, required — Total number of items
    - `limit` integer, required — Items per page
    - `offset` integer, required — Current offset
    - `has_more` boolean, required — Whether more items exist

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nozomio-labs/apis/nia-ai-api.md) · [All operations](https://skmtc.net/nozomio-labs/apis/nia-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nozomio-labs/nia-ai-api/versions/dbb602a3ef17/schema)