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

# Status and monitoring

> Track intent status through to settlement: GetIntent, GetIntentReceipt, WaitIntentReceipt, SearchIntents, and GetIntentHistory.

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](/cross-chain/api-reference/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

```typescript theme={null}
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

```typescript theme={null}
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

```typescript theme={null}
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

```typescript theme={null}
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

```typescript theme={null}
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);
});
```