---
title: "GET /v1/packages/{distro}/{name}/files"
method: GET
path: "/v1/packages/{distro}/{name}/files"
tags: ["packages"]
---

# GET /v1/packages/{distro}/{name}/files

`GET /v1/packages/{distro}/{name}/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/packages/{distro}/{name}/files`
- Auth: none declared

## Path parameters

- `distro` string, required
- `name` string, required

## Query parameters

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

## Response `200`

Indexed file list for the resolved build

- PackageFiles: File list payload for `GET /v1/packages/{distro}/{name}/files`: the same build resolution as the detail endpoint, but only the file paths, so clients can lazy-load them instead of paying for them in every detail response.
  - `arch` string, nullable
  - `distro` string, required
  - `files` string[], required: Indexed file paths for the resolved build (capped at 2000).
  - `name` 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
  - `total` integer, required: Total indexed file paths for the resolved build (un-truncated).
  - `truncated` boolean, required: True when `total` exceeds the returned `files` cap.
  - `version` string, nullable

## Other responses

- `404`: No such package

---

[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)