---
title: "List files matching a glob pattern"
method: GET
path: "/search/ls"
tags: ["search"]
---

# List files matching a glob pattern

`GET /search/ls`

Returns files from a repository working copy matching a glob pattern, with file:// URIs

## Query parameters

- `repository_id` integer, required
- `pattern` string, required
- `page` integer
- `page_size` integer

## Response `200`

OK

- DtoLsResponse
  - `data` DtoLsFileData[]
    - `attributes` DtoLsFileAttributes
      - `path` string
      - `size` integer
    - `id` string
    - `links` DtoLsFileLinks
      - `self` string
    - `type` string
  - `links` JsonapiLinks
    - `first` string
    - `last` string
    - `next` string
    - `prev` string
    - `self` string
  - `meta` JsonapiMeta

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

> 14 revisions in range; 1 could not be searched.

- **2026-03-02** `e258f9541233` — 1 breaking, 1 warning, 1 info
  - added the new required `query` request parameter `repository_id`
  - deleted the `query` request parameter `repo_url`
  - the endpoint scheme security `APIKeyAuth` was removed from the API
- **2026-03-02** `58df37028089` — 1 info
  - endpoint added
- **2026-02-19** `41466db231c5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/helixml/apis/kodit-api/changes/search/ls/get.md)

---

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