List pages

List static websites hosted through this Vee3 account.

← All Pages endpoints · Capability overview

GET/v1/pages

https://api.vee3.io/v1/pages

10 tokens

List static websites hosted through this Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

pages.list

Parameters2 fields

limitintegerOptional

Maximum number of pages to return.

Default: 50 · min 1, max 100

pageintegerOptional

Page number for paginated results.

Default: 1 · min 1

Response14 fields

pagesarrayitems

9 fields

Pages for this Vee3 account.

page_idstring

Unique identifier for the page.

namestring

Display name for the page, if set.

slugstring

Page slug.

statusstring

Current page status.

urlstring

Public HTTPS URL for the page. Uses the custom domain when one is attached.

hostnamestring

Preview hostname ({slug}.vee3.site). Always present, including when a custom domain is attached.

custom_domainstring

Custom hostname attached to the page, if any.

created_atstring

When the page was created.

last_deployed_atstring

When files were last deployed to the page.

pagingobject

3 fields

Pagination metadata for the result set.

total_itemsinteger

Total pages matching the query.

current_pageinteger

Current page number.

page_sizeinteger

Number of pages returned per page.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, pages_not_configured, pages_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/pages"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "limit": 50,
    "page": 1
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample page list response.

pages_page.json

{
  "pages": [
    {
      "page_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Docs",
      "slug": "docs",
      "status": "active",
      "url": "https://docs.vee3.site",
      "hostname": "docs.vee3.site",
      "custom_domain": null,
      "created_at": "2026-08-11T12:00:00.000Z",
      "last_deployed_at": "2026-08-11T12:05:00.000Z"
    }
  ],
  "paging": {
    "total_items": 1,
    "current_page": 1,
    "page_size": 50
  }
}