> ## 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.

# Decode Message

> Decode a given message. Only external incoming messages can be decoded currently.



## OpenAPI

````yaml POST /v2/message/decode
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/message/decode:
    post:
      tags:
        - Emulation
      description: >-
        Decode a given message. Only external incoming messages can be decoded
        currently.
      operationId: decodeMessage
      requestBody:
        $ref: '#/components/requestBodies/Boc'
      responses:
        '200':
          description: decoded message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecodedMessage'
        default:
          $ref: '#/components/responses/Error'
components:
  requestBodies:
    Boc:
      description: bag-of-cells serialized to hex
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - boc
            properties:
              boc:
                type: string
                format: cell
  schemas:
    DecodedMessage:
      type: object
      required:
        - destination
        - destination_wallet_version
      properties:
        destination:
          $ref: '#/components/schemas/AccountAddress'
        destination_wallet_version:
          type: string
          example: v3R2
        ext_in_msg_decoded:
          type: object
          properties:
            wallet_v3:
              type: object
              required:
                - subwallet_id
                - valid_until
                - seqno
                - op
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                seqno:
                  type: integer
                  format: int64
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_v4:
              type: object
              required:
                - subwallet_id
                - valid_until
                - seqno
                - op
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                seqno:
                  type: integer
                  format: int64
                  example: 1
                op:
                  type: integer
                  format: int32
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_v5:
              type: object
              required:
                - raw_messages
                - valid_until
              properties:
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_highload_v2:
              type: object
              required:
                - subwallet_id
                - bounded_query_id
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                bounded_query_id:
                  type: string
                  example: '34254528475294857'
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
    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
    DecodedRawMessage:
      type: object
      required:
        - message
        - mode
      properties:
        message:
          type: object
          required:
            - boc
          properties:
            boc:
              type: string
              format: cell
            decoded_op_name:
              type: string
              example: nft_transfer
            op_code:
              type: string
              x-js-format: bigint
              example: '0xdeadbeaf'
            decoded_body: {}
        mode:
          type: integer
          example: 2
  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

````