# GET /v1/xrpl/mpt/{mpt_issuance_id}

MPT issuance: issuer, supply, scale, transfer fee and flags.

## Purpose

Reads one Multi-Purpose Token (MPT) issuance from the validated ledger with one `ledger_entry` call. Amounts are integer strings of base units, each with a `_display` value divided by 10^`asset_scale`: `maximum_amount` (`null` when the issuance sets none; the ledger then allows up to 9223372036854775807), `outstanding_amount`, and `locked_amount` (`null` when none is locked in escrow). `transfer_fee_pct` is the fee the issuer charges on transfers between holders, in percent. `flags` decodes the issuance flags; `transferable` is true when `can_transfer` is set and the issuance is not locked; `utilization` is `outstanding_amount / maximum_amount` (`null` without a maximum). `metadata_present` says whether the issuer set metadata; the metadata itself is not served. A missing issuance answers 404 `not-found`.

## When to use

Before accepting or sending an MPT: to check its issuer, decimal scale, supply against its maximum, transfer fee, and whether it can be transferred, locked, escrowed or clawed back.

## When not to use

To check whether one MPT payment between two accounts can succeed now (use `/v1/xrpl/payment-readiness` with the issuance id as `asset`), or for a trust-line token written `CODE.issuer` (use `/v1/xrpl/token/{asset}`).

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `mpt_issuance_id` | path | yes | MPT issuance id: the issuer's sequence followed by its account, 48 hexadecimal characters. | 48 hexadecimal characters, either case (read as upper case) | `05FA6AB8561E39FA605779B829BB5974E82B40AF173D6AF3` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/xrpl/mpt/05FA6AB8561E39FA605779B829BB5974E82B40AF173D6AF3"
```

## Response example (200)

```json
{
  "issuer": "r3iMKCiKqu522oRGQcAdyvwoRUaTn7s8fi",
  "asset_scale": 2,
  "maximum_amount": "121224557",
  "maximum_amount_display": "1212245.57",
  "outstanding_amount": "121224557",
  "outstanding_amount_display": "1212245.57",
  "locked_amount": null,
  "locked_amount_display": null,
  "transfer_fee_pct": "0",
  "flags": {
    "locked": true,
    "can_lock": true,
    "require_auth": true,
    "can_escrow": false,
    "can_trade": false,
    "can_transfer": false,
    "can_clawback": true
  },
  "utilization": "1",
  "transferable": false,
  "metadata_present": true,
  "meta": {
    "ledger_index": 108267439,
    "as_of": "2026-11-11T20:18:12.424Z",
    "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_mpt` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
