> For the complete documentation index, see [llms.txt](https://doc.bittap.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.bittap.org/developer-guides/api-reference/queryaddrs.md).

# QueryAddrs

<mark style="color:green;">`POST`</mark> /api/query-addrs

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name        | Type   | Required | Description              |
| ----------- | ------ | -------- | ------------------------ |
| `wallet_id` | string | true     | The end user's wallet id |
| page\_num   | int    | false    | for paging, default 1    |
| page\_size  | int    | false    | for paging, default 10   |

**Request**

```json
{
  "wallet_id": "10e21d53-82d3-43d6-99bc-03ea6945d902",
  "page_num": 1,
  "page_size": 10
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "code": 0,
    "data": {
        "addrs": [
            {
                "encoded": "taprt1qqqsqqspqqzzpghdayflqgqyxwpvjl2lrtkz4grl7x7ulyecta3q33sx2r0fmv66qcss9q4sd6fp6xakequg3lglmq3wwgvk3gurf2rn84k2amktauxlejdupqssxm3aw02xv45tf8gue5xxgwmd2xjamwsjw6527ryckqg6cpkczy6lpgqusrp0dpshx6rdv95kcw309akkz6tvvfhhstn5v4ex66twv9kzumrfva58gmnfdenjuar0v3shjw35xsesnhlwrv",
                "asset_id": "ou3pE/AgBDOCyX1fGuwqoH/xvc+TOF9iCMYGUN6ds1o=",
                "asset_type": "NORMAL",
                "amount": 200,
                "group_key": null,
                "script_key": "AoKwbpIdG7bIOIj9H9gi5yGWijg0qHM9bK7uy+8N/Mm8",
                "internal_key": "A249c9RmVotJ0czQxkO21Rpd26EnaorwyYsBGsBtgRNf",
                "tapscript_sibling": null,
                "taproot_output_key": "5rAtRHYEsAw8QxMiqEadRd+/KGHLkzM3AgVlOo1ft1I=",
                "proof_courier_addr": "hashmail://mailbox.terminal.lightning.today:443",
                "asset_version": "ASSET_VERSION_V0"
            },
            {
                "encoded": "taprt1qqqsqqspqqzzpghdayflqgqyxwpvjl2lrtkz4grl7x7ulyecta3q33sx2r0fmv66qcssyvdn8h4das523j3066xewx5jxwpm4rzenvjy3h0l94upr56ruaprpqss9dej7u0fgll8yjs8pxzd4h6kp95nxsh66283z2l0n9nzhafefld6pgpl6qfvpshksctndpkkz6tv8ghj7mtpd9kxymmc9e6x2undd9hxzmpwd35kw6r5de5kueeww3hkgcte8g6rgvcuupn0m",
                "asset_id": "ou3pE/AgBDOCyX1fGuwqoH/xvc+TOF9iCMYGUN6ds1o=",
                "asset_type": "NORMAL",
                "amount": 300,
                "group_key": null,
                "script_key": "AjGzPerewoqMov1o2XGpIzg7qMWZskSN3/LXgR00PnQj",
                "internal_key": "Arcy9x6Uf+ckoHCYTa31YJaTNC+tKPESvvmWYr9TlP26",
                "tapscript_sibling": null,
                "taproot_output_key": "6VqagMVX988EoIZf0jl7kBvvOqIgCL+okJyifSUUTm8=",
                "proof_courier_addr": "hashmail://mailbox.terminal.lightning.today:443",
                "asset_version": "ASSET_VERSION_V0"
            }
        ]
    },
    "message": "",
    "traceid": "4dd6a268-81dd-47f0-a0db-68dc8fc97701"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}