> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List the knowledge sources you have

> Every matching source in one unpaged response, newest first, optionally for one collection. A well-formed id that is not yours matches nothing, not an error.

Returns every matching source in one response, newest first. This endpoint is not paged.

`collection_id` filters the list. A well-formed ID that is not one of your collections matches nothing and returns an empty `data` array, not an error. Any role in the organization can list sources.

<ParamField query="collection_id" type="string">
  Return only the sources of this collection (a UUID). A malformed value returns `400`.
</ParamField>

## Response

<ResponseField name="data" type="object[]" required>
  Sources, newest first.

  <Expandable title="properties">
    <ResponseField name="id" type="string" required>
      Source ID (a UUID).
    </ResponseField>

    <ResponseField name="collection_id" type="string" required>
      Collection the source ingests into.
    </ResponseField>

    <ResponseField name="source_type" type="string" required>
      `website`, `sitemap`, `github` or `upload`.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Display name.
    </ResponseField>

    <ResponseField name="configuration" type="object" required>
      Stored configuration. Every value is a string. See [Create a
      source](/api-reference/knowledge/create-source).
    </ResponseField>

    <ResponseField name="status" type="string" required>
      `active`, `paused` or `disabled`. Only an `active` source is ingested.
    </ResponseField>

    <ResponseField name="last_source_version" type="string | null" required>
      Source version read by the last ingestion run that ended `succeeded` or `partial`, such as a
      commit SHA for a GitHub source. `null` if never ingested.
    </ResponseField>

    <ResponseField name="last_ingested_at" type="string | null" required>
      ISO 8601 timestamp in UTC of the last ingestion run that ended `succeeded` or `partial`.
      `null` if never ingested.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp, in UTC.
    </ResponseField>

    <ResponseField name="updated_at" type="string" required>
      ISO 8601 timestamp, in UTC.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request GET "$MITHUNAI_URL/arukz/api/v1/knowledge/sources?collection_id=0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/knowledge/sources",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      params={"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88"},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const params = new URLSearchParams({ collection_id: '0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88' })
  const response = await fetch(
    `${process.env.MITHUNAI_URL}/arukz/api/v1/knowledge/sources?${params}`,
    {
      headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
    },
  )
  console.log(await response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": [
      {
        "id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
        "collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
        "source_type": "github",
        "name": "Platform repository",
        "configuration": {
          "owner": "example-org",
          "repository": "platform-docs",
          "ref": "main",
          "include_paths": "docs/,README.md",
          "exclude_paths": ".git/,node_modules/,vendor/,dist/,build/,target/,.venv/,**/__pycache__/,**/*.min.js,**/*.lock"
        },
        "status": "active",
        "last_source_version": "4f9c2e7a1b3d5c8e0f2a4b6c8d0e1f3a5b7c9d2e",
        "last_ingested_at": "2026-09-24T10:22:41.503117",
        "created_at": "2026-09-24T10:16:30.119842",
        "updated_at": "2026-09-24T10:22:41.503117"
      }
    ]
  }
  ```

  ```json 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "validation_error", "message": "A knowledge base id is not valid." }
  ```
</ResponseExample>