Documentation | Wine Export Tariff API

Quick Start Guide

1. Get Your API Key

Sign up for a free account to get your API credentials. Your API key will be displayed in the dashboard.

2. Make Your First Request

All API requests require the X-API-Key header for authentication.

# Calculate export duties
curl -X POST https://api.export-connect.io/api/v1/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ec_your_api_key_here" \
  -d '{
    "destination_country": "US",
    "lines": [{
      "wine_type": "STILL_RED",
      "volume_liters": 0.75,
      "quantity": 12,
      "unit_price": 25.00,
      "alcohol_degree": 13.5
    }]
  }'
            

3. Handle the Response

The API returns a structured JSON response with the calculated duties broken down by tax type.

{
  "destination_country": "US",
  "calculated_at": "2024-01-15T10:30:00Z",
  "lines": [{
    "reference": "LINE-001",
    "success": true,
    "total_duties": 18.72,
    "taxes": [
      {
        "name": "Federal Excise Tax",
        "rate": 1.07,
        "calculation_type": "fixed_per_liter",
        "amount": 9.63
      },
      {
        "name": "Import Duty",
        "rate": 3.0,
        "calculation_type": "percentage",
        "amount": 9.09
      }
    ]
  }],
  "grand_total": 18.72,
  "currency": "EUR"
}
            

API Endpoints

POST

/api/v1/calculate

Calculate export duties for one or more wine shipment lines.
POST

/api/v1/validate

Validate a shipment before sending. Check restrictions and requirements.
GET

/api/countries

List all supported destination countries with their codes.
GET

/api/wine_types

List all supported wine types with their codes and HS codes.

Wine Types

Use these codes in the wine_type field:

Code	Description	Alcohol Range
`STILL_RED`	Still red wine	8% - 15%
`STILL_WHITE`	Still white wine	8% - 15%
`STILL_ROSE`	Still rose wine	8% - 15%
`SPARKLING`	Sparkling wine (Champagne, Cremant, etc.)	10% - 13%
`FORTIFIED`	Fortified wine (Port, Sherry, etc.)	15% - 22%
`DESSERT`	Sweet/dessert wines	8% - 18%

Error Handling

The API returns structured error responses with helpful messages:

{
  "type": "https://tools.ietf.org/html/rfc2616#section-10",
  "title": "An error occurred",
  "status": 400,
  "detail": "Country code 'XX' not found"
}
            

Developer documentation