> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# account_nfts

Returns a list of NFToken objects owned by the specified account.

This method will use `40` [Compute Units](/nodeapi/about/billing).

***

## Reference: [Here](https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/account-methods/account_nfts)

## **Parameters**

* `account` (string, required) The address of the account. The request returns a list of NFTs owned by this account.
* `ledger_hash` (string, optional) The unique hash of the ledger version to use.
* `ledger_index` (number or string, optional) The ledger index of the ledger to use, or a shortcut string such as `validated`, `closed` or `current`.
* `limit` (integer, optional) Limit the number of token pages to retrieve. Each page can contain up to 32 NFTs. Cannot be lower than 20 or more than 400. The default is 100.
* `marker` (marker, optional) Value from a previous paginated response. Resume retrieving data where that response left off.

## Returns

* `account` (string) The account that owns the list of NFTs.
* `account_nfts` (array) A list of NFTs owned by the account. Each NFT object has `Flags`, `Issuer`, `NFTokenID`, `NFTokenTaxon`, `URI`, `nft_serial` and, if set, `TransferFee`.
* `ledger_hash` (string) The identifying hash of the ledger used to generate this response.
* `ledger_index` (number) The ledger index of the ledger used to generate this response.
* `ledger_current_index` (number) The ledger index of the current in-progress ledger, if used.
* `validated` (boolean) If `true`, the information comes from a validated ledger version.
* `marker` (marker) Server-defined value indicating the response is paginated. Omitted when there are no additional pages.

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// Result
{
  "result": {
    "ledger_hash": "6956776EA47C5A8F6253D5FD540C5982071E05928C52AC4F8DDF36A95F7BD20E",
    "ledger_index": 107293004,
    "validated": true,
    "account": "rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro",
    "account_nfts": [
      {
        "NFTokenID": "00081B58618112438BDB92AB281F76CBAFA853CCC0F7BC6079AB5DD6064E6D37",
        "URI": "697066733A2F2F6261667962656962743667746E...",
        "Flags": 8,
        "Issuer": "r9tZweDCL294wC6gVSunNKQTQMTXcYHzvj",
        "NFTokenTaxon": 4,
        "nft_serial": 105803063,
        "TransferFee": 7000
      },
      // ...
    ],
    "limit": 20,
    "status": "success"
  }
}
```

<CodeGroup>
  ```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
      -X POST \
      -H "Content-Type: application/json" \
      -d '{"method":"account_nfts","params":[{"account":"rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro","ledger_index":"validated","limit":20}]}'
  ```
</CodeGroup>

Over WebSocket, send `{"id":1,"command":"account_nfts","account":"rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro","ledger_index":"validated","limit":20}` to `wss://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE>`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.