Versions & change feed
Stay in sync without re-downloading everything, and fetch any version by id for audits.
Change feed
GET/v1/changes
Every version published or superseded after a timestamp, oldest first (up to 500 per call). Available on Starter and above.
| Parameter | Type | Description |
|---|---|---|
since | ISO 8601 timestamp | Defaults to 30 days ago. Store the time of your last successful poll and pass it here. |
bash
curl "https://tax-api-dev.itensiahr.com/v1/changes?since=2025-10-01T00:00:00Z" -H "Authorization: Bearer $ITX_API_KEY"Response (abridged)
{
"since": "2025-10-01T00:00:00.000Z",
"changes": [
{ "event": "published", "at": "2025-10-03T14:20:05Z", "tax": { "tax_code": "US-OR:SUI", "version": { "number": 3 }, "…": "…" } },
{ "event": "superseded", "at": "2025-10-03T14:20:05Z", "tax": { "tax_code": "US-OR:SUI", "version": { "number": 2 }, "…": "…" } }
],
"meta": { "request_id": "req_…" }
}A correction appears as a new version being published and the previous one superseded. If you received 500 changes, poll again using the last at as since.
The response also contains a data array in an older format for existing integrations; new code should read changes.
Get a version
GET/v1/versions/{id}
Fetch a published or superseded version by the version.id you stored. Useful for showing exactly which rule produced a past calculation.