Skip to main content
GET
Lazy folder expansion with aggregated state

Authorizations

Authorization
string
header
required

An Earnie API key, sent as Authorization: Bearer sk_earnie_.... Create one under Settings > API keys. The key's scopes decide which operations it may call.

Path Parameters

scanId
string<uuid>
required

Query Parameters

path
string
default:""

Folder prefix to expand. Defaults to root.

Response

Direct children of the requested folder.

path
string
required

Absolute path within the archive. Directories end with / (e.g. "src/lib/"); files do not (e.g.

kind
enum<string>
required
Available options:
dir,
file
total_files
integer
required

1 for a file row; count of descendant files for a dir row.

resolved_files
integer
required

Descendants with zero file_components rows.

match_type
enum<string> | null

Present only when kind = "file".

Available options:
match,
snippet,
no_match,
filtered
file_id
string<uuid> | null

The active file row's id (file rows only) — key for the detail pane's identification list + restore. Absent for model paths projected from scan evidence.

scan_outcome
enum<string> | null

Per-file scan result (file rows only). Distinct axis from decision_state. "manifest" marks a declared-dependency manifest file (design D-manifest-files) — never fingerprint-matched, excluded from OSS coverage math, but still listed here.

Available options:
filtered,
no_match,
matched,
manifest
decision_state
enum<string> | null

Per-file decision (file rows only). pending = no identification rows.

Available options:
pending,
identified,
ignored
identification_count
integer

File rows — number of component identifications (0 for pending/ignored).

has_note
boolean

File rows — true if any identification on this file carries a note.

pending_files
integer

Dir rows — descendant files with decision_state pending.

identified_files
integer

Dir rows — descendant files with decision_state identified.

ignored_files
integer

Dir rows — descendant files with decision_state ignored.

needs_review_files
integer

Dir rows — matched descendant files still pending (drives the folder pending dot).