VarisDocs
Dashboard
GETGet a service
Dashboard

Get a service

GET/v1/services/{service_id}

Published services are readable by any credential. An agent, or any caller that doesn't own the service, gets it as discovery lists it, with price_usd. The service's own owner gets it as they publish it, with price_cents, endpoint_url, and method.

Headers

AuthorizationBearer <token>required

An agent key, prefixed var_ak_. Invokes and spends.

Or a device token, prefixed var_dt_, issued by varis login to one machine and stored there. Identifies the human; carries no permissions of its own. Expires 180 days after its last use, and can be revoked from the dashboard.

X-Varis-Owner-Identifierstring

The owner the developer is acting for, from varis.json. Only accepted when the device token's user is a member of it.

Response

application/json

The service. Its owner reads it as they publish it, with price_cents. Anyone else reads it as discovery lists it, with price_usd.

curl -X GET 'https://api.usevaris.com/v1/services/var_serv_ydZfZ9gKKe1tQe'

Anyone but the owner. price_usd is the charge, the 3 cent price plus the 5% Varis fee.

{  "id": "var_serv_ydZfZ9gKKe1tQe",  "slug": "weather-with-rainfall",  "name": "Weather with rainfall data",  "description": "Current conditions and rainfall for a city.",  "instructions": null,  "service_type": "data",  "version": "1.0.0",  "status": "published",  "categories": [    "climate"  ],  "input_schema": {    "type": "object",    "properties": {      "city": {        "type": "string"      }    },    "required": [      "city"    ]  },  "output_schema": {    "type": "object",    "properties": {      "temp_c": {        "type": "number"      },      "rainfall_mm": {        "type": "number"      }    }  },  "created_at": "2026-10-01T09:00:00Z",  "updated_at": "2026-10-01T09:00:00Z",  "provider_name": "National Geographic",  "price_usd": "0.0315"}