# List websites

`GET /service/@id/builder/sites` · TinoPage Builder, service owner's sign-in token

Websites of the account, oldest first, with `meta` (`page`, `per_page`, `total`, `last_page`). Each has a status (`status`: `draft` not published, `published`), `paused` (paused by the system, `paused_reason: over_limit` when over the website count), the domain it runs on (`host`), a preview link (`preview_url`) and pages, items and domains used against the website's limits.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites` |
| Method | `GET` |
| Authentication | the TinoPage Builder service owner's sign-in token (`Authorization: Bearer <token>`); the `/v1` gateway does not expose TinoPage Builder yet |
| Content-Type | — (no body) |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | int | yes | TinoPage Builder service ID |
| `page` | query | int | no | Page, default 1 |
| `per_page` | query | int | no | Websites per page (all websites currently fit on one page: `meta.last_page` is 1) |

## Example request

```bash
curl "https://api.tino.vn/service/100003/builder/sites" \
  -H "Authorization: Bearer $TINO_TOKEN"
```

`$TINO_TOKEN` is the TinoPage Builder service owner's sign-in token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("GET", "/service/@id/builder/sites")`.

## Example response

```json
{
 "data": [
  {
   "id": "5b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
   "name": "Tiệm bánh Hoa Mai",
   "slug": "tiem-banh-hoa-mai",
   "status": "published",
   "paused": false,
   "paused_reason": null,
   "host": "example.vn",
   "preview_url": "https://builder.tino.vn/tiem-banh-hoa-mai",
   "pages": {
    "used": 3,
    "limit": 10
   },
   "items": {
    "used": 12,
    "limit": 100
   },
   "domains": {
    "used": 1,
    "limit": 2
   },
   "created_at": "2026-10-26T02:10:00Z",
   "updated_at": "2026-10-26T03:20:00Z"
  }
 ],
 "meta": {
  "page": 1,
  "per_page": 1,
  "total": 1,
  "last_page": 1
 }
}
```

Sample built from the TinoPage Builder API (Tino relays the answer as is inside `data`); values are examples.