Skip to main content

​
Welcome to Taxo API

Taxo API provides enterprise-grade automation for tax document extraction across multiple countries and tax authorities. Our unified API interface allows you to integrate once and expand to new jurisdictions seamlessly.

​
How It Works

1

Get API Credentials

Obtain your API key and configure authentication
2

Prepare Tax Credentials

Gather the necessary credentials for your target tax authority
3

Configure Extraction

Set up document extraction with appropriate filters and parameters
4

Monitor & Download

Track job progress and download completed documents

​
Supported Countries

Mexico (SAT)

Extract CFDI invoices, tax status certificates, and retention documents from SAT

More Countries

Request - Contact us for additional country support

​
Universal API Concepts

​
Job-Based Processing

All document extractions use asynchronous job processing:
  1. Create Job: Submit extraction request with credentials and filters
  2. Processing: System validates credentials and extracts documents
  3. Completion: Job finishes with success or failure status
  4. Download: Retrieve individual documents using job results
Every job gets a unique publicId for tracking:
{
  "publicId": "JOB20250104123456789A",
  "status": "PROCESSING",
  "progress": {
    "discoveryCount": 1500,
    "completedCount": 750,
    "percentage": 50
  }
}

​
Universal Status Codes

StatusDescriptionNext Action
PENDINGJob queued for processingWait or check status periodically
PROCESSINGActively extracting documentsMonitor progress
COMPLETEDAll documents extracted successfullyDownload documents
FAILEDJob failed due to errorCheck error details and retry

​
Common Error Patterns

  • Invalid API Key: Check your API key configuration
  • Expired Credentials: Renew tax authority credentials
  • Permission Denied: Verify account permissions for the requested operation
  • Invalid Parameters: Check request format and required fields
  • Date Range Too Large: Reduce the time period for extraction
  • Unsupported Document Type: Verify document type is available for the country
  • Rate Limit Exceeded: Implement backoff strategy
  • Service Unavailable: Tax authority system maintenance
  • Timeout: Large extractions may need more time

​
Integration Architecture

​
Security Best Practices

​
Next Steps

Choose Your Country

Start with Mexico, our most mature integrationMexico SAT Guide →

Integration Best Practices

Learn production-ready patterns and security practicesBest Practices →

Get API Key

Contact our team to get started with API accessContact Sales →

Troubleshooting

Common issues and solutions across all countriesTroubleshooting →

​
Support

Need Help Getting Started?
This documentation follows our country-first architecture. Each country has its own section with specific implementation details, while global concepts apply across all integrations.