API Overview

API Overview

The ShipVAT API provides RESTful endpoints for tax rates and nexus thresholds.

Base URL

https://api.shipvat.com

Endpoints

Endpoint	Method	Description
/health	GET	Health check (no auth)
/v1/rates	GET	Get tax rates
/v1/thresholds	GET	Get nexus thresholds
/v1/decision/collect	POST	Tax collection decision
/v1/metadata/jurisdictions	GET	List jurisdictions

Authentication

All /v1/* endpoints require a Bearer token:

-H "Authorization: Bearer sk_your_api_key"

Response Format

All responses are JSON:

{
  "data": { ... },
  "queried_at": "2024-01-15T10:30:00Z"
}

Error Format

{
  "error_code": "ERROR_TYPE",
  "message": "Human readable message",
  "details": {}
}