---
title: "GET /v2/accounts/{account_id}/dns/expiring"
method: GET
path: "/v2/accounts/{account_id}/dns/expiring"
tags: ["Accounts"]
---

# GET /v2/accounts/{account_id}/dns/expiring

`GET /v2/accounts/{account_id}/dns/expiring`

## Request

- Base URL: `https://tonapi.io`
- URL: `https://tonapi.io/v2/accounts/{account_id}/dns/expiring`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/docs/v2/accounts/:account_id/dns/expiring/get.ts> (a function with typed inputs; its response is checked against the schema)

Get expiring account .ton dns

## Path parameters

- `account_id` string, address, required

## Query parameters

- `period` integer

## Response `200`

account's expiring .ton dns

- DnsExpiring
  - `items` object[], required
    - `dns_item` NftItem
      - `address` string, address, required
      - `approved_by` string[], required
      - `code_hash` string: Hash of the NFT item account code cell (hex)
      - `collection` object
        - `address` string, address, required
        - `description` string, required
        - `name` string, required
      - `data_hash` string: Hash of the NFT item account data cell (hex)
      - `dns` string
      - `include_cnft` boolean
      - `index` integer, required
      - `metadata` object, required
      - `owner` AccountAddress
        - `address` string, maybe-address, required
        - `icon` string
        - `is_scam` boolean, required: Is this account was marked as part of scammers activity
        - `is_wallet` boolean, required
        - `name` string: Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `previews` ImagePreview[]
        - `resolution` string, required
        - `url` string, required
      - `sale` Sale
        - `address` string, address, required
        - `market` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required: Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string: Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `owner` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required: Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string: Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `price` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
      - `trust` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
      - `verified` boolean, required: Collection master contract confirmed that this item is part of collection
    - `expiring_at` integer, required
    - `name` string, required

## Other responses

- `default`: Some error during request processing

---

[API](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer.md) - [All operations](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/revisions/fc4add7a71a0?raw)