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

# Get Extended Address Information

> Get extended information about address



## OpenAPI

````yaml GET /api/v2/getExtendedAddressInformation
openapi: 3.1.1
info:
  title: TON HTTP API C++
  description: >
    This API enables HTTP access to TON blockchain - getting accounts and
    wallets information, looking up blocks and transactions, sending messages to
    the blockchain, calling get methods of smart contracts, and more.


    In addition to REST API, all methods are available through [JSON-RPC
    endpoint](#json%20rpc)  with `method` equal to method name and `params`
    passed as a dictionary.


    The response contains a JSON object, which always has a boolean field `ok`
    and either `error` or `result`. If `ok` equals true, the request was
    successful and the result of the query can be found in the `result` field.
    In case of an unsuccessful request, `ok` equals false and the error is
    explained in the `error`.


    API Key should be sent either as `api_key` query parameter or `X-API-Key`
    header
  version: 2.1.1
servers:
  - url: https://toncenter.com
    description: Mainnet
  - url: https://testnet.toncenter.com
    description: Testnet
security: []
tags:
  - name: utils
    description: Some useful methods
  - name: accounts
    description: Information about accounts
  - name: blocks
    description: Information about blocks
  - name: transactions
    description: Fetching and locating transactions
  - name: configuration
    description: Information about blockchain config
  - name: run method
    description: Run get-method of smart contracts
  - name: send
    description: Send data to blockchain
  - name: rpc
    description: JSON-RPC and POST endpoints
paths:
  /api/v2/getExtendedAddressInformation:
    get:
      tags:
        - accounts
      summary: Get Extended Address Information
      description: Get extended information about address
      operationId: getExtendedAddressInformation_get
      parameters:
        - $ref: '#/components/parameters/address'
        - $ref: '#/components/parameters/seqnoOptional'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                  result:
                    title: ExtendedAddressInformation
                    allOf:
                      - $ref: '#/components/schemas/ExtendedAddressInformation'
                required:
                  - ok
                  - result
        default:
          $ref: '#/components/responses/default'
components:
  parameters:
    address:
      name: address
      in: query
      description: Identifier of target TON account in any form
      required: true
      schema:
        $ref: '#/components/schemas/TonAddr'
    seqnoOptional:
      name: seqno
      in: query
      description: Seqno of a block
      required: false
      schema:
        type: integer
        format: int32
  schemas:
    ExtendedAddressInformation:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - fullAccountState
          default: fullAccountState
        address:
          $ref: '#/components/schemas/AccountAddress'
        balance:
          $ref: '#/components/schemas/Int256'
        extra_currencies:
          type: array
          items:
            $ref: '#/components/schemas/ExtraCurrencyBalance'
        last_transaction_id:
          $ref: '#/components/schemas/InternalTransactionId'
        block_id:
          $ref: '#/components/schemas/TonBlockIdExt'
        sync_utime:
          type: integer
          format: int64
        account_state:
          $ref: '#/components/schemas/AccountState'
        revision:
          type: integer
      required:
        - '@type'
        - address
        - balance
        - extra_currencies
        - last_transaction_id
        - block_id
        - sync_utime
        - account_state
        - revision
    TonAddr:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_addr
    AccountAddress:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - accountAddress
          default: accountAddress
        account_address:
          type: string
          x-usrv-cpp-type: ton_http::types::ton_addr
    Int256:
      type: string
      x-usrv-cpp-type: ton_http::types::int256
    ExtraCurrencyBalance:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - extraCurrency
          default: extraCurrency
        id:
          type: integer
          format: int32
        amount:
          $ref: '#/components/schemas/Int256'
      required:
        - '@type'
        - id
        - amount
    InternalTransactionId:
      type: object
      additionalProperties: false
      description: Internal transaction identifier.
      properties:
        '@type':
          type: string
          enum:
            - internal.transactionId
          default: internal.transactionId
        lt:
          type: string
          description: Logical time
          x-usrv-cpp-type: std::int64_t
        hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - lt
        - hash
    TonBlockIdExt:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - ton.blockIdExt
          default: ton.blockIdExt
        workchain:
          type: integer
        shard:
          type: string
          x-usrv-cpp-type: std::int64_t
        seqno:
          type: integer
        root_hash:
          $ref: '#/components/schemas/TonHash'
        file_hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - workchain
        - shard
        - seqno
        - root_hash
        - file_hash
      description: Extended block identifier.
    AccountState:
      oneOf:
        - $ref: '#/components/schemas/AccountStateRaw'
        - $ref: '#/components/schemas/AccountStateWalletV3'
        - $ref: '#/components/schemas/AccountStateWalletV4'
        - $ref: '#/components/schemas/AccountStateWalletHighloadV1'
        - $ref: '#/components/schemas/AccountStateWalletHighloadV2'
        - $ref: '#/components/schemas/AccountStateDns'
        - $ref: '#/components/schemas/AccountStateRWallet'
        - $ref: '#/components/schemas/AccountStatePChan'
        - $ref: '#/components/schemas/AccountStateUninited'
      discriminator:
        propertyName: '@type'
        mapping:
          raw.accountState:
            $ref: '#/components/schemas/AccountStateRaw'
          wallet.v3.accountState:
            $ref: '#/components/schemas/AccountStateWalletV3'
          wallet.v4.accountState:
            $ref: '#/components/schemas/AccountStateWalletV4'
          wallet.highload.v1.accountState:
            $ref: '#/components/schemas/AccountStateWalletHighloadV1'
          wallet.highload.v2.accountState:
            $ref: '#/components/schemas/AccountStateWalletHighloadV2'
          dns.accountState:
            $ref: '#/components/schemas/AccountStateDns'
          rwallet.accountState:
            $ref: '#/components/schemas/AccountStateRWallet'
          pchan.accountState:
            $ref: '#/components/schemas/AccountStatePChan'
          uninited.accountState:
            $ref: '#/components/schemas/AccountStateUninited'
    TonlibErrorResponse:
      type: object
      additionalProperties: false
      title: TonlibErrorResponse
      required:
        - ok
        - error
        - code
      properties:
        ok:
          type: boolean
          title: Ok
          default: false
        error:
          type: string
          title: Error description
        code:
          type: integer
          title: Error code
          minimum: 100
          maximum: 600
        '@extra':
          type: string
          title: Extra information
        jsonrpc:
          type: string
        id:
          type: string
    TonHash:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_hash
    AccountStateRaw:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - raw.accountState
          default: raw.accountState
        code:
          $ref: '#/components/schemas/Bytes'
        data:
          $ref: '#/components/schemas/Bytes'
        frozen_hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - code
        - data
        - frozen_hash
    AccountStateWalletV3:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - wallet.v3.accountState
          default: wallet.v3.accountState
        wallet_id:
          type: integer
          format: int64
        seqno:
          type: integer
          format: int32
      required:
        - '@type'
        - wallet_id
        - seqno
    AccountStateWalletV4:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - wallet.v4.accountState
          default: wallet.v4.accountState
        wallet_id:
          type: integer
          format: int64
        seqno:
          type: integer
          format: int32
      required:
        - '@type'
        - wallet_id
        - seqno
    AccountStateWalletHighloadV1:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - wallet.highload.v1.accountState
          default: wallet.highload.v1.accountState
        wallet_id:
          type: integer
          format: int64
        seqno:
          type: integer
          format: int32
      required:
        - '@type'
        - wallet_id
        - seqno
    AccountStateWalletHighloadV2:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - wallet.highload.v2.accountState
          default: wallet.highload.v2.accountState
        wallet_id:
          type: integer
          format: int64
      required:
        - '@type'
        - wallet_id
    AccountStateDns:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - dns.accountState
          default: dns.accountState
        wallet_id:
          type: integer
          format: int64
      required:
        - '@type'
        - wallet_id
    AccountStateRWallet:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - rwallet.accountState
          default: rwallet.accountState
        wallet_id:
          type: integer
          format: int64
        seqno:
          type: integer
          format: int32
        unlocked_balance:
          type: integer
          format: int64
        config:
          $ref: '#/components/schemas/RWalletConfig'
      required:
        - '@type'
        - wallet_id
        - seqno
        - unlocked_balance
        - config
    AccountStatePChan:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - pchan.accountState
          default: pchan.accountState
        config:
          $ref: '#/components/schemas/PChanConfig'
        state:
          $ref: '#/components/schemas/PChanState'
        description:
          type: string
      required:
        - '@type'
        - config
        - state
        - description
    AccountStateUninited:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - uninited.accountState
          default: uninited.accountState
        frozen_hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - frozen_hash
    Bytes:
      type: string
      x-usrv-cpp-type: ton_http::types::bytes
    RWalletConfig:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - rwallet.config
          default: rwallet.config
        start_at:
          type: integer
          format: int64
        limits:
          type: array
          items:
            $ref: '#/components/schemas/RWalletLimit'
      required:
        - '@type'
        - start_at
        - limits
    PChanConfig:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - pchan.config
          default: pchan.config
        alice_public_key:
          type: string
        alice_address:
          $ref: '#/components/schemas/AccountAddress'
        bob_public_key:
          type: string
        bob_address:
          $ref: '#/components/schemas/AccountAddress'
        init_timeout:
          type: integer
          format: int32
        close_timeout:
          type: integer
          format: int32
        channel_id:
          type: integer
          format: int64
      required:
        - '@type'
        - alice_public_key
        - alice_address
        - bob_public_key
        - bob_address
        - init_timeout
        - close_timeout
        - channel_id
    PChanState:
      oneOf:
        - $ref: '#/components/schemas/PChanStateInit'
        - $ref: '#/components/schemas/PChanStateClose'
        - $ref: '#/components/schemas/PChanStatePayout'
      discriminator:
        propertyName: '@type'
        mapping:
          pchan.stateInit:
            $ref: '#/components/schemas/PChanStateInit'
          pchan.stateClose:
            $ref: '#/components/schemas/PChanStateClose'
          pchan.statePayout:
            $ref: '#/components/schemas/PChanStatePayout'
    RWalletLimit:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - rwallet.limit
          default: rwallet.limit
        seconds:
          type: integer
          format: int32
        value:
          type: integer
          format: int64
      required:
        - '@type'
        - seconds
        - value
    PChanStateInit:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - pchan.stateInit
          default: pchan.stateInit
        signed_A:
          type: boolean
        signed_B:
          type: boolean
        min_A:
          type: integer
          format: int64
        min_B:
          type: integer
          format: int64
        expire_at:
          type: integer
          format: int64
        A:
          type: integer
          format: int64
        B:
          type: integer
          format: int64
      required:
        - '@type'
        - signed_A
        - signed_B
        - min_A
        - min_B
        - expire_at
        - A
        - B
    PChanStateClose:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - pchan.stateClose
          default: pchan.stateClose
        signed_A:
          type: boolean
        signed_B:
          type: boolean
        min_A:
          type: integer
          format: int64
        min_B:
          type: integer
          format: int64
        expire_at:
          type: integer
          format: int64
        A:
          type: integer
          format: int64
        B:
          type: integer
          format: int64
      required:
        - '@type'
        - signed_A
        - signed_B
        - min_A
        - min_B
        - expire_at
        - A
        - B
    PChanStatePayout:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - pchan.statePayout
          default: pchan.statePayout
        A:
          type: integer
          format: int64
        B:
          type: integer
          format: int64
      required:
        - '@type'
        - A
        - B
  responses:
    default:
      description: Tonlib error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TonlibErrorResponse'
          examples:
            '409':
              summary: Not a token
              value:
                ok: false
                code: 409
                error: Smart contract is not a Jetton or NFT
                '@extra': ...
            '422':
              summary: Request validation error
              value:
                ok: false
                code: 422
                error: ...
                '@extra': ...
            '429':
              summary: Ratelimit exceeded
              value:
                ok: false
                code: 429
                error: ...
                '@extra': ...
            '504':
              summary: Tonlib timeout
              value:
                ok: false
                code: 504
                error: ...
                '@extra': ...

````