Skip to content

API Overview

The xTool API is your gateway to comprehensive electronic invoicing and document processing capabilities. Built for modern B2B workflows, our API enables seamless document conversion, validation, and exchange across multiple formats and networks.

Two-Tier Architecture

Our API is designed around two distinct operational modes, each optimized for different use cases:

Persistent Operations

For production workflows - Documents are stored, tracked, and fully audited:

  • Document Lifecycle Management: Upload, store, and retrieve XML/JSON documents with full version control
  • Peppol Network Integration: Direct B2B document exchange through the global Peppol network
  • Comprehensive Logging: Track every operation with detailed audit trails and status monitoring
  • Batch Processing: Handle multiple documents efficiently with single API calls
  • Multi-tenant Support: Secure organization-based document isolation

Real-time Transformations

For immediate processing - Convert and validate documents without storage:

  • Universal Format Conversion: Transform between JSON, XML, ZUGFeRD, and IDoc formats instantly
  • Advanced Validation: Validate against XSD and XSLT schemas with detailed error reporting
  • PDF Generation: Create ZUGFeRD-compliant PDFs with embedded XML data
  • Format Standards: Full support for XRechnung 3 (UBL/CII), Peppol BIS 3, and custom IDoc types

Authentication & Security

Secure your API access with API key authentication:

  1. Generate API Key: Create your key through the xTool web application
  2. Include in Headers: Add x-api-key header to all requests
  3. Organization Scoping: Keys are scoped to your organization for enhanced security

Why Choose xTool API?

  • Industry Standards: Full compliance with XRechnung 3, Peppol BIS 3, and ZUGFeRD standards
  • Global Reach: Direct integration with the Peppol network for international B2B exchange
  • Developer Friendly: Comprehensive validation, detailed error messages, and extensive documentation
  • Enterprise Ready: Multi-tenant architecture with full audit capabilities
  • Performance Optimized: Real-time processing for immediate results, persistent storage for production workflows

Get Started

Ready to integrate? Explore our comprehensive API documentation with interactive examples:

View Swagger Documentation - Interactive API explorer with live examples