---
title: "GET /v1/files"
method: GET
path: "/v1/files"
tags: ["files"]
---

# GET /v1/files

`GET /v1/files`

## Request

- Base URL: `https://api.pkgseek.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pkgseek.com/v1/files`
- Auth: none declared

## Query parameters

- `q` string
- `distro` string
- `release` string
- `source` string
- `repo` string
- `arch` string
- `catalog_revision` string

## Response `200`

Packages shipping a matching file

- FileHit[]
  - `arch` string, nullable
  - `distro` string, required
  - `package` string, required
  - `path` string, required
  - `release` string, required
  - `repo` string, required
  - `resolution` PackageResolution
    - `catalog_revision` string, required
    - `coverage` ScopeCoverage, required
      - `generation` string, nullable
      - `observed_at` string, nullable
      - `reason` string, required
      - `state` string, required: Legacy index timestamps cannot prove a complete import generation.
    - `match_type` string, required
    - `policy` string, required
    - `requested` PackageScope, required: An explicit ordinary-repository request uses one exact release snapshot.
      - `arch` string, required
      - `distro` string, required
      - `release` string, required
      - `repo` string, nullable
      - `source` string, required
    - `resolved` PackageScope, required: An explicit ordinary-repository request uses one exact release snapshot.
      - `arch` string, required
      - `distro` string, required
      - `release` string, required
      - `repo` string, nullable
      - `source` string, required
    - `selection` string, required
    - `warnings` string[], required
  - `source` string, required
  - `version` string, required

---

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