> For the complete documentation index, see [llms.txt](https://bewinxed.gitbook.io/radar-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bewinxed.gitbook.io/radar-docs/api_documentation/docs/nft/royalty_status_address.md).

# Royalties Status by Address 💰 - /nft/royalty\_status\_address/{address}

## 🔍 Endpoint Summary

This endpoint retrieves the royalty status for a given address. It returns a dictionary containing the address and the royalty status for that address.

## 📝 API Path Parameters

| Parameter | Type | Description                                     |
| --------- | ---- | ----------------------------------------------- |
| address   | str  | The address to retrieve the royalty status for. |

## 💾 Response

The response is a dictionary containing the following information:

```
{
    "address": "abcdefg",
    "royalty_status": {
        "total_royalties_owed": 1000,
        "transactions": [
            {
                "tx_id": "abcdefg",
                "timestamp": "2022-01-01T00:00:00Z",
                "amount": 100
            },
            ...
        ]
    }
}
```

## 🔨 Example Usage

```python
import requests

address = "abcdefg"

response = requests.get(f"https://api.example.com/nft/royalty_status_address/{address}")

print(response.json())
```

## 📈 Possible Use Cases

* Retrieving the current royalty status for a specific address to ensure that all owed royalties have been paid.
* Displaying the current royalty status for a specific address on a marketplace or portfolio website.
* Keeping track of the total amount of royalties owed for a specific address over time.