# Tovio API

> Enterprise travel expense management API for payroll integration,
> data export, webhook delivery, and master data management.

## Authentication

All requests require an API key in the `x-api-key` header.
Format: `to_{live|test}_{prefix}{secret}`

## Base URL

https://api.tovio.app/api/v1

## Endpoints

- [API Request Logs](/llms-full.txt): GET /api/v1/logs (scope: logs:read)
- [Get Wage Type Transfers](/llms-full.txt): POST /api/v1/wage-type-transfers (scope: wage_types:read)
- [Trigger Wage Type Transfer](/llms-full.txt): POST /api/v1/wage-type-transfers/trigger (scope: wage_types:write)
- [Import Persons](/llms-full.txt): POST /api/v1/persons/import (scope: persons:write)
- [Manage Wage Types](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/wage-types (scope: wage_types:read, wage_types:write)
- [Manage Wage Type Sets](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/wage-type-sets (scope: wage_types:read, wage_types:write)
- [Receipt Type Default Wage Types](/llms-full.txt): DELETE, GET, PUT /api/v1/receipt-type-default-wage-types (scope: wage_types:read, wage_types:write)
- [Value Type Wage Type Mappings](/llms-full.txt): DELETE, GET, PUT /api/v1/value-type-wage-type-mappings (scope: wage_types:read, wage_types:write)
- [Import Master Data](/llms-full.txt): POST /api/v1/entities/import (scope: {entity}:write)
- [API Usage Statistics](/llms-full.txt): GET /api/v1/logs/usage (scope: logs:read)
- [Manage Export Formats](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/export-formats (scope: exports:read, exports:write)
- [Manage Combined Export Formats](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/export-combined-formats (scope: exports:read, exports:write)
- [Download File](/llms-full.txt): POST /api/v1/files/download (scope: files:read)
- [Manage Receipt Types](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/receipt-types (scope: receipt_types:read, receipt_types:write)
- [Manage Travels](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/travels (scope: travels:read, travels:write)
- [Receipt Country Configuration](/llms-full.txt): DELETE, GET, PUT /api/v1/receipt-countries (scope: receipt_types:read, receipt_types:write)
- [Manage Travel Stages](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/travels/{travel_id}/stages (scope: travels:read, travels:write)
- [Manage Travel Receipts](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/travels/{travel_id}/receipts (scope: travels:read, travels:write)
- [VAT Rates](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/receipt-country-vat-rates (scope: receipt_types:read, receipt_types:write)
- [Manage Car Allowances](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/travels/{travel_id}/car-allowances (scope: travels:read, travels:write)
- [VAT Rate Wage Type Mappings](/llms-full.txt): DELETE, GET, PUT /api/v1/receipt-country-vat-rate-wage-types (scope: wage_types:read, wage_types:write)
- [Manage Locations](/llms-full.txt): GET, POST /api/v1/locations (scope: travels:read, travels:write)
- [List Regions](/llms-full.txt): GET /api/v1/regions (scope: travels:read)
- [Travel Approvals](/llms-full.txt): GET, POST /api/v1/travels/{travel_id} (scope: travels:read, travels:write)
- [Manage Additional Fields](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/fields (scope: fields:read, fields:write)
- [Trigger Webhook](/llms-full.txt): POST /api/v1/webhooks/trigger (scope: webhooks:execute)
- [Field Configurations](/llms-full.txt): GET, PUT /api/v1 (scope: additional_fields:read, additional_fields:write)
- [Export Data](/llms-full.txt): POST /api/v1/exports (scope: exports:execute)
- [Manage Settings](/llms-full.txt): GET, PUT /api/v1/settings (scope: settings:read, settings:write)

## Full Reference

- [Complete API Documentation](/llms-full.txt): All endpoints with request/response schemas and examples