# ledger_entry

[[Source]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/rpc/handlers/LedgerEntry.cpp)

The `ledger_entry` method returns a single ledger entry from the XRP Ledger in its raw format. See [ledger format](/docs/references/protocol/ledger-data/ledger-entry-types) for information on the different types of entries you can retrieve.

## Request Format

This method can retrieve data on various types of ledger entries. You must specify *exactly 1* type from the list below, and follow the standard [request format](/docs/references/http-websocket-apis/api-conventions/request-formatting). (For example, a WebSocket request always has the `command` field and optionally an `id` field, and a JSON-RPC request uses the `method` and `params` fields.)

Note
There is no commandline syntax for this method. You can use the [json method](/docs/references/http-websocket-apis/public-api-methods/utility-methods/json) to access this method from the commandline instead.

### General Fields

These fields are optional, but provide additional parameters when retrieving ledger entry data.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `binary` | Boolean | No | If `true`, return the requested ledger entry's contents as a hex string in the XRP Ledger's [binary format](/docs/references/protocol/binary-format). Otherwise, return data in JSON format. The default is `false`. Updated in: rippled 1.2.0 |
| `ledger_hash` | String | No | The unique hash of the ledger version to use. (See [Specifying Ledgers](/docs/references/protocol/data-types/basic-data-types#specifying-ledgers)) |
| `ledger_index` | String or Unsigned Integer | No | The [ledger index](/docs/references/protocol/data-types/basic-data-types#ledger-index) of the ledger to use, or a shortcut string (e.g. "validated" or "closed" or "current") to choose a ledger automatically. (See [Specifying Ledgers](/docs/references/protocol/data-types/basic-data-types#specifying-ledgers)) |
| `include_deleted` | Boolean | No | *(Clio servers only)* If set to *true* and the queried object has been deleted, return its complete data as it was prior to its deletion. If set to *false* or not provided, and the queried object has been deleted, return `objectNotFound` (current behavior). |


Caution
The `generator` and `ledger` parameters are deprecated and may be removed without further notice.

### Get Ledger Entry by ID



Retrieve any type of ledger entry by its unique ID.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `index` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of a single entry to retrieve from the ledger, as a 64-character (256-bit) hexadecimal string. |


WebSocket

```json
{
  "command": "ledger_entry",
  "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
            "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4", "ledger_index": "validated" }'
```

Tip
You can use this type of request to get any singleton ledger entry, if it exists in the ledger data, because its ID is always the same. For example:

- [`Amendments`](/docs/references/protocol/ledger-data/ledger-entry-types/amendments) - `7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4`
- [`FeeSettings`](/docs/references/protocol/ledger-data/ledger-entry-types/feesettings) - `4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651`
- [Recent History `LedgerHashes`](/docs/references/protocol/ledger-data/ledger-entry-types/ledgerhashes) - `B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B`
- [`NegativeUNL`](/docs/references/protocol/ledger-data/ledger-entry-types/negativeunl) - `2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244`


### Get AccountRoot Entry



Retrieve an [AccountRoot entry](/docs/references/protocol/ledger-data/ledger-entry-types/accountroot) by its address. This is roughly equivalent to the [account_info method](/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info).

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `account_root` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The classic address of the [AccountRoot entry](/docs/references/protocol/ledger-data/ledger-entry-types/accountroot) to retrieve. |


WebSocket

```json
{
  "id": "example_get_accountroot",
  "command": "ledger_entry",
  "account_root": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "account_root": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
            "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "ledger_index": "validated" }'
```

### Get Amendments Entry

Retrieve the [Amendments entry](/docs/references/protocol/ledger-data/ledger-entry-types/amendments), which contains a list of all enabled amendments on the network.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `amendments` | String | Yes | The `Amendments` entry. This value must be `7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4`. |


WebSocket

```json
{
  "id": "example_get_amendments",
  "command": "ledger_entry",
  "amendments": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "amendments": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "amendments": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4", "ledger_index": "validated" }'
```

### Get AMM Entry



AMM
Retrieve an Automated Market-Maker (AMM) object from the ledger. This is similar to [amm_info method](/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/amm_info), but the `ledger_entry` version returns only the ledger entry as stored.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `amm` | Object or String | Yes | The [AMM entry](/docs/references/protocol/ledger-data/ledger-entry-types/amm) to retrieve. If you specify a string, it must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the AMM, as hexadecimal. If you specify an object, it must contain `asset` and `asset2` sub-fields. |
| `amm.asset` | Object | No | One of the two assets in this AMM's pool, as a [currency object without an amount](/docs/references/protocol/data-types/currency-formats#specifying-without-amounts). |
| `amm.asset2` | Object | No | The other of the two assets in this AMM's pool, as a [currency object without an amount](/docs/references/protocol/data-types/currency-formats#specifying-without-amounts). |


WebSocket

```json
{
  "id": 3,
  "command": "ledger_entry",
  "amm": {
    "asset": {
      "currency": "XRP"
    },
    "asset2": {
      "currency" : "TST",
      "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
    }
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
          "amm": {
            "asset": {
              "currency": "XRP"
            },
            "asset2": {
              "currency" : "TST",
              "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
            }
          },
          "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "amm": { "asset": { "currency": "XRP" }, "asset2": { "currency" : "TST", "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd" } }, "ledger_index": "validated" }'
```

### Get Bridge Entry

XChainBridge
Retrieve a [Bridge entry](/docs/references/protocol/ledger-data/ledger-entry-types/bridge), which represents a single cross-chain bridge that connects the XRP Ledger with another blockchain.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `bridge` | Object | Yes | The `Bridge` entry to retrieve. |
| `bridge.IssuingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The door account on the issuing chain. |
| `bridge.IssuingChainIssue` | Object | Yes | The asset that is minted and burned on the issuing chain. |
| `bridge.LockingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The door account on the locking chain. |
| `bridge.LockingChainIssue` | Object | Yes | The asset that is locked and unlocked on the locking chain. |
| `bridge_account` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that submitted the `XChainCreateBridge` transaction on the blockchain. |


WebSocket

```json
{
  "id": "example_get_bridge",
  "command": "ledger_entry",
  "bridge_account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
  "bridge": {
    "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "IssuingChainIssue": {
      "currency": "XRP"
    },
    "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
    "LockingChainIssue": {
      "currency": "XRP"
    }
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [
    {
      "bridge_account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
      "bridge": {
        "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "IssuingChainIssue": {
          "currency": "XRP"
        },
        "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
        "LockingChainIssue": {
          "currency": "XRP"
        }
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "bridge_account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR", "bridge": { "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "IssuingChainIssue": { "currency": "XRP" }, "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR", "LockingChainIssue": { "currency": "XRP" } }, "ledger_index": "validated" }'
```

### Get Check Entry



Retrieve a [Check entry](/docs/references/protocol/ledger-data/ledger-entry-types/check), which is a potential payment that can be cashed by its recipient.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `check` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of a [Check entry](/docs/references/protocol/ledger-data/ledger-entry-types/check) to retrieve. |


WebSocket

```json
{
  "id": "example_get_check",
  "command": "ledger_entry",
  "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB", "ledger_index": "validated" }'
```

### Get Credential Entry

Retrieve a [Credential entry](/docs/references/protocol/ledger-data/ledger-entry-types/credential), which represents an attestation by one account about another account.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `credential` | Object or String | Yes | Specify the `Credential` to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the entry, as hexadecimal. If an object, requires `subject`, `issuer`, and `credential_type` sub-fields. |
| `credential.subject` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that is the subject of the credential. |
| `credential.issuer` | String -  [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that issued the credential. |
| `credential.credential_type` | String - Hexadecimal | Yes | The type of the credential, as issued. |


WebSocket

```json
{
  "id": "example_get_credential",
  "command": "ledger_entry",
  "credential": {
    "subject": "rNnsnWZCsakxyMz5GzFrbbMpUnSmiDeKTW",
    "issuer": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa",
    "credential_type": "746573742D63726564656E7469616C"
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "credential": {
      "subject": "rNnsnWZCsakxyMz5GzFrbbMpUnSmiDeKTW",
      "issuer": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa",
      "credential_type": "746573742D63726564656E7469616C"
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```bash
rippled json ledger_entry '{ "credential": {"subject": "rNnsnWZCsakxyMz5GzFrbbMpUnSmiDeKTW", "issuer": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa", "credential_type": "746573742D63726564656E7469616C"}, "ledger_index": "validated" }'
```

### Get DepositPreauth Entry



Retrieve a [DepositPreauth entry](/docs/references/protocol/ledger-data/ledger-entry-types/depositpreauth), which tracks preauthorization for payments to accounts requiring [Deposit Authorization](/docs/concepts/accounts/depositauth).

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `deposit_preauth` | Object or String | Yes | Specify the DepositPreauth to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the DepositPreauth entry, as hexadecimal. If an object, requires `owner` sub-field and either `authorized` or `authorize_credentials` sub-field. |
| `deposit_preauth.owner` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that provided the preauthorization. |
| `deposit_preauth.authorized` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The account that received the preauthorization. |
| `deposit_preauth.authorized_credentials` | Array | No | A set of credentials that received the preauthorization. |


Each member of the `deposit_preauth.authorized_credentials` array, if provided, must include the following nested fields:

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `issuer` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The address of the account that issued the credential. |
| `credential_type` | String - Hexadecimal | Yes | The type of the credential, as issued. |


WebSocket

```json
{
  "id": "example_get_deposit_preauth",
  "command": "ledger_entry",
  "deposit_preauth": {
    "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "deposit_preauth": {
      "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "deposit_preauth": { "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX" }, "ledger_index": "validated" }'
```

### Get DID Entry

Retrieve a [DID entry](/docs/references/protocol/ledger-data/ledger-entry-types/did), which holds references to, or data associated with, a single Decentralized Identifier.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `did` | String | Yes | The account that controls the DID. |


WebSocket

```json
{
  "id": "example_get_did",
  "command": "ledger_entry",
  "did": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "did": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "did": "rFtKiHYdvmAiVvxAr6U6TNjcPSrAeANQa", "ledger_index": "validated" }'
```

### Get DirectoryNode Entry



Retrieve a [DirectoryNode](/docs/references/protocol/ledger-data/ledger-entry-types/directorynode), which contains a list of other ledger objects. Can be provided as string (object ID of the Directory) or as an object.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `directory` | Object or String | Yes | The [DirectoryNode entry](/docs/references/protocol/ledger-data/ledger-entry-types/directorynode) to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the directory, as hexadecimal. If an object, requires either `dir_root` or `owner` as a sub-field, plus optionally a `sub_index` sub-field. |
| `directory.sub_index` | Unsigned Integer | No | If provided, jumps to a later "page" of the [DirectoryNode](/docs/references/protocol/ledger-data/ledger-entry-types/directorynode). |
| `directory.dir_root` | String | No | Unique index identifying the directory to retrieve, as a hex string. |
| `directory.owner` | String | No | Unique address of the account associated with this directory. |


WebSocket

```json
{
  "id": 3,
  "command": "ledger_entry",
  "directory": {
    "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "sub_index": 0
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "directory": {
              "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
              "sub_index": 0
            },
            "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "directory": { "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "sub_index": 0 }, "ledger_index": "validated" }'
```

### Get Escrow Entry



Retrieve an [Escrow entry](/docs/references/protocol/ledger-data/ledger-entry-types/escrow), which holds XRP until a specific time or condition is met. Can be provided as string (object ID of the Escrow) or as an object.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `escrow` | Object or String | Yes | The [Escrow entry](/docs/references/protocol/ledger-data/ledger-entry-types/escrow) to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the Escrow, as hexadecimal. If an object, requires `owner` and `seq` sub-fields. |
| `escrow.owner` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The owner (sender) of the Escrow object. |
| `escrow.seq` | Unsigned Integer | No | The [Sequence Number](/docs/references/protocol/data-types/basic-data-types#account-sequence) of the transaction that created the Escrow object. |


WebSocket

```json
{
  "id": "example_get_escrow",
  "command": "ledger_entry",
  "escrow": {
    "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK",
    "seq": 126
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "escrow": {
      "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK",
      "seq": 126
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "escrow": { "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK", "seq": 126 }, "ledger_index": "validated" }'
```

### Get FeeSettings Entry

Retrieve the [FeeSettings entry](/docs/references/protocol/ledger-data/ledger-entry-types/feesettings), which contains the current base [transaction cost](/docs/concepts/transactions/transaction-cost) and [reserves](/docs/concepts/accounts/reserves) determined by [fee voting](/docs/concepts/consensus-protocol/fee-voting).

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `fee` | String | Yes | The `FeeSettings` entry. This value must be `4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651`. |


WebSocket

```json
{
  "id": "example_get_feesettings",
  "command": "ledger_entry",
  "fee": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "fee": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "fee": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651", "ledger_index": "validated" }'
```

### Get LedgerHashes Entry

Retrieve the [LedgerHashes entry](/docs/references/protocol/ledger-data/ledger-entry-types/ledgerhashes), which contains a history of prior ledgers that led up to this ledger version, in the form of their hashes.

| Field | Type | Required | Description |
|  --- | --- | --- | --- |
| `hashes` | String | Yes | The `LedgerHashes` entry. This value must be `B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B`. |


WebSocket

```json
{
  "id": "example_get_ledgerhashes",
  "command": "ledger_entry",
  "hashes": "B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "hashes": "B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "hashes": "B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B", "ledger_index": "validated" }'
```

### Get Loan Entry

LendingProtocol
Retrieve a [Loan entry](/docs/references/protocol/ledger-data/ledger-entry-types/loan), which defines the state of an on-chain loan agreement between a Loan Broker and a Borrower.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `loan` | Object or String | Yes | Specify the `Loan` to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the `Loan`, as hexadecimal. If an object, requires `loan_broker_id` and `loan_seq` sub-fields. |
| `loan.loan_broker_id` | String | No | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the [LoanBroker](/docs/references/protocol/ledger-data/ledger-entry-types/loanbroker) that created the loan, as hexadecimal. |
| `loan.loan_seq` | Number | No | The sequence number of the loan. |


WebSocket

```json
{
  "id": "example_get_loan",
  "command": "ledger_entry",
  "loan": {
    "loan_broker_id": "7430D67254BAE93A8CAD43596D26BBDAAA5BCD2DB7D2FB6E81B302916E8BD48D",
    "loan_seq": 2
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
    "loan": {
      "loan_broker_id": "7430D67254BAE93A8CAD43596D26BBDAAA5BCD2DB7D2FB6E81B302916E8BD48D",
      "loan_seq": 2
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "loan": { "loan_broker_id": "7430D67254BAE93A8CAD43596D26BBDAAA5BCD2DB7D2FB6E81B302916E8BD48D", "loan_seq": 2 }, "ledger_index": "validated" }'
```

### Get LoanBroker Entry

LendingProtocol
Retrieve a [LoanBroker entry](/docs/references/protocol/ledger-data/ledger-entry-types/loanbroker), which defines the configuration and state of a lending protocol instance.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `loan_broker` | Object or String | Yes | Specify the `LoanBroker` to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the `LoanBroker`, as hexadecimal. If an object, requires `owner` and `seq` sub-fields. |
| `loan_broker.owner` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The account that controls the `LoanBroker`. |
| `loan_broker.seq` | Number | No | The [Sequence Number](/docs/references/protocol/data-types/basic-data-types#account-sequence) of the transaction that created the `LoanBroker`. |


WebSocket

```json
{
  "id": "example_get_loanbroker",
  "command": "ledger_entry",
  "loan_broker": {
    "owner": "rsgmF1wgf43LmqmU8MBJ2kzU2akkC1KCG8",
    "seq": 3213616
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
    "loan_broker": {
      "owner": "rsgmF1wgf43LmqmU8MBJ2kzU2akkC1KCG8",
      "seq": 3213616
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "loan_broker": { "owner": "rsgmF1wgf43LmqmU8MBJ2kzU2akkC1KCG8", "seq": 3213616 }, "ledger_index": "validated" }'
```

### Get MPToken Entry

MPTokensV1
Return an `MPToken` object.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `mptoken` | ️Object or String | Yes | Specify the [MPToken entry](/docs/references/protocol/ledger-data/ledger-entry-types/mptoken) to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the MPToken. If an object, requires the sub-fields `account` and `mpt_issuance_id` to uniquely identify the MPToken. |
| `mptoken.mpt_issuance_id` | String | No | The 192-bit MPTokenIssuanceID that's associated with the MPTokenIssuance. |
| `mptoken.account` ️ | String | No | The account that owns the MPToken. |


WebSocket

```json
{
    "id": "example_get_mpt",
    "command": "ledger_entry",
    "mptoken": {
      "mpt_issuance_id": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA",
      "account":"rsNw23ygZatXv7h8QVSgAE4jktY2uW1iZP"
    }
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "mptoken":{
                "mpt_issuance_id": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA",
                "account":"rsNw23ygZatXv7h8QVSgAE4jktY2uW1iZP"
            } 
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "mptoken": {"mpt_issuance_id": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA", "account":"rsNw23ygZatXv7h8QVSgAE4jktY2uW1iZP"} }'
```

### Get MPTokenIssuance Entry

MPTokensV1
Return an `MPTokenIssuance` object.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `mpt_issuance` | String | Yes | The 192-bit `MPTokenIssuanceID` that's associated with the MPTokenIssuance, as hexadecimal. |


WebSocket

```json
{
    "id": "example_get_mpt_issuance",
    "command": "ledger_entry",
    "mpt_issuance": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "mpt_issuance": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "mpt_issuance": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA", "ledger_index": "validated" }'
```

### Get NegativeUNL Entry

Retrieve the [NegativeUNL entry](/docs/references/protocol/ledger-data/ledger-entry-types/negativeunl), which contains the current status of the [Negative UNL](/docs/concepts/consensus-protocol/negative-unl). If no validators are currently disabled or scheduled to be disabled, there is no `NegativeUNL` entry.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `nunl` | String | Yes | The `NegativeUNL` entry. This value must be `2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244`. |


WebSocket

```json
{
  "id": "example_get_negativeunl",
  "command": "ledger_entry",
  "nunl": "2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "nunl": "2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "nunl": "2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244", "ledger_index": "validated" }'
```

### Get NFT Page

Return an NFT Page in its raw ledger format.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `nft_page` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of an [NFT Page](/docs/references/protocol/ledger-data/ledger-entry-types/nftokenpage) to retrieve. |


WebSocket

```json
{
    "id": "example_get_nft_page",
    "command": "ledger_entry",
    "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF", "ledger_index": "validated" }'
```

### Get NFTokenOffer Entry

Retrieve an [NFTokenOffer entry](/docs/references/protocol/ledger-data/ledger-entry-types/nftokenoffer), which represents an offer to buy, sell, or transfer an [NFT](/docs/references/protocol/data-types/nftoken).

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `nft_offer` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of an NFT offer to retrieve. |


WebSocket

```json
{
    "id": "example_get_nftokenoffer",
    "command": "ledger_entry",
    "nft_offer": "6C4FC85B1F64FF2E30C3F657E41E373E5C1AC007A6B4F936C43B2F38BD8FFC14",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "nft_offer": "6C4FC85B1F64FF2E30C3F657E41E373E5C1AC007A6B4F936C43B2F38BD8FFC14",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "nft_offer": "6C4FC85B1F64FF2E30C3F657E41E373E5C1AC007A6B4F936C43B2F38BD8FFC14", "ledger_index": "validated" }'
```

### Get Offer Entry



Retrieve an [Offer entry](/docs/references/protocol/ledger-data/ledger-entry-types/offer), which defines an offer to exchange currency. Can be provided as string (unique index of the Offer) or as an object.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `offer` | Object or String | Yes | If a string, interpret as [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the Offer to retrieve. If an object, requires the sub-fields `account` and `seq` to uniquely identify the offer. |
| `offer.account` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The account that placed the offer. |
| `offer.seq` | Unsigned Integer | No | The [Sequence Number](/docs/references/protocol/data-types/basic-data-types#account-sequence) of the transaction that created the Offer entry. |


WebSocket

```json
{
  "id": "example_get_offer",
  "command": "ledger_entry",
  "offer": {
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "seq": 359
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [
    {
      "offer": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "seq": 359
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "offer": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "seq": 359}, "ledger_index": "validated" }'
```

### Get Oracle Entry



PriceOracle
Retrieve an [Oracle entry](/docs/references/protocol/ledger-data/ledger-entry-types/oracle), which represents a single price oracle that can store token prices.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `oracle` | Object | Yes | The oracle identifier. |
| `oracle.account` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that controls the `Oracle` object. |
| `oracle.oracle_document_id` | Number | Yes | A unique identifier of the price oracle for the `Account` |


WebSocket

```json
{
  "id": "example_get_oracle",
  "command": "ledger_entry",
  "oracle" : {
    "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
    "oracle_document_id":  34
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [
    {
      "oracle" : {
        "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
        "oracle_document_id":  34
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "oracle": { "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds", "oracle_document_id": 34 }, "ledger_index": "validated" }'
```

### Get PayChannel Entry



Retrieve a [PayChannel entry](/docs/references/protocol/ledger-data/ledger-entry-types/paychannel), which holds XRP for asynchronous payments.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `payment_channel` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the `PayChannel` to retrieve. |


WebSocket

```json
{
  "id": "example_get_paychannel",
  "command": "ledger_entry",
  "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7", "ledger_index": "validated" }'
```

### Get PermissionedDomain Entry

PermissionedDomains
Retrieve a [PermissionedDomain entry](/docs/references/protocol/ledger-data/ledger-entry-types/permissioneddomain), which describes a single [permissioned domain](/docs/concepts/tokens/decentralized-exchange/permissioned-domains) instance.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `permissioned_domain` | Object or String | Yes | Specify the `PermissionedDomain` to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the entry, as hexadecimal. If an object, requires `account` and `seq` sub-fields. |
| `permissioned_domain.account` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | Yes | The account that owns the `PermissionedDomain`. |
| `permissioned_domain.seq` | Number | Yes | The sequence number of the transaction that created the `PermissionedDomain`. |


WebSocket

```json
{
  "id": "example_get_permissioneddomain",
  "command": "ledger_entry",
  "permissioned_domain": {
    "account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
    "seq": 2093655
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "permissioned_domain": {
      "account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
      "seq": 2093655
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```bash
rippled json ledger_entry '{ "permissioned_domain": { "account": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR", "seq": 2093655 }, "ledger_index": "validated" }'
```

### Get RippleState Entry



Retrieve a [RippleState entry](/docs/references/protocol/ledger-data/ledger-entry-types/ripplestate), which tracks a (non-XRP) currency balance between two accounts.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `state` | Object | No | Alias to `ripple_state`. |
| `ripple_state` | Object | Yes | Object specifying the RippleState (trust line) object to retrieve. The `accounts` and `currency` sub-fields are required to uniquely specify the RippleState entry to retrieve. |
| `ripple_state.accounts` | Array | Yes | 2-length array of account [Address](/docs/references/protocol/data-types/basic-data-types#addresses)es, defining the two accounts linked by this RippleState entry. |
| `ripple_state.currency` | String | Yes | [Currency Code](/docs/references/protocol/data-types/currency-formats#currency-codes) of the RippleState entry to retrieve. |


WebSocket

```json
{
  "id": "example_get_ripplestate",
  "command": "ledger_entry",
  "ripple_state": {
    "accounts": [
      "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"
    ],
    "currency": "USD"
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "ripple_state": {
      "accounts": [
        "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"
      ],
      "currency": "USD"
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "ripple_state": { "accounts": ["rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"], "currency": "USD"}, "ledger_index": "validated" }'
```

### Get SignerList Entry

Retrieve a [SignerList entry](/docs/references/protocol/ledger-data/ledger-entry-types/signerlist), which contains a list of accounts that, as a group, are authorized to sign a transaction in place of an individual account by multi-signing.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `signer_list` | String | Yes | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the `SignerList`. |


WebSocket

```json
{
  "id": "example_get_signerlist",
  "command": "ledger_entry",
  "signer_list": "A9C28A28B85CD533217F5C0A0C7767666B093FA58A0F2D80026FCC4CD932DDC7",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [{
      "signer_list": "A9C28A28B85CD533217F5C0A0C7767666B093FA58A0F2D80026FCC4CD932DDC7",
      "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "signer_list": "A9C28A28B85CD533217F5C0A0C7767666B093FA58A0F2D80026FCC4CD932DDC7", "ledger_index": "validated" }'
```

### Get Ticket Entry



TicketBatch
Retrieve a [Ticket entry](/docs/references/protocol/ledger-data/ledger-entry-types/ticket), which represents a [sequence number](/docs/references/protocol/data-types/basic-data-types#account-sequence) set aside for future use.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `ticket` | Object or String | Yes | The `Ticket` to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of the `Ticket`, as hexadecimal. If an object, the `account` and `ticket_seq` sub-fields are required to uniquely specify the Ticket entry. |
| `ticket.account` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The owner of the Ticket. |
| `ticket.ticket_seq` | Number | No | The Ticket Sequence number of the Ticket to retrieve. |


WebSocket

```json
{
  "id": "example_get_ticket",
  "command": "ledger_entry",
  "ticket": {
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "ticket_seq": 389
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "ticket": {
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "ticket_seq": 389
    },
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "ticket": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "ticket_seq: 389 }, "ledger_index": "validated" }'
```

### Get XChainOwnedClaimID Entry

XChainBridge
Retrieve an [XChainOwnedClaimID entry](/docs/references/protocol/ledger-data/ledger-entry-types/xchainownedclaimid), which represents one transfer of value between blockchains.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `xchain_owned_claim_id` | Object or String | Yes | The `XChainOwnedClaimID` entry to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id), as hexadecimal. If an object, requires `IssuingChainDoor`, `IssuingChainIssue`, `LockingChainDoor`, `LockingChainIssue`, and `xchain_owned_claim_id` sub-fields. |
| `xchain_owned_claim_id.IssuingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The door account on the issuing chain. |
| `xchain_owned_claim_id.IssuingChainIssue` | Object | No | The asset that is minted and burned on the issuing chain. |
| `xchain_owned_claim_id.LockingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The door account on the locking chain. |
| `xchain_owned_claim_id.LockingChainIssue` | Object | No | The asset that is locked and unlocked on the locking chain. |
| `xchain_owned_claim_id.xchain_owned_claim_id` | Number | No | The `XChainClaimID` number that identifies this specific claim. |


WebSocket

```json
{
  "id": "example_get_xchainownedclaimid",
  "command": "ledger_entry",
  "xchain_owned_claim_id": {
    "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "IssuingChainIssue": {
      "currency": "XRP"
    },
    "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
    "LockingChainIssue": {
      "currency": "XRP"
    },
    "xchain_owned_claim_id": 1
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [
    {
      "xchain_owned_claim_id": {
        "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "IssuingChainIssue": {
          "currency": "XRP"
        },
        "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
        "LockingChainIssue": {
          "currency": "XRP"
        },
        "xchain_owned_claim_id": 1
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "xchain_owned_claim_id": { "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "IssuingChainIssue": { "currency": "XRP" }, "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR", "LockingChainIssue": { "currency": "XRP" }, "xchain_owned_claim_id": 1 }, "ledger_index": "validated" }'
```

### Get XChainOwnedCreateAccountClaimID Entry

XChainBridge
Retrieve an [XChainOwnedCreateAccountClaimID entry](/docs/references/protocol/ledger-data/ledger-entry-types/xchainownedcreateaccountclaimid), which collects attestations for creating an account via a cross-chain transfer.

| Field | Type | Required? | Description |
|  --- | --- | --- | --- |
| `xchain_owned_create_account_claim_id` | Object or String | Yes | The `XChainOwnedCreateAccountClaimID` entry to retrieve. If a string, must be the [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id), as hexadecimal. If an object, requires `IssuingChainDoor`, `IssuingChainIssue`, `LockingChainDoor`, `LockingChainIssue`, and `xchain_owned_create_account_claim_id` sub-fields. |
| `xchain_owned_create_account_claim_id.IssuingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The door account on the issuing chain. |
| `xchain_owned_create_account_claim_id.IssuingChainIssue` | Object | No | The asset that is minted and burned on the issuing chain. |
| `xchain_owned_create_account_claim_id.LockingChainDoor` | String - [Address](/docs/references/protocol/data-types/basic-data-types#addresses) | No | The door account on the locking chain. |
| `xchain_owned_create_account_claim_id.LockingChainIssue` | Object | No | The asset that is locked and unlocked on the locking chain. |
| `xchain_owned_create_account_claim_id.xchain_owned_create_account_claim_id` | Number | No | The `XChainAccountCreateCount` number that identifies this specific account creation claim. |


WebSocket

```json
{
  "id": "example_get_xchainownedcreateaccountclaimid",
  "command": "ledger_entry",
  "xchain_owned_create_account_claim_id": {
    "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "IssuingChainIssue": {
      "currency": "XRP"
    },
    "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
    "LockingChainIssue": {
      "currency": "XRP"
    },
    "xchain_owned_create_account_claim_id": 1
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [
    {
      "xchain_owned_create_account_claim_id": {
        "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "IssuingChainIssue": {
          "currency": "XRP"
        },
        "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR",
        "LockingChainIssue": {
          "currency": "XRP"
        },
        "xchain_owned_create_account_claim_id": 1
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "xchain_owned_create_account_claim_id": { "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "IssuingChainIssue": { "currency": "XRP" }, "LockingChainDoor": "rf7zCh1aPD2DpeJVo6keG5Cf1TVyAKMFpR", "LockingChainIssue": { "currency": "XRP" }, "xchain_owned_create_account_claim_id": 1 }, "ledger_index": "validated" }'
```

### Get Vault Entry

Retrieve a `Vault` entry from the ledger. This is similar to the [vault_info method](/docs/references/http-websocket-apis/public-api-methods/vault-methods/vault_info), but the `ledger_entry` version doesn't return information about vault shares.

SingleAssetVault
| Field | Type | Description |
|  --- | --- | --- |
| `vault` | String | The [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) of a [Vault](/docs/references/protocol/ledger-data/ledger-entry-types/vault) object to retrieve. |


WebSocket

```json
{
    "id": "example_get_vault",
    "command": "ledger_entry",
    "vault": "9E48171960CD9F62C3A7B6559315A510AE544C3F51E02947B5D4DAC8AA66C3BA",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "vault": "9E48171960CD9F62C3A7B6559315A510AE544C3F51E02947B5D4DAC8AA66C3BA",
            "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "vault": "9E48171960CD9F62C3A7B6559315A510AE544C3F51E02947B5D4DAC8AA66C3BA", "ledger_index": "validated" }'
```

## Response Format

The response follows the [standard format](/docs/references/http-websocket-apis/api-conventions/response-formatting), with a successful result containing the following fields:

| Field | Type | Description |
|  --- | --- | --- |
| `index` | String | The unique ID of this [ledger entry](/docs/references/protocol/ledger-data/ledger-entry-types). |
| `ledger_index` | Unsigned Integer | The [ledger index](/docs/references/protocol/data-types/basic-data-types#ledger-index) of the ledger that was used when retrieving this data. |
| `node` | Object | *(Omitted if `"binary": true` specified.)* Object containing the data of this ledger entry, according to the [ledger format](/docs/references/protocol/ledger-data/ledger-entry-types). |
| `node_binary` | String | *(Omitted unless `"binary":true` specified)* The [binary representation](/docs/references/protocol/binary-format) of the ledger object, as hexadecimal. |
| `deleted_ledger_index` | String | *(Clio server only, returned if `include_deleted` parameter is set.)* The [ledger index](/docs/references/protocol/data-types/basic-data-types#ledger-index) where the ledger entry object was deleted. |


An example of a successful response:

WebSocket

```json
{
  "id": "example_get_accountroot",
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "31850E8E48E76D1064651DF39DF4E9542E8C90A9A9B629F4DE339EB3FA74F726",
    "ledger_index": 61966146,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "validated": true
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
200 OK

{
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
    "ledger_index": 61966165,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "status": "success",
    "validated": true
  }
}
```

Commandline

```json
{
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
    "ledger_index": 61966165,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "status": "success",
    "validated": true
  }
}
```

## Possible Errors

* Any of the [universal error types](/docs/references/http-websocket-apis/api-conventions/error-formatting#universal-errors).
* `deprecatedFeature` - The request specified a removed field, such as `generator`.
* `entryNotFound` - The requested ledger entry does not exist in the ledger.
* `invalidParams` [API v2](/docs/references/http-websocket-apis#api-versioning)
  - The fields provided in the request did not match any of the expected request formats.
  - The request specified more than one ledger entry. New in: rippled 3.0.0
* `lgrNotFound` - The ledger specified by the `ledger_hash` or `ledger_index` does not exist, or it does exist but the server does not have it.
* `malformedAddress` - The request improperly specified an [Address](/docs/references/protocol/data-types/basic-data-types#addresses) field.
* `malformedCurrency` - The request improperly specified a [Currency Code](/docs/references/protocol/data-types/currency-formats#currency-codes) field.
* `malformedDocumentID` - The request improperly specified the `oracle.oracle_document_id` sub-field.
* `malformedOwner` - The request improperly specified the `escrow.owner` sub-field.
* `malformedRequest` - The request provided an invalid combination of fields, or provided the wrong type for one or more fields.
* `unexpectedLedgerType` - The request specified a query parameter, but provided a [ledger entry ID](/docs/references/protocol/ledger-data/common-fields#ledger-entry-id) that doesn't match the expected ledger entry type.
* `unknownOption` [API v1](/docs/references/http-websocket-apis#api-versioning) - The fields provided in the request did not match any of the expected request formats.