Customer API
Developers
A company, city, or ministry can register, receive 200 trial credits, mint a personal key, and call the platform. One credit is one agent run. This is not a card shop — production payment is SEPA / invoice.
- Create an account. A 30-day trial wallet is opened automatically.
- Open the API console, mint an X-GRV-Key, and copy it once.
- POST /api/v1/run with the key. Buy a developer plan, token pack, or city pilot when the trial ends.
Example
curl -s http://localhost:3000/api/v1/run \
-H "Content-Type: application/json" \
-H "X-GRV-Key: grv_live_YOUR_KEY" \
-d '{"agent":"twin","action":"snapshot","payload":{"city":"vienna"}}'Endpoints
GET /api/v1/health— liveness, no keyGET /api/v1/agents— agents a customer key may callGET /api/v1/me— plan and remaining creditsPOST /api/v1/run— run one public agent (1 credit)
Invoice, LinkedIn publish, and tender award stay off this key. Those remain admin actions.