Skip to main content
GET
List a directory of a release, or get a link to one of its files

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

owner
string
required

Owning user or team slug

Required string length: 1 - 255
name
string
required

Package name

Required string length: 1 - 255
version
string
required

An exact PEP 440 version (1.2 is 1.2.0, never 1.2.5), a ref name such as latest, or sha256: plus at least 12 hex digits of the content hash

Required string length: 1 - 255
path
string
required

File or directory, relative to the package root

Maximum string length: 4096

Query Parameters

expires_in
integer
default:3600

Seconds the link to a file stays valid

Required range: 60 <= x <= 3600

Response

Successful Response

kind
enum<string>
required
Available options:
directory,
file
path
string
required

Empty for the root

release_id
string
required
version
string | null
required
index_status
enum<string> | null
required

A root with no entries usually means indexing hasn't finished

Available options:
processing,
completed,
failed
entries
ReleaseFileEntry · object[]

Directories first, then files

file
ReleaseFileEntry · object | null
url
string | null

Time-limited link to a file's content

expires_at
string<date-time> | null