# Overview

> What Vestiarion is, and what its API and webhooks give an integration.

Vestiarion is an autonomous treasury agent for stablecoin businesses on Arc. It pays invoices in USDC or EURC, and contractor milestones in USDC, through Circle, within guardrails: it never pays a high-risk counterparty, never exceeds a payment limit, and keeps a liquidity buffer. Every decision it makes is recorded, with its reasoning, in an Ed25519-signed, hash-chained ledger. The API gives your integration read access to one workspace: its ledger, invoices, counterparties, milestones, treasury and insights. Webhooks push each new ledger entry to your endpoint as it is appended.

- [Try it in 5 minutes](https://www.vestiarion.xyz/docs/guides/try-it): Sample data, the agent deciding, a payment you approve, and the signed ledger, with no wallet or keys.
- [Quickstart](https://www.vestiarion.xyz/docs/get-started/quickstart): Create an API key and make your first two requests.
- [When the model and the policy disagree](https://www.vestiarion.xyz/docs/research/model-vs-policy): Production decisions beside the written policy's answer to the same facts: where they differed in the first week, and where code refused the model.
- [Go live on Arc testnet](https://www.vestiarion.xyz/docs/guides/go-live): Using the app: create the wallets, fund them and take the agent live.
- [API reference](https://www.vestiarion.xyz/docs/api): Every v1 endpoint with its parameters, response and errors.
- [Webhooks](https://www.vestiarion.xyz/docs/webhooks): Each ledger entry pushed to your HTTPS endpoint, signed.
- [AI integration](https://www.vestiarion.xyz/docs/ai-integration): Markdown views, llms.txt and the OpenAPI document for coding agents.
- [Changelog](https://www.vestiarion.xyz/docs/changelog): Changes to the API and webhooks, newest first.

## What you can build

- **A bot that reports held payments.** List [invoices](https://www.vestiarion.xyz/docs/api/list-invoices) and [milestones](https://www.vestiarion.xyz/docs/api/list-milestones) with `status=held`, and post each one with its `agentReasoning`: the agent's own account of why it did not pay.
- **An accounting sync.** Page through [invoices](https://www.vestiarion.xyz/docs/api/list-invoices) with `direction=payable` or `direction=receivable`, and copy each one's status, amount, counterparty, settlement time and `txHash` into your books.
- **An audit mirror.** Copy the [ledger](https://www.vestiarion.xyz/docs/api/list-ledger-entries) once, keep it current with [webhooks](https://www.vestiarion.xyz/docs/webhooks), and check each entry's [signature](https://www.vestiarion.xyz/docs/webhooks/verify) yourself. [Verify the ledger](https://www.vestiarion.xyz/docs/api/verify-ledger) to compare your result with Vestiarion's.
- **An invoice feed.** [Add invoices from your own system](https://www.vestiarion.xyz/docs/guides/api-invoices), such as an accounting tool or a billing script, and let the agent decide each one.
- **A treasury dashboard.** Show the [treasury](https://www.vestiarion.xyz/docs/api/get-treasury)'s account balances, reserve position, obligations due within 7 and 14 days and the latest liquidity forecast. Read [status](https://www.vestiarion.xyz/docs/api/get-status) first, so the dashboard shows whether payments are live or simulated.

## What the API is

Every endpoint is under `https://www.vestiarion.xyz/api/v1`. Most read; four add records, with a key given write access: a counterparty, an invoice, a milestone or a payee link. No request moves money, approves a payment, or changes or removes a record: the agent decides what is added as it decides anything typed into the console. Each request carries a [workspace API key](https://www.vestiarion.xyz/docs/get-started/authentication) and reaches only that key's workspace. The [endpoint overview](https://www.vestiarion.xyz/docs/api) lists every endpoint, and [data delivery methods](https://www.vestiarion.xyz/docs/data-delivery) compares pulling with the API to receiving webhooks.