> For the complete documentation index, see [llms.txt](https://api.pirichain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.pirichain.com/utility.md).

# Utility

All commands are listed below and detailed on their own section.

## Search for transactions, addresses or tokens

> This endpoint searches for one of the following with the given "value" parameter in the PIRI network:\
> \- Token\
> \- Address\
> \- Transaction

```json
{"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/search":{"post":{"tags":["Utility"],"summary":"Search for transactions, addresses or tokens","description":"This endpoint searches for one of the following with the given \"value\" parameter in the PIRI network:\n- Token\n- Address\n- Transaction","operationId":"Search","requestBody":{"content":{"application/x-www-form-urlencoded":{"encoding":{},"schema":{"required":["value"],"type":"object","properties":{"value":{"type":"string","description":"Search content | Address, Token Name, Transaction ID"}}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json; charset=utf-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/search"}}}}}},"deprecated":false}}},"components":{"schemas":{"search":{"title":"search","required":["type","data"],"type":"object","properties":{"type":{"type":"string"},"data":{"$ref":"#/components/schemas/TokenInfo"}}},"TokenInfo":{"title":"TokenInfo","required":["_id","tokenSymbol","tokenName","logo","assetID"],"type":"object","properties":{"_id":{"type":"string"},"tokenSymbol":{"type":"string"},"tokenName":{"type":"string"},"logo":{"type":"string"},"assetID":{"type":"integer","format":"int32"}}}}}}
```

## Get test PIRI tokens

> Get test PIRI tokens for development purposes. This endpoint is typically used on testnet environments for testing purposes.

```json
{"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/givemePiri":{"post":{"tags":["Utility"],"summary":"Get test PIRI tokens","description":"Get test PIRI tokens for development purposes. This endpoint is typically used on testnet environments for testing purposes.","operationId":"givemePiri","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"PIRI address to receive test tokens"}}}}}},"responses":{"200":{"description":"Test PIRI sent successfully","content":{"application/json; charset=utf-8":{"schema":{"$ref":"#/components/schemas/givemePiri"}}}}},"deprecated":false}}},"components":{"schemas":{"givemePiri":{"title":"givemePiri","type":"object","properties":{"error":{"type":"integer","format":"int32","description":"Error code, 0 for success"},"message":{"type":"string","description":"Response message indicating the result"},"txHash":{"type":"string","description":"Transaction hash of the test PIRI transfer"}}}}}}
```

## Reload network configuration settings

> This endpoint allows reloading of network configuration settings on the blockchain network. By providing the hanOwnerSHA3 parameter (which is the SHA3 hash obtained during the blockchain network setup), the network settings can be reloaded and refreshed.

```json
{"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/reloadSetting":{"post":{"tags":["Utility"],"summary":"Reload network configuration settings","description":"This endpoint allows reloading of network configuration settings on the blockchain network. By providing the hanOwnerSHA3 parameter (which is the SHA3 hash obtained during the blockchain network setup), the network settings can be reloaded and refreshed.","operationId":"reloadSetting","requestBody":{"required":false,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"hanOwnerSHA3":{"type":"string","description":"SHA3 hash obtained during blockchain network setup, required for authentication to reload network settings"}}}}}},"responses":{"200":{"description":"Response from reload settings operation","content":{"application/json; charset=utf-8":{"schema":{"$ref":"#/components/schemas/reloadSetting"}}}}},"deprecated":false}}},"components":{"schemas":{"reloadSetting":{"title":"reloadSetting","type":"object","required":["error"],"properties":{"error":{"type":"integer","format":"int32","description":"Error code: 0 for success, 1 for failure","enum":[0,1]},"data":{"type":"string","description":"Error message when operation fails (only present when error is 1)"}}}}}}
```