Skip to main content
Version: Endpoint V2

LayerZero Scan API Testnet

Base URL: https://scan-testnet.layerzero-api.com/v1
GET/messages/latest

Get latest messages
Query ParametersValue
ulnVersion
string
limit
start
end
nextToken
string
The token to be passed for retrieving the next set of paginated results
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.361Z",
"updated": "2025-05-27T19:20:54.361Z"
}
],
"nextToken": "string"
}
GET/messages/pathway/{pathwayId}

Get messages by pathway.
Path ParametersValue
pathwayId
string
required
Query ParametersValue
limit
nonce
status
string
start
end
nextToken
string
The token to be passed for retrieving the next set of paginated results
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.362Z",
"updated": "2025-05-27T19:20:54.362Z"
}
],
"nextToken": "string"
}
GET/messages/tx/{tx}

Get messages by transaction hash.
Path ParametersValue
tx
string
required
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.362Z",
"updated": "2025-05-27T19:20:54.362Z"
}
]
}
GET/messages/status/{status}

Get messages by status.
Path ParametersValue
status
string
required
Query ParametersValue
limit
start
end
nextToken
string
The token to be passed for retrieving the next set of paginated results
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.363Z",
"updated": "2025-05-27T19:20:54.363Z"
}
]
}
GET/messages/oapp/{eid}/{address}

Get messages by endpoint id and oapp address.
Path ParametersValue
eid
required
LayerZero Endpoint ID
address
string
required
Query ParametersValue
limit
start
end
nextToken
string
The token to be passed for retrieving the next set of paginated results
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.363Z",
"updated": "2025-05-27T19:20:54.363Z"
}
],
"nextToken": "string"
}
GET/messages/guid/{guid}

Get messages by guid.
Path ParametersValue
guid
string
required
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.363Z",
"updated": "2025-05-27T19:20:54.363Z"
}
]
}
GET/messages/wallet/{srcAddress}

Get messages by the wallet address the message originated from.
Path ParametersValue
srcAddress
string
required
The address initiating the message on the source chain.
Query ParametersValue
limit
start
end
nextToken
string
The token to be passed for retrieving the next set of paginated results
Response
{
"data": [
{
"pathway": {
"srcEid": 0,
"dstEid": 0,
"sender": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"receiver": {
"address": "string",
"id": "string",
"name": "string",
"chain": "string"
},
"id": "string",
"nonce": 0
},
"source": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": "string",
"blockTimestamp": 0,
"from": "string",
"blockConfirmations": 0,
"payload": "string",
"value": "string",
"readinessTimestamp": 0,
"resolvedPayload": "string",
"adapterParams": {
"version": "string",
"dstGasLimit": "string",
"dstNativeGasTransferAmount": "string",
"dstNativeGasTransferAddress": "string"
},
"options": {
"lzReceive": {
"gas": "string",
"value": "string"
},
"nativeDrop": [
{
"amount": "string",
"receiver": "string"
}
],
"compose": [
{
"index": 0,
"gas": "string",
"value": "string"
}
],
"ordered": false
}
},
"failedTx": [
"string"
]
},
"destination": {
"status": "string",
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"payloadStoredTx": "string",
"failedTx": [
"string"
]
},
"verification": {
"dvn": {
"dvns": {},
"status": "string"
},
"sealer": {
"tx": {
"txHash": "string",
"blockHash": "string",
"blockNumber": 0,
"blockTimestamp": 0
},
"failedTx": [
{
"txHash": "string",
"txError": "string"
}
],
"status": "string"
}
},
"guid": "string",
"config": {
"error": false,
"errorMessage": "string",
"dvnConfigError": false,
"receiveLibrary": "string",
"sendLibrary": "string",
"inboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"outboundConfig": {
"confirmations": 0,
"requiredDVNCount": 0,
"optionalDVNCount": 0,
"optionalDVNThreshold": 0,
"requiredDVNs": [
"string"
],
"requiredDVNNames": [
"string"
],
"optionalDVNs": [
"string"
],
"optionalDVNNames": [
"string"
],
"executor": "string"
},
"ulnSendVersion": "string",
"ulnReceiveVersion": "string"
},
"status": {
"name": "string",
"message": "string"
},
"created": "2025-05-27T19:20:54.364Z",
"updated": "2025-05-27T19:20:54.364Z"
}
],
"nextToken": "string"
}
GET/openapi

OpenAPI specs.
Response
{
"openapi": "3.0.3",
"info": {
"title": "Scan API",
"version": "1.0.0"
},
"servers": [
{
"url": "https://scan-testnet.layerzero-api.com/v1"
}
],
"paths": {}
}