# GET /v1/xrpl/account/{address}/commitments

An account's escrows, payment channels and checks by direction, its deposit preauthorizations, tickets and owner reserve, and what blocks deleting it.

## Purpose

Aggregates what the account has committed on the validated ledger, without listing the objects. The route reads up to 3 pages of 400 of the account's ledger objects (`account_objects` with no type filter; the later pages on the ledger of the first one) and the account entry; when the account owns more, or a later page fails, `truncated` is `true` and the counts cover the pages read. Escrows, payment channels and checks are split by direction: `out` when the account is the source, `in` when it is the destination (an escrow to the account itself counts as `out` only). Escrows report `count`, `totals` per asset as `{asset, value}` (XRP in XRP, not drops; an MPT in base units; a 40-hex currency code also carries `currency_ascii`), `next_release_at` (the earliest `FinishAfter` not yet passed, conditional escrows included, ISO 8601 UTC), `finishable_now` (no `Condition`, the validated ledger close time strictly after `FinishAfter` and not after `CancelAfter`) and `cancelable_now` (the close time strictly after `CancelAfter`). Payment channels report `count`, `remaining_xrp` (`Amount` minus `Balance`, the XRP not yet paid out) and `closing_within_24h` (the earlier of `Expiration` and `CancelAfter` after the close time and at most 24 hours after it; an expired channel is not counted). Checks report `count`, `expired` (`Expiration` at or before the close time) and `expiring_within_24h` (after the close time and at most 24 hours after it). `deposit_preauths` counts the account's DepositPreauth entries `by_account` and `by_credentials`; `tickets` is the account's `TicketCount`, exact even when the scan is truncated; `owner_reserve_xrp` is `OwnerCount` times the live owner reserve increment. `deletion_blockers` counts per `account_objects` type (keys in alphabetical order, only the types present) the owned entries that block AccountDelete: every type except `offer`, `signer_list`, `ticket`, `deposit_preauth`, `nft_offer`, `did`, `oracle`, `credential` and `delegate`, which the ledger deletes with the account, so a trust line (`state`) or an NFT page (`nft_page`) counts, and so does a type the route does not recognize. `lower_bound` is `true` when `truncated`. A `total` of 0 alone does not make the account deletable: its sequence age, the number of objects it owns, the NFTs it minted, the fee and the destination's own rules also decide. The route reads the reserves only when the account owns objects, and the latest validated ledger only when an escrow, check or channel has a time field. Each failed read is named in `checks_failed` (`objects` for a later page, `account`, `reserves`, `ledger`) and leaves the fields that need it `null`; a failed `ledger` read leaves a time-based figure `null` only in a direction that holds an object with the time field that figure reads. An unknown account answers 404 `not-found`. An answer is fresh for 10 seconds, or 4 seconds when it reads the latest validated ledger, the policy of that read.

## When to use

Before deleting or winding down an account: to see which escrows can be finished or cancelled now, how much XRP is left in its payment channels, which checks expire soon, how much XRP its owned objects lock in reserve, and which owned entries block AccountDelete.

## When not to use

To list the open DEX offers and how funded each one is (use `/v1/xrpl/account/{address}/offers`) or the trust lines (use `/v1/xrpl/account/{address}/lines`); for the balance and owner count, use `/v1/xrpl/account/{address}/summary`.

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `address` | path | yes | Account whose commitments are aggregated. | Valid classic XRPL address: starts with `r`, 25 to 35 base58 characters, checksum verified | `rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/xrpl/account/rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6/commitments"
```

## Response example (200)

```json
{
  "address": "rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6",
  "escrows": {
    "out": {
      "count": 0,
      "totals": [],
      "next_release_at": null,
      "finishable_now": 0,
      "cancelable_now": 0
    },
    "in": {
      "count": 0,
      "totals": [],
      "next_release_at": null,
      "finishable_now": 0,
      "cancelable_now": 0
    }
  },
  "payment_channels": {
    "out": {
      "count": 0,
      "remaining_xrp": "0",
      "closing_within_24h": 0
    },
    "in": {
      "count": 0,
      "remaining_xrp": "0",
      "closing_within_24h": 0
    }
  },
  "checks": {
    "out": {
      "count": 0,
      "expiring_within_24h": 0,
      "expired": 0
    },
    "in": {
      "count": 0,
      "expiring_within_24h": 0,
      "expired": 0
    }
  },
  "deposit_preauths": {
    "by_account": 0,
    "by_credentials": 0
  },
  "tickets": 0,
  "owner_reserve_xrp": "10",
  "deletion_blockers": {
    "total": 32,
    "by_type": {
      "state": 32
    },
    "lower_bound": false
  },
  "truncated": false,
  "checks_failed": [],
  "meta": {
    "ledger_index": 108328294,
    "as_of": "2026-11-14T16:35:55.347Z",
    "age_seconds": 0,
    "cache": "miss",
    "stale": false
  }
}
```

## Errors

- 400 [invalid-parameters](https://api.criptonlabs.com/errors/invalid-parameters.md)
- 400 [bad-request](https://api.criptonlabs.com/errors/bad-request.md)
- 404 [not-found](https://api.criptonlabs.com/errors/not-found.md)
- 429 [rate-limited](https://api.criptonlabs.com/errors/rate-limited.md)
- 503 [upstream-unavailable](https://api.criptonlabs.com/errors/upstream-unavailable.md)

## Caching

Fresh for 10 seconds; on upstream failure the last good value is served for up to 120 seconds (`meta.stale` is `true`), then the service answers 503. See the [freshness guide](https://api.criptonlabs.com/docs/guides/freshness.md).

## Rate limit

Tier `expensive`. See the [rate-limits guide](https://api.criptonlabs.com/docs/guides/rate-limits.md).

## MCP tool

The MCP tool `xrpl_account_commitments` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
