Skip to main content
GET
List team reports
Manage the reports built with Report Builder - the drag-and-drop canvas for client-ready SEO, traffic, audit, and AI-visibility reports. Every route is scoped to the selected team (brand) and requires at least the member role.
Listing reports omits the heavy content document to keep payloads light. content is returned when you get, create, or update a single report.
Report routes are rate limited to 60 requests per minute.

Report fields


List Reports

GET /v3/reports List the reports for the selected team, paginated (default page size 25). Returns reports plus page, pageSize, total, and totalPages, with content omitted from each row. Use search to filter by name, and sortBy (name or created) with sortDir (asc or desc) to sort. Without sortBy, reports are ordered by most recently updated first.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
page
integer

1-based page. Default 1.

pageSize
string

Rows per page (max 1000), or 'all'. Every response reports total and totalPages.

sortBy
enum<string>
Available options:
name,
created
sortDir
enum<string>
Available options:
asc,
desc

Response

Default Response

page
integer
required
pageSize
integer
required
total
integer
required
totalPages
integer
required
reports
object[]
required