# Try the REST API

> Send a read-only request, inspect the JSON response, and copy the cURL command.

Source: https://docs.iceroot.com/developers/rest-api/

Choose an endpoint, adjust its parameters, and send a request. Start with **Read explorer status** to check the service and its data mode.

This page has an interactive, read-only explorer API playground. For every endpoint, parameter and response schema, read the [OpenAPI specification](https://docs.iceroot.com/openapi/explorer.json) and the [Explorer API guide](https://docs.iceroot.com/developers/explorer-api/index.md). The documented service reads the live public lab devnet through one relay; this export includes no fetched response.

## Connect an API

Hosted docs use the configured public explorer API. When running these docs on localhost, the default is the [local explorer API](https://docs.iceroot.com/developers/explorer-api/index.md#run-the-api); start that service before sending a request. **Use local** selects it explicitly. The explorer reads the live public lab devnet. Responses report `meta.mode: "live"` and `meta.source: "node"`. It reflects one relay’s view, not a source of truth for exchanges or custody. The network has no value and may be reset. The sample badge appears only when a selected API explicitly reports `mode: "demo"`.

To query your own service, change **API base URL**. Choose **Custom GET request** for a path from that service’s API reference. The server must allow this documentation site’s origin through CORS.

Heartwood Core serves the reference’s block, node, peer, transaction and wallet routes under `/api`. The public lab devnet’s reference API node answers read-only requests at `http://2.31.30.179:6003/api`, for example `/api/blocks/last`. It allows about 100 requests per minute for each address and uses plain HTTP, so call it with cURL or from your own backend: a browser page served over HTTPS, including this playground, cannot call it. Your own relay serves the same routes on its local API port; see [Run a devnet node](https://docs.iceroot.com/network/run-a-node/index.md).
