Versions - Taxwire Documentation

Current API version

hydrogen.2025-04-15

Version naming

We use a date & human-readable name based semantic versioning for our API. This means that we increment the named version when we make breaking changes to the API. Version format: named_version.YYYY-MM-DD Example: hydrogen.2025-04-15

hydrogen.2025-03-21 -> hydrogen.2025-04-22 ==> No breaking changes
hydrogen.2025-03-21 -> helium.2025-04-22 ==> Breaking changes

In order to ensure you get a response format that you expect, we recommend that you pass a version header to your API calls.

Warning

If you do not provide a version header, the API request will fail with a HTTP 400.

A version header Taxwire-Version is expected in the following format:

curl --request POST \
  --url https://api.taxwire.com/calculations \
  --header 'Content-Type: application/json' \
  --header 'Taxwire-Version: hydrogen.2025-04-15' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{....SOME BEAUTIFUL JSON....}'

import requests

url = "https://api.taxwire.com/calculations"
headers = {
    "Taxwire-Version": "hydrogen.2025-04-15",
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
}
payload = {
    # ... MORE BEAUTIFUL JSON ...
}
response = requests.request("POST", url, json=payload, headers=headers)
response.json()

const options = {
  method: 'POST',
  headers: {
    'Taxwire-Version': 'hydrogen.2025-04-15',
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: '{ ...GREAT JSON... }'
};

fetch('https://api.taxwire.com/calculations', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));