Skip to main content
GET
List and search packages

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string | null

Opaque next_cursor from the previous page

q
string | null

Matches the name, description and owner slug, or an exact tag; owner/name matches that one package

Maximum string length: 255
owner
string | null

Owning user or team slug

Maximum string length: 255
tag
string[] | null

Packages with any of these tags

Maximum array length: 50
framework
enum<string> | null

The verifiers API the package targets. v0 is the Legacy group, so it also matches unknown

Available options:
v0,
v1,
unknown
sort
enum<string>
default:featured

featured: featured first, then installs; installs; stars; updated: most recently changed

Available options:
featured,
installs,
stars,
updated
visibility
enum<string> | null

public lists what everyone can see, which never includes hidden packages. Omit it to list every package you can read

Available options:
public,
private
starred
boolean
default:false

Only packages you have starred

mine
boolean
default:false

Only your own packages and those you collaborate on, directly or through a team

team_id
string | null

With mine: list this team's workspace instead, meaning packages it owns or collaborates on. Empty unless you are a member

Maximum string length: 255
include_counts
boolean
default:false

Return total and featured_total, on the first page only

Response

Successful Response

items
PackageSummary · object[]
required
next_cursor
string | null

Pass as cursor to fetch the next page; null on the last

total
integer | null

Exact for small sets, an estimate for large ones

How many of total are featured