# Contacts and orders

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

Read only: contacts (`kind=lead`) or orders (`kind=order`) left on the website, newest first, filtered by `status`, paged with `page`, `per_page` (at most 50) and `meta`. A contact has `name`, `phone`, the form content (`payload`, keys depend on the website's form) and `source_page`; an order has its code, items, shipping fee, total (`null` when the website shows no price), payment method and status. Handle contacts and orders in TinoPage Builder ([sign-in ticket](/en/docs/api/builder-post-login)).

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites/@site/leads` |
| 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 |
| `site` | path | string | yes | Website ID (UUID, `id` in the website list) |
| `kind` | query | string | no | `lead` (contacts, default) or `order` (orders) |
| `status` | query | string | no | Filter by status: `moi`, `da_lien_he`, `xac_nhan`, `dang_giao`, `hoan_tat`, `huy`; omit for all |
| `page` | query | int | no | Page, default 1 |
| `per_page` | query | int | no | Items per page, default 20, at most 50 |

## Example request

```bash
curl "https://api.tino.vn/service/100003/builder/sites/5b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e/leads?kind=order&status=xac_nhan" \
  -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/@site/leads")`.

## Example response

```json
{
 "data": [
  {
   "id": "9c4d2e10-7b3a-4f8e-a1d6-2e5f8c0b7a34",
   "code": "DH0012",
   "name": "Nguyễn Văn A",
   "phone": "0900000000",
   "address": "12 Lê Lợi, phường Bến Thành",
   "note": "Giao trước 17 giờ",
   "items": [
    {
     "name": "Bánh kem dâu",
     "option": "20 cm",
     "qty": 1,
     "subtotal": 350000
    }
   ],
   "shipping": 30000,
   "total": 380000,
   "payment": "COD",
   "status": "xac_nhan",
   "status_label": "Đã xác nhận",
   "created_at": "2026-10-26T01:45:00Z",
   "sheet_error": ""
  }
 ],
 "meta": {
  "page": 1,
  "per_page": 20,
  "total": 1,
  "last_page": 1
 }
}
```

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