# AIMEAT Finance API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-finance-api/  
**Provider:** AIMEAT — https://apis.io/providers/aimeat-io/  
**Base URL:** https://aimeat-finland-001-genesis.overscalesolutions.com  
**Documentation:** https://aimeat.io/v1/spec

AIMEAT Finance API is one of 100 APIs that [AIMEAT](https://apis.io/providers/aimeat-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Finance. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Company-in-a-box bookkeeping — sales invoices (Finvoice 3.0), append-only vouchers, VAT registry/report, fiscal years, accountant exports, and PSP webhooks that book vouchers

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/finance/invoices` | List the owner's sales invoices |
| POST | `/v1/finance/invoices` | Create an invoice draft |
| GET | `/v1/finance/invoices/{id}` | Read one invoice |
| PUT | `/v1/finance/invoices/{id}` | Edit a draft invoice |
| DELETE | `/v1/finance/invoices/{id}` | Delete a draft invoice |
| POST | `/v1/finance/invoices/{id}/send` | Send an invoice (draft → sent) |
| POST | `/v1/finance/invoices/{id}/mark-paid` | Mark an invoice paid |
| POST | `/v1/finance/invoices/{id}/credit-note` | Create a credit-note draft for a sent invoice |
| GET | `/v1/finance/invoices/{id}/finvoice.xml` | Download the Finvoice 3.0 XML |
| GET | `/v1/finance/vouchers` | List accounting vouchers |
| POST | `/v1/finance/vouchers` | Book a manual/receipt voucher |
| GET | `/v1/finance/vouchers/{id}` | Read one voucher |
| POST | `/v1/finance/vouchers/{id}/reverse` | Reverse a voucher (the correction mechanism) |
| POST | `/v1/finance/vouchers/{id}/attachments` | Attach evidence (storage keys) to a voucher |
| GET | `/v1/finance/vat-codes` | List VAT codes valid on a date |
| GET | `/v1/finance/fiscal-years` | List fiscal years |
| POST | `/v1/finance/fiscal-years` | Create a fiscal year |
| POST | `/v1/finance/fiscal-years/{id}/lock` | Lock or unlock a fiscal year (owner only) |
| GET | `/v1/finance/vat-report` | VAT period summary (ALV-kausikooste) |
| GET | `/v1/finance/export/vouchers.csv` | Voucher journal CSV (semicolon, comma decimals, BOM) |
| GET | `/v1/finance/export/invoices.csv` | Invoice ledger CSV |
| GET | `/v1/finance/export/finvoice.zip` | Finvoice XML bundle (ZIP) of sent invoices in a date range |
| POST | `/v1/commerce/webhooks/stripe/{owner}` | Per-seller Stripe webhook → accounting vouchers |
| GET | `/v1/finance/invoices/{id}/pdf` | Download the invoice as an A4 PDF |
| POST | `/v1/finance/invoices/{id}/deliver-finvoice` | (Re)submit a sent invoice to the e-invoice operator |
| POST | `/v1/finance/invoices/{id}/refresh-delivery` | Poll the operator for the delivery outcome |
| GET | `/v1/finance/accountants` | List the owners granted the accountant role on your books |
| POST | `/v1/finance/accountants` | Grant the accountant role (read-only books access) to a local owner |
| DELETE | `/v1/finance/accountants/{name}` | Revoke the accountant role |
| GET | `/v1/finance/clients` | The accountant's verified client list |
| GET | `/v1/finance/pnl` | P&L period summary (tuloskooste) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-finance-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-def-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-schedule-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-ai-provenance-declaration-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-app-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-memory-write-schema.json

## Other AIMEAT APIs (12)

- [AIMEAT A2A API](https://apis.io/apis/aimeat-io/aimeat-io-a2a-api/)
- [AIMEAT Actions API](https://apis.io/apis/aimeat-io/aimeat-io-actions-api/)
- [AIMEAT Admin API](https://apis.io/apis/aimeat-io/aimeat-io-admin-api/)
- [AIMEAT Agent Crew API](https://apis.io/apis/aimeat-io/aimeat-io-agent-crew-api/)
- [AIMEAT Agent Directives API](https://apis.io/apis/aimeat-io/aimeat-io-agent-directives-api/)
- [AIMEAT Agent Goals API](https://apis.io/apis/aimeat-io/aimeat-io-agent-goals-api/)
- [AIMEAT Agent Integration API](https://apis.io/apis/aimeat-io/aimeat-io-agent-integration-api/)
- [AIMEAT Agent Messages API](https://apis.io/apis/aimeat-io/aimeat-io-agent-messages-api/)
- [AIMEAT Agent Onboarding API](https://apis.io/apis/aimeat-io/aimeat-io-agent-onboarding-api/)
- [AIMEAT Agent Tasks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-tasks-api/)
- [AIMEAT Agent Telemetry API](https://apis.io/apis/aimeat-io/aimeat-io-agent-telemetry-api/)
- [AIMEAT Agent Webhooks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-webhooks-api/)

## Tags

Finance

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/aimeat-io/aimeat-io-finance-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/aimeat-io/.