# Liên hệ và đơn hàng

`GET /service/@id/builder/sites/@site/leads` · TinoPage Builder, token đăng nhập của chủ dịch vụ

Chỉ xem: liên hệ (`kind=lead`) hoặc đơn hàng (`kind=order`) khách để lại trên website, mới trước, lọc theo `status`, phân trang bằng `page`, `per_page` (tối đa 50) kèm `meta`. Liên hệ có `name`, `phone`, nội dung biểu mẫu (`payload`, khoá tuỳ mẫu website), `source_page`; đơn hàng có mã đơn, mặt hàng, phí giao, tổng tiền (`null` khi website không ghi giá), cách trả tiền, trạng thái. Xử lý liên hệ, đơn hàng làm trong TinoPage Builder ([vé đăng nhập](/docs/api/builder-post-login)).

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites/@site/leads` |
| Method | `GET` |
| Xác thực | token đăng nhập của chủ dịch vụ TinoPage Builder (`Authorization: Bearer <token>`); gateway `/v1` chưa mở TinoPage Builder |
| Content-Type | — (không có body) |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `id` | đường dẫn | int | có | ID dịch vụ TinoPage Builder |
| `site` | đường dẫn | string | có | ID website (UUID, `id` ở danh sách website) |
| `kind` | query | string | không | `lead` (liên hệ, mặc định) hoặc `order` (đơn hàng) |
| `status` | query | string | không | Lọc theo trạng thái: `moi`, `da_lien_he`, `xac_nhan`, `dang_giao`, `hoan_tat`, `huy`; bỏ trống lấy tất cả |
| `page` | query | int | không | Trang, mặc định 1 |
| `per_page` | query | int | không | Số mục mỗi trang, mặc định 20, tối đa 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` là token đăng nhập của chủ dịch vụ TinoPage Builder. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): chưa có hàm riêng, dùng `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
 }
}
```

Mẫu dựng theo API của TinoPage Builder (Tino chuyển tiếp nguyên câu trả lời trong `data`), giá trị là ví dụ.