# 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 - [Get chat agent](/llms-full.txt): GET /api/v1/chat/agent (scope: chat:read) - [API Request Logs](/llms-full.txt): GET /api/v1/logs (scope: logs:read) - [Monthly approvals — Work time](/llms-full.txt): GET /api/v1/tt-monthly-approval-status (scope: time_tracking: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) - [Preview Wage Type Transfer](/llms-full.txt): POST /api/v1/wage-type-transfers/preview (scope: wage_types:read) - [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) - [Import Persons (data import)](/llms-full.txt): POST /api/v1/persons/data-import (scope: persons:write) - [Manage Wage Type Sets](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/wage-type-sets (scope: wage_types:read, wage_types:write) - [Person Import Schema](/llms-full.txt): GET /api/v1/persons/import-schema (scope: persons:read) - [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) - [Start conversation](/llms-full.txt): POST /api/v1/chat/conversations (scope: chat: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) - [Monthly approvals — Project time](/llms-full.txt): GET /api/v1/activity-monthly-approval-status (scope: activity:read) - [Import Customers](/llms-full.txt): POST /api/v1/customers/import (scope: customers:write) - [Customer Import Schema](/llms-full.txt): GET /api/v1/customers/import-schema (scope: customers: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) - [List conversations](/llms-full.txt): GET /api/v1/chat/conversations (scope: chat:read) - [Download Receipt 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_number}/stages (scope: travels:read, travels:write) - [Manage Travel Receipts](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/travels/{travel_number}/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_number}/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_number} (scope: travels:read, travels:write) - [Travel Type Assignments](/llms-full.txt): DELETE, GET, POST, PUT /api/v1 (scope: travel_types:read, travel_types:write) - [Car Allowance Type Assignments](/llms-full.txt): DELETE, GET, POST, PUT /api/v1 (scope: car_allowance_types:read, car_allowance_types:write) - [Read messages](/llms-full.txt): GET /api/v1/chat/conversations/{conversation_id}/messages (scope: chat:read) - [Manage Additional Fields](/llms-full.txt): DELETE, GET, POST, PUT /api/v1/fields (scope: fields:read, fields:write) - [Calendar and time bookings (personal)](/llms-full.txt): GET, POST /api/v1/me (scope: time_tracking:read) - [Trigger Webhook](/llms-full.txt): POST /api/v1/webhooks/trigger (scope: webhooks:execute) - [Approval task details](/llms-full.txt): GET /api/v1/me/approvals/{entity_type}/{entity_key} (scope: workflows:read) - [Field Configurations](/llms-full.txt): GET, PUT /api/v1 (scope: additional_fields:read, additional_fields:write) - [Import Employment Contracts](/llms-full.txt): POST /api/v1/tt-contracts/import (scope: time_tracking:write) - [Contract Import Schema](/llms-full.txt): GET /api/v1/tt-contracts/import-schema (scope: time_tracking:read) - [Import Initial Values](/llms-full.txt): POST /api/v1/tt-initial-values/import (scope: time_tracking:write) - [Initial Value Import Schema](/llms-full.txt): GET /api/v1/tt-initial-values/import-schema (scope: time_tracking:read) - [Send message](/llms-full.txt): POST /api/v1/chat/conversations/{conversation_id}/messages (scope: chat: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) - [Account Values](/llms-full.txt): POST /api/v1/tt-account-values (scope: time_tracking:read) ## Full Reference - [Complete API Documentation](/llms-full.txt): All endpoints with request/response schemas and examples