Messages

Get messages

get

Get messages by specified filters.

Authorizations

APIKeyHeaderAPIKeyQuery

Query parameters

msg_hashstring[]Optional

Message hash. Acceptable in hex, base64 and base64url forms.

body_hashstringOptional

Hash of message body.

sourcestringOptional

The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.

destinationstringOptional

The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.

opcodestringOptional

Opcode of message in hex or signed 32-bit decimal form.

start_utimeintegerOptional

Query messages with created_at >= start_utime.

end_utimeintegerOptional

Query messages with created_at >= start_utime.

start_ltintegerOptional

Query messages with created_lt >= start_lt.

end_ltintegerOptional

Query messages with created_lt <= end_lt.

directionstring · enumOptional

Direction of message.

Possible values:

exclude_externalsbooleanOptional

Exclude external messages.

only_externalsbooleanOptional

Return only external messages.

limitinteger · min: 1 · max: 1000Optional

Limit number of queried rows. Use with offset to batch read.

offsetintegerOptional

Skip first N rows. Use with limit to batch read.

sortstring · enumOptional

Sort transactions by lt.

Possible values:

Responses

200

OK

application/json

400

Bad Request

application/json

get

HTTPcURLJavaScriptPython

GET /api/v3/messages HTTP/1.1
Host: ton-index.nownodes.io
X-Api-Key: YOUR_API_KEY
Accept: */*

{
  "address_book": {
    "ANY_ADDITIONAL_PROPERTY": {
      "domain": "text",
      "user_friendly": "text"
    }
  },
  "messages": [
    {
      "bounce": true,
      "bounced": true,
      "created_at": "0",
      "created_lt": "0",
      "destination": "text",
      "fwd_fee": "0",
      "hash": "text",
      "hash_norm": "text",
      "ihr_disabled": true,
      "ihr_fee": "0",
      "import_fee": "0",
      "in_msg_tx_hash": "text",
      "init_state": {
        "body": "text",
        "decoded": {
          "comment": "text",
          "type": "text"
        },
        "hash": "text"
      },
      "message_content": {
        "body": "text",
        "decoded": {
          "comment": "text",
          "type": "text"
        },
        "hash": "text"
      },
      "opcode": 1,
      "out_msg_tx_hash": "text",
      "source": "text",
      "value": "0",
      "value_extra_currencies": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": {
      "is_indexed": true,
      "token_info": [
        {
          "description": "text",
          "extra": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "image": "text",
          "name": "text",
          "symbol": "text",
          "type": "text"
        }
      ]
    }
  }
}