Devices

What this computer's tasks cost this month

The device's own key (its own id only), its owner or root, and any account in the owner's tree (the owner's agents, by api-key). Anyone else gets 404. cost_usd and calls are the billed person's month across all their computers, against budget_usd; device_cost_usd and device_calls are this computer's share. Money is a decimal string.

get/api/v1/devices/{id}/model_usage

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/devices/{id}/model_usage
  • Auth: API key in header api-key

Path parameters

idstring required

Response

OK.

monthstring

The UTC calendar month the numbers cover.

cost_usdstring

What the person billed (the top of the device's owner tree) has used this month across ALL their computers, a decimal string. This is the number the allowance measures.

budget_usdstring

The person's monthly allowance (DEVICE_MODEL_BUDGET_USD, 20 unless the operator changed it).

callsinteger

The person's calls this month across all their computers.

device_cost_usdstring

This computer's share of cost_usd.

device_callsinteger

This computer's share of calls.

Example response

{
  "month": "2026-10"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.