> ## Documentation Index
> Fetch the complete documentation index at: https://tonapi.ness.su/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Dns Expiring

> Get expiring account .ton dns



## OpenAPI

````yaml GET /v2/accounts/{account_id}/dns/expiring
openapi: 3.0.0
info:
  title: REST api to TON blockchain explorer
  version: 2.0.0
  description: Provide access to indexed TON blockchain
  contact:
    name: Support
    email: support@tonkeeper.com
servers:
  - url: https://tonapi.io
  - url: https://testnet.tonapi.io
  - url: http://localhost:8081
security: []
tags:
  - name: Accounts
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/accounts
  - name: NFT
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/nft
  - name: Jettons
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/jettons
  - name: DNS
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/dns
  - name: Wallet
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/wallet
  - name: Rates
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/rates
  - name: Staking
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/staking
  - name: Traces
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/traces
  - name: Events
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/events
  - name: Storage
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/storage
  - name: Connect
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/connect
  - name: Gasless
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/gasless
  - name: Multisig
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/multisig
  - name: Blockchain
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/blockchain
  - name: Lite Server
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/lite-server
  - name: Emulation
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/emulation
  - name: Utilities
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/utilities
  - name: ExtraCurrency
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/extra-currency
  - name: Purchases
paths:
  /v2/accounts/{account_id}/dns/expiring:
    get:
      tags:
        - Accounts
      description: Get expiring account .ton dns
      operationId: getAccountDnsExpiring
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/periodQuery'
      responses:
        '200':
          description: account's expiring .ton dns
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DnsExpiring'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    accountIDParameter:
      in: path
      name: account_id
      required: true
      description: account ID
      schema:
        type: string
        format: address
        example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    periodQuery:
      in: query
      name: period
      required: false
      description: number of days before expiration
      schema:
        type: integer
        minimum: 1
        maximum: 3660
  schemas:
    DnsExpiring:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          items:
            type: object
            required:
              - expiring_at
              - name
            properties:
              expiring_at:
                type: integer
                format: int64
                example: 1678275313
              name:
                type: string
                example: blah_blah.ton
              dns_item:
                $ref: '#/components/schemas/NftItem'
    NftItem:
      type: object
      required:
        - address
        - index
        - verified
        - metadata
        - approved_by
        - trust
      properties:
        address:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        index:
          type: integer
          format: int64
          example: 58
        owner:
          $ref: '#/components/schemas/AccountAddress'
        collection:
          type: object
          required:
            - address
            - name
            - description
          properties:
            address:
              type: string
              format: address
              example: >-
                0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
            name:
              type: string
              example: TON Diamonds
            description:
              type: string
              example: Best collection in TON network
        verified:
          type: boolean
          description: >-
            Collection master contract confirmed that this item is part of
            collection
          example: true
        metadata:
          type: object
          additionalProperties: true
          example: {}
        sale:
          $ref: '#/components/schemas/Sale'
        previews:
          type: array
          items:
            $ref: '#/components/schemas/ImagePreview'
        dns:
          type: string
          example: crypto.ton
        approved_by:
          allOf:
            - $ref: '#/components/schemas/NftApprovedBy'
          deprecated: true
          description: Please use trust field
        include_cnft:
          type: boolean
          example: false
        trust:
          $ref: '#/components/schemas/TrustType'
        code_hash:
          type: string
          description: Hash of the NFT item account code cell (hex)
        data_hash:
          type: string
          description: Hash of the NFT item account data cell (hex)
    AccountAddress:
      type: object
      required:
        - address
        - is_scam
        - is_wallet
      properties:
        address:
          type: string
          format: maybe-address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
        name:
          type: string
          example: Ton foundation
          description: >-
            Display name. Data collected from different sources like moderation
            lists, dns, collections names and over.
        is_scam:
          type: boolean
          example: true
          description: Is this account was marked as part of scammers activity
        icon:
          type: string
          example: https://ton.org/logo.png
        is_wallet:
          type: boolean
          example: true
    Sale:
      type: object
      required:
        - address
        - market
        - price
      properties:
        address:
          type: string
          format: address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
        market:
          $ref: '#/components/schemas/AccountAddress'
        owner:
          $ref: '#/components/schemas/AccountAddress'
        price:
          $ref: '#/components/schemas/Price'
    ImagePreview:
      type: object
      required:
        - resolution
        - url
      properties:
        resolution:
          type: string
          example: 100x100
        url:
          type: string
          example: https://site.com/pic1.jpg
    NftApprovedBy:
      type: array
      items:
        type: string
        example: getgems
        enum:
          - getgems
          - tonkeeper
    TrustType:
      type: string
      example: whitelist
      enum:
        - whitelist
        - graylist
        - blacklist
        - none
    Price:
      type: object
      required:
        - currency_type
        - value
        - decimals
        - token_name
        - verification
        - image
      properties:
        currency_type:
          $ref: '#/components/schemas/CurrencyType'
        value:
          type: string
          x-js-format: bigint
          example: '123000000000'
        decimals:
          type: integer
          example: 9
        token_name:
          type: string
          example: TON
        verification:
          $ref: '#/components/schemas/TrustType'
        image:
          type: string
          example: https://cache.tonapi.io/images/jetton.jpg
        jetton:
          type: string
          format: address
          example: 0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0
    CurrencyType:
      type: string
      example: jetton
      enum:
        - native
        - extra_currency
        - jetton
        - fiat
  responses:
    Error:
      description: Some error during request processing
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: string
              error_code:
                type: integer
                format: int64

````