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: active, disabled, pending, or failed. disabled means the page is offline because the account stayed over its token allowance. It comes back after a plan upgrade or the monthly allowance reset.

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
  }
}