The Invoice API provides endpoints for generating, retrieving, and managing invoices for organization usage on the Freddy AI platform. All endpoints require authentication, and most operations are restricted to staff users only.
Invoices are automatically generated based on organization usage of AI models and services. Each invoice includes:
- Detailed line items for each model used
- Token usage breakdown (input/output)
- Pricing per model and provider
- Tax calculations (Swiss VAT)
- Payment tracking
Invoices follow a defined status workflow:
- draft - Invoice created but not finalized
- issued - Invoice finalized and sent to organization
- paid - Payment received and recorded
- overdue - Payment past due date
- cancelled - Invoice cancelled
Invoice numbers follow the format: INV-{YYYY}-{MM}-{ORG_PREFIX}-{SEQUENCE}
Example: INV-2024-12-AIT-001
- Staff Users: Can create, view, and manage all invoices
- Organization Users: Can only view invoices for their own organization
https://api.aitronos.com/v1/invoices