# GET /v1/xrpl/domain/{domain_id}/eligibility

Is this account a member of this XRPL permissioned domain, as its owner or through an accepted, unexpired credential?

## Purpose

Reads the PermissionedDomain `domain_id` from the validated ledger with one `ledger_entry` call. When `account` is its owner, the answer is `eligible` with `membership: "owner"` and nothing else is read. For any other account, each credential the domain accepts is read with `account` as its subject (one `ledger_entry` call each, in parallel), together with the latest validated ledger, whose close time decides expiry. Each row of `credentials` has a `status`: `missing` (the account holds no such credential), `expired` (its `Expiration` is before the validated ledger close time; one equal to the close time is still valid), `not_accepted` (the account has not accepted it), `valid`, or `unknown` (its read failed, or it has an `Expiration` and the close time could not be read). An expired credential is `expired` even when it is not accepted. `verdict` is `eligible` when any credential is `valid`, `unknown` when none is valid and any is `unknown`, else `not_eligible`; each `unknown` credential is named in `checks_failed` as `credential:<issuer>:<credential_type>`. `membership` is `owner`, `credential` or `null`, and `matched_credential` is the first `valid` credential in the domain's order, with `expires_at` (ISO 8601 UTC, `null` without an `Expiration`). Each found credential carries its `credential_id`, its ledger entry index, which `/v1/xrpl/payment-readiness` takes in `credentials`. `credential_type` is in ledger hex; `credential_type_ascii` is its text when every byte is printable ASCII, else `null`. A missing domain answers 404 `not-found`. An owner's answer reads only the domain entry and is fresh for 10 seconds; any other answer is fresh for 4 seconds, the policy of its latest-ledger read.

## When to use

Before trading in a permissioned order book (`/v1/xrpl/orderbook` or `/v1/xrpl/slippage` with `domain`): to check whether an account is a member of the domain, as its owner or through an accepted, unexpired credential, and which credential qualifies it.

## When not to use

To check whether one payment can succeed now (use `/v1/xrpl/payment-readiness`, whose `credentials` takes the `credential_id` values of this answer), or to read the permissioned order book itself (use `/v1/xrpl/orderbook` with `domain`).

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `domain_id` | path | yes | PermissionedDomain id: the ledger entry index of the domain. | 64 hexadecimal characters, either case (read as upper case) | `DBABFD44A80DB623522628550B270FA5E2A845341E137530728E2E3699181A4E` |
| `account` | query | yes | Account to check: the subject of the credentials the domain accepts. | Valid classic XRPL address (r..., checksum verified) | `rcKV6taNcBAi8GxudZnMdFUPcH3Ls5TAv` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/xrpl/domain/DBABFD44A80DB623522628550B270FA5E2A845341E137530728E2E3699181A4E/eligibility?account=rcKV6taNcBAi8GxudZnMdFUPcH3Ls5TAv"
```

## Response example (200)

```json
{
  "domain": {
    "owner": "rYntcpm74LSkXDi2WXnoUYQqmjA48Um9q",
    "accepted_credentials": [
      {
        "issuer": "rpKh5yG6saV3DUtVqGSJJFauxx1pD1EeZK",
        "credential_type": "444F50504C45525F5257415F4B5943",
        "credential_type_ascii": "DOPPLER_RWA_KYC"
      }
    ]
  },
  "verdict": "eligible",
  "membership": "credential",
  "matched_credential": {
    "issuer": "rpKh5yG6saV3DUtVqGSJJFauxx1pD1EeZK",
    "credential_type": "444F50504C45525F5257415F4B5943",
    "credential_id": "605BF93A3FE93E7A7C466FCE82821E3AFC5B022B228DBE34136DF88E0EDC8930",
    "expires_at": null
  },
  "credentials": [
    {
      "issuer": "rpKh5yG6saV3DUtVqGSJJFauxx1pD1EeZK",
      "credential_type": "444F50504C45525F5257415F4B5943",
      "status": "valid",
      "credential_id": "605BF93A3FE93E7A7C466FCE82821E3AFC5B022B228DBE34136DF88E0EDC8930"
    }
  ],
  "checks_failed": [],
  "meta": {
    "ledger_index": 108327393,
    "as_of": "2026-11-14T15:33:14.000Z",
    "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 4 seconds; on upstream failure the last good value is served for up to 60 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_domain_eligibility` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
