---
title: "MPT issuance risk view — issuer powers + issuer trust (free, live)"
method: GET
path: "/api/mpt/{issuanceId}"
tags: ["Tokens"]
---

# MPT issuance risk view — issuer powers + issuer trust (free, live)

`GET /api/mpt/{issuanceId}`

## Request

- Base URL: `https://www.xrplhub.io`
- URL: `https://www.xrplhub.io/api/mpt/{issuanceId}`
- Auth: none required

The risk view of one Multi-Purpose Token (XLS-33) issuance, not a listing. Returns what the issuer can do to a holder (clawback, freeze, require-auth, whether it's transferable at all) alongside the issuer's own XRPLScore, account age, verified domain and credentials held. Live reads from the validated ledger only. An issuance not found returns "unknown", never "does not exist". Free, no signup.

## Path parameters

- `issuanceId` string, required

## Response `200`

The issuance risk view.

- object
  - `issuanceId` string
  - `found` boolean
  - `source` object
    - `ledger` string
    - `interpretation` string: 'exists' or 'unknown'.
  - `issuer` string, nullable
  - `issuance` object, nullable
    - `assetScale` integer
    - `maximumAmount` string, nullable
    - `outstandingAmount` string
    - `transferFeeBps` number
    - `metadata` unknown
  - `issuerPowers` object, nullable
    - `clawback` boolean
    - `canFreeze` boolean
    - `currentlyFrozen` boolean
    - `requiresAuth` boolean
    - `transferable` boolean
  - `issuerRisk` object, nullable
    - `xrplScore` integer, nullable
    - `grade` string, nullable
    - `accountAgeDays` integer, nullable
    - `blackholed` boolean
    - `domain` string, nullable
    - `domainVerified` boolean: Two-way check: the account's own Domain field, AND that domain's xrp-ledger.toml lists this exact account under [[ACCOUNTS]].
    - `domainVerifiedReason` string: why (or why not) verified — which direction failed, HTTP status, or the confirming toml URL.
    - `credentialsHeld` integer
    - `credentials` object[]

## Other responses

- `400`: issuanceId is not 48 hex characters.

---

[API](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions.md) · [All operations](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/llms.txt) · [OpenAPI document](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/revisions/a5d4e13aff32?raw)