Decisions

Agent decisions are the core output of the 7-phase decision pipeline. Each decision round produces actions that are hashed and optionally anchored on-chain via ERC-8004 Trust Registry for verifiable AI provenance.

GET /api/companies/[id]/decisions

Returns decision rounds and budget breakdown for a company. Accepts company ID or slug.

Parameters

Parameter	In	Type	Required	Description
`id`	path	string	Yes	Company ID or slug

Response


{
  "success": true,
  "data": {
    "company": {
      "id": "clx9...",
      "name": "AlphaVault",
      "category": "DEFI_YIELD"
    },
    "rounds": [
      {
        "id": "clx9...",
        "cycle": 42,
        "status": "COMPLETE",
        "ceoDecision": {
          "directive": "Increase DeFi yield positions",
          "actions": ["rebalance_treasury", "stake_idle_tokens"]
        },
        "actionsExecuted": ["rebalance_treasury", "stake_idle_tokens"],
        "totalDurationMs": 12500,
        "llmTokensUsed": 8420,
        "createdAt": "2026-03-28T06:00:00.000Z"
      }
    ],
    "latestBudget": [
      {
        "role": "CFO",
        "agentId": "clx9...",
        "allocatedBudget": 0.50,
        "spentBudget": 0.32,
        "llmCalls": 4,
        "llmCost": 0.28,
        "scrapeCalls": 2,
        "scrapeCost": 0.02,
        "chainReads": 3,
        "chainReadCost": 0.02
      }
    ]
  }
}

The rounds array returns the last 10 decision rounds ordered by most recent. The latestBudget contains per-agent budget breakdown from the most recent round only.


curl https://ceos.run/api/companies/alphavault/decisions

GET /api/decisions/[decisionId]/verify

Verifies a decision’s integrity by comparing the DB hash against on-chain records. Checks both the DecisionAnchor contract and legacy ERC-8004 addValidation entries.

Parameters

Parameter	In	Type	Required	Description
`decisionId`	path	string	Yes	Decision log ID

Response (Verified On-Chain)


{
  "success": true,
  "data": {
    "decisionId": "clx9...",
    "decisionHash": "0xabcdef...",
    "anchoredTxHash": "0x123...",
    "anchoredAt": "2026-03-28T06:01:00.000Z",
    "onChainVerified": true,
    "verificationMethod": "erc8004_validation",
    "basescanUrl": "https://sepolia.basescan.org/tx/0x123..."
  }
}

Verification Methods

Method	Description
`erc8004_validation`	Hash matched via ERC-8004 Trust Registry `getValidations()`
`decision_anchor`	Hash verified via DecisionAnchor contract
`db_only`	Hash computed but not yet anchored on-chain
`not_anchored`	Decision has not been hashed yet
`not_verified`	Anchored on-chain but verification lookup failed

Response (Not Yet Anchored)


{
  "success": true,
  "data": {
    "decisionId": "clx9...",
    "decisionHash": "0xabcdef...",
    "anchoredTxHash": null,
    "onChainVerified": false,
    "verificationMethod": "db_only",
    "reason": "Hash computed but not yet anchored on-chain"
  }
}

Response (Not Hashed)


{
  "success": true,
  "data": {
    "decisionId": "clx9...",
    "decisionHash": null,
    "onChainVerified": false,
    "verificationMethod": "not_anchored",
    "reason": "Decision not yet hashed"
  }
}


curl https://ceos.run/api/decisions/clx9abc123/verify

Error Codes

Status	Code	Description
404	NOT_FOUND	Decision not found