# DNS zone details

`GET /v1/service/@service_id/dns/@zone_id` · scope `dns:read`

Details of the DNS zone and all its records.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/v1/service/@service_id/dns/@zone_id` |
| Method | `GET` |
| Scope | `dns:read` |
| Header | `Authorization: Bearer <token>` |
| Content-Type | — (no body) |
| Tokens that can call it | app tokens (`tinoat_`), personal API tokens (`tinopat_`) |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `service_id` | path | integer | yes | DNS service ID |
| `zone_id` | path | integer | yes | DNS zone ID |

## Example request

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

`$TINO_TOKEN` is a token with the scope `dns:read`. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): Python `client.dns.get_zone(service_id, zone_id)`, Node.js `await client.dns.getZone(serviceId, zoneId);`, PHP `$client->dns->getZone($serviceId, $zoneId);`.

## Example response

```json
{
 "service_id": "100003",
 "name": "example.com",
 "records": {
  "0": {
   "id": 910001,
   "domain_id": 500001,
   "name": "example.com",
   "type": "SOA",
   "content": "<redacted>",
   "ttl": 7200,
   "prio": 0,
   "change_date": 0,
   "priority": 0
  },
  "1": {
   "id": 337915,
   "domain_id": 500001,
   "name": "example.com",
   "type": "NS",
   "content": "<redacted>",
   "ttl": 86400,
   "prio": 0,
   "change_date": 0,
   "priority": 0
  },
  "2": {
   "id": 337916,
   "domain_id": 500001,
   "name": "example.com",
   "type": "NS",
   "content": "<redacted>",
   "ttl": 86400,
   "prio": 0,
   "change_date": 0,
   "priority": 0
  },
  "3": {
   "id": 337917,
   "domain_id": 500001,
   "name": "webmail.example.com",
   "type": "CNAME",
   "content": "<redacted>",
   "ttl": 3600,
   "prio": 0,
  … 126 more line(s)
```

Live sample from a test account with personal data masked; long arrays and strings are trimmed (`… N more item(s)`, `… N more line(s)`).