---
title: "List Tlds"
method: GET
path: "/api/domains/tlds"
tags: ["services"]
---

# List Tlds

`GET /api/domains/tlds`

## Request

- Base URL: `https://api.monacloud.vn`
- URL: `https://api.monacloud.vn/api/domains/tlds`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Token`

Đọc dữ liệu tại `/api/domains/tlds`. Phản hồi dùng JSON và tuân theo schema được công bố bên dưới.

## Query parameters

- `scope` 'popular' | 'all'
- `include_adult` boolean
- `group` string, nullable: Lọc theo danh mục, lấy slug từ /tlds/groups
- `q` string, nullable: Tìm trong tên đuôi và nhãn tiếng Việt
- `max_price_vnd` integer, nullable: Chỉ lấy đuôi có giá năm đầu không quá số này
- `sort` 'popular' | 'price' | 'tld'
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- DomainTld[]
  - `tld` string, required
  - `label_vi` string, required
  - `group` string, required
  - `group_label` string, required
  - `type` string, required
  - `sources` string[], required
  - `price_vnd` integer, nullable, required
  - `needs_verification` boolean, required
  - `status` 'ban-ngay' | 'bao-gia-khi-mua', required
  - `adult` boolean, required
  - `renew_vnd` integer, nullable
  - `promo_vnd` integer, nullable
  - `registrar` string, nullable
  - `popularity` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/monacloud/apis/mona-cloud-api-compute-truoc-ay-vibecloud.md) · [All operations](https://skmtc.dev/monacloud/apis/mona-cloud-api-compute-truoc-ay-vibecloud/llms.txt) · [OpenAPI document](https://skmtc.dev/monacloud/apis/mona-cloud-api-compute-truoc-ay-vibecloud/revisions/34a120ed37ce?raw)