Skip to main content
Public API v2 is available at https://api.nonce.app/public-api/v2. This guide uses a workspace API key and two read requests: discover a workspace, then list its farms.

​
Prepare an API key

In the Nonce app, select the target workspace and open Manage → API Keys. The API Keys view is visible to users with workspace.manage. Store the key in the server-side environment as NONCE_API_KEY; see Authentication and access for permissions and credential handling.

​
Select a workspace

A successful response contains success: true and a data array of accessible workspaces. Select an item by its id and assign that value to WORKSPACE_ID. The API requires the ID, not the workspace slug used in app URLs. ListWorkspaces is beta. Its response also includes access relations and effective permissions; the full definition is in the Reference.

​
List farms

data contains the farms accessible with the current credentials. An empty array is a valid result. If the current page is less than pagination.total_pages, increment page and request the next page. Use a farm’s id from this response as the farm_id in farm-scoped requests. Continue with List Miners or List Agents. Response fields and errors are covered in Requests and responses.