Status and monitoring

Use these endpoints to track the state of an intent after execution and to query historical payment data. For authentication and base URL, see the API overview.

GetIntent

Retrieve the current status and full details of an intent. Endpoint: POST /GetIntent

Request parameters

Field	Type	Required	Description
`intentId`	string	Yes	The intent ID to look up

Response fields

Field	Description
`intent`	The full intent object including current `status`
`intent.status`	One of `QUOTED`, `COMMITTED`, `EXECUTING`, `SUCCEEDED`, or `FAILED`

Example

const { intent } = await trails.getIntent({ intentId });

console.log("Status:", intent.status);

GetIntentReceipt

Get the transaction hashes and settlement status for a completed intent. Use this to confirm that funds arrived at the destination. Endpoint: POST /GetIntentReceipt

Request parameters

Field	Type	Required	Description
`intentId`	string	Yes	The intent ID to retrieve the receipt for

Response fields

Field	Description
`status`	`SUCCEEDED` or `FAILED`
`transactionHash`	Transaction hash on the destination network
`originTransactionHash`	Transaction hash on the source network

Example

const receipt = await trails.getIntentReceipt({ intentId });

if (receipt.status === "SUCCEEDED") {
  console.log("Settled on destination:", receipt.transactionHash);
  console.log("Source transaction:", receipt.originTransactionHash);
}

WaitIntentReceipt

Long-poll until an intent reaches a terminal state (SUCCEEDED or FAILED). The API holds the connection open and responds as soon as the intent settles. Endpoint: POST /WaitIntentReceipt

Request parameters

Field	Type	Required	Description
`intentId`	string	Yes	The intent ID to wait on

Response fields

Field	Description
`intentReceipt`	The receipt object, same structure as `GetIntentReceipt`
`done`	`true` when a terminal state has been reached

Use WaitIntentReceipt when you want to block until settlement, for example in a server-side payout flow where the next step depends on confirmed settlement. Use GetIntentReceipt polling when you need to check status periodically without holding a connection open.

Example

const { intentReceipt, done } = await trails.waitIntentReceipt({ intentId });

if (done && intentReceipt.status === "SUCCEEDED") {
  // Funds have settled; continue with your post-settlement logic
  console.log("Settlement confirmed:", intentReceipt.transactionHash);
}

SearchIntents

Find intents by owner address or transaction hash. Useful for looking up an intent when you have the source transaction hash but not the intent ID. Endpoint: POST /SearchIntents

Request parameters

Field	Type	Required	Description
`ownerAddress`	string	No	Filter by the customer’s wallet address
`transactionHash`	string	No	Filter by a source or destination transaction hash
`page`	number	No	Page number for pagination; starts at 1
`pageSize`	number	No	Number of results per page

At least one of ownerAddress or transactionHash is required.

Response fields

Field	Description
`intents`	Array of intent objects matching the query

Example

const { intents } = await trails.searchIntents({
  ownerAddress: "0xCUSTOMER_ADDRESS",
  page: 1,
  pageSize: 20,
});

intents.forEach((intent) => {
  console.log(intent.intentId, intent.status);
});

GetIntentHistory

Retrieve paginated intent history with receipts for a given address. Returns settled and in-progress intents together with their receipt data where available. Endpoint: POST /GetIntentHistory

Request parameters

Field	Type	Required	Description
`ownerAddress`	string	Yes	The customer’s wallet address
`page`	number	No	Page number; starts at 1
`pageSize`	number	No	Number of results per page

Example

const history = await trails.getIntentHistory({
  ownerAddress: "0xCUSTOMER_ADDRESS",
  page: 1,
  pageSize: 50,
});

history.intents.forEach((entry) => {
  console.log(entry.intent.intentId, entry.intent.status, entry.receipt?.transactionHash);
});

Cross-chain

SDK

Trails API Reference

GetIntent

Request parameters

Response fields

Example

GetIntentReceipt

Request parameters

Response fields

Example

WaitIntentReceipt

Request parameters

Response fields

Example

SearchIntents

Request parameters

Response fields

Example

GetIntentHistory

Request parameters

Example

​GetIntent

​Request parameters

​Response fields

​Example

​GetIntentReceipt

​Request parameters

​Response fields

​Example

​WaitIntentReceipt

​Request parameters

​Response fields

​Example

​SearchIntents

​Request parameters

​Response fields

​Example

​GetIntentHistory

​Request parameters

​Example

GetIntent

Request parameters

Response fields

Example

GetIntentReceipt

Request parameters

Response fields

Example

WaitIntentReceipt

Request parameters

Response fields

Example

SearchIntents

Request parameters

Response fields

Example

GetIntentHistory

Request parameters

Example