---
title: "Skill file tree and contents"
method: GET
path: "/api/upstream/listings/{id}/files"
tags: ["catalog"]
---

# Skill file tree and contents

`GET /api/upstream/listings/{id}/files`

## Request

- Base URL: `https://skillselion.com`
- URL: `https://skillselion.com/api/upstream/listings/{id}/files`
- Auth: none declared

SKILL.md first, then bundled files. Empty array when files are not stored.

## Path parameters

- `id` string, required

## Headers

- `API-Version` '1'

## Response `200`

Files for the skill (may be empty).

- ListingFile[]
  - `path` string, required
  - `content` string
  - `contents` string
  - `bytes` integer

## Other responses

- `400`: Invalid query or body.
- `401`: Authentication required (staff routes only).
- `404`: No listing or route matches.
- `405`: Method not allowed.
- `429`: Rate limited. Retry-After and RateLimit headers are set.
- `500`: Upstream or server error.

---

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