developer-hub

Home | Getting started | Postman | API Documentation | Change log

Change Log

v1.4.2 - 2026-03-??

• Removed Swagger UX from developer hub, replaced with Redoc version API Documentation
• Updated Developer preview of VAT Filer API including the VAT Filer - Overview in-depth getting started guide
• Release note Release

v1.4.1 - 2026-02-21

• Changes were made to the configuration of our load balances that handle API traffic.
• No changes for clients of the main API in this version.
• For Connector Partners this version provides the preview of the provisioning api service (contact us directly for further information)
• Release note Release

v1.4.0 - 2026-01-23

• Added OAS documentation for the companies resource in API Documentation
  • Documented POST /v0/companies
  • Documented GET /v0/companies
  • Documented GET /v0/companies/{id}
  • Documented PUT /v0/companies/{id}
  • Documented DELETE /v0/companies/{id}
• This adds significant capabilities to the Tax Agile API, and has warranted a version point update from v1.3.x to v1.4.x but does not introduce any breaking changes to existing functionality.
• Sample Postman collection v1.3.9
• Release note Release

v1.3.9 - 2026-01-06

• Introduced VAT Filer via the API - see VAT Filer - Overview for in-depth getting started documentation
  • Preview GET /v0/filer/vat/filings
  • Preview GET /v0/filer/vat/filings/events
  • Preview GET /v0/filer/vat/filings/events/companies/:id/filings/:id/periods/:id/reports/:id/metadata
  • Preview POST /v0/filer/vat/filings/events/companies/:id/filings/:id/periods/:id/reports/:id
• Sample Postman collection v1.3.9
• Release note Release

v1.3.8 - 2025-12-12

• The “VAT Determination - Response” object schema was updated to include additional attributes which affects:
  • Changed POST /v1/determination/vat/transactions
  • Changed GET /v1/determination/vat/transactions
  • Changed GET /v1/determination/vat/transactions/{id}
  • Changed GET /v1/auditor/vat/audits/{id}/results
• Updated Swagger
• Sample Postman collection v1.3.6
• Release note Release

v1.3.7 - 2025-12-05

• TLS minimum version of 1.2 is now enforced, with weaker CBC ciphers not offered.
• We added a Coming soon page to this Developer Hub to give you some early visibility of API changes in development.
• Release note Release

v1.3.6 - 2025-11-29

• Introduced the Companies resource within the ‘Developer Previews’ folder of the Sample Postman collection. These are previews and are declared with the v0 versioning so may change without notice. We would welcome feedback on any issues found on these endpoints, so we can move to v1 published endpoints in early 2026.
  • Preview POST /v0/companies
  • Preview GET /v0/companies
  • Preview GET /v0/companies/{id}
  • Preview PUT /v0/companies/{id}
  • Preview DELETE /v0/companies/{id}
• Sample Postman collection v1.3.6

TLS minimum version 1.2

With this release, we planned to disable earlier TLS versions and disable the CBC ciphers. However, due to this release being made on 29/Nov between Black Friday and Cyber Monday; we postponed this change, until our next release.

Please ensure your API client is supporting TLS 1.2.

v1.3.5 - 2025-05-09

• Changed GET /v1/determination/vat/transactions/:id to return a more specific value in the field source. Previously it would state api but not it states calculator-api.
• Sample Postman collection v1.3.5
• Release note Release

v1.3.4 - 2025-02-09

• Changed POST /v1/datamanager/vat/uploads to add more validation multpart/form-data use-case, returning more detailed error codes/messages
• Sample (same as v1.3.3 no changes) Postman collection v1.3.3
• Release note Release

v1.3.3 - 2024-12-14

• Changed POST /v1/datamanager/vat/uploads to support a data mapping being used on a JSON body payload
• Sample Postman collection v1.3.3
• Release note Release

v1.3.2 - 2024-11-11

• Updated the VAT Data Model schema in swagger docs
  • Previously we were not correctly representing the data type number in the schema documentation.
  • We have corrected that, so now the schema matches the examples provided in the Postman collection.
• Sample (same as v1.3.0 no changes) Postman collection v1.3.0
• Release note Release

v1.3.1 - 2024-09-30

• Moved the API infrastructure to be accessed via a load balancer
• Added staging-api.taxagile.io endpoint to swagger docs
• Removed test-api.taxagile.io from documentation (deprecated)
• Updated VAT Data model to include new item types
  • Admission to virtual events
  • Electric vehicle charging
• Changed POST /v1/datamanager/vat/uploads and POST /v1/auditor/vat/audits to validate the request body dates are sent in YYYY-MM-DD format. If not, a 400 will be returned.
• Updated Swagger.json as it had some minor typos in the v1.3.0 release.
• Sample (same as v1.3.0 no changes) Postman collection v1.3.0
• Release note Release

v1.3.0 - 2024-08-09

• Published POST /v1/datamanager/vat/uploads
• Published GET /v1/datamanager/vat/uploads
• Published GET /v1/datamanager/vat/uploads/{id}
• Published DELETE /v1/datamanager/vat/uploads/{id}
• Changed POST /v1/auditor/vat/audits
• Changed GET /v1/auditor/vat/audits
• Changed GET /v1/auditor/vat/audits/{id}
• Changed GET /v1/auditor/vat/audits/{id}/results
• Changed DELETE /v1/auditor/vat/audits/{id}
• Sample Postman collection v1.3.0
• Release note Release

v1.2.5 - 2024-05-22

• Updated POST /v1/determination/vat/transactions
  • Added a query parameter taxCodeScheme which can be used with useTaxCodes parameter to specify whether the taxCode in the response body is from Tax Codes setup in your account, or returning a known scheme (e.g. Avalara).
• Sample Postman collection v1.2.5
• Release note Release

v1.2.4 - 2024-05-03

• Added support for the Avalara iVAT Reporting XML as an input format for VAT Filer
  • Updated POST /v1/auditor/vat/audits
• Sample Postman collection v1.2.4
• Release note Release

v1.2.3 - 2024-02-20

• Updated VAT Data model to add 4 new fields:
  • date.originalDocDate
  • document.originalDocNumber
  • item.originalValue
  • item.originalVatAmountToCheck
• These fields are available in the body requests of:
  • POST /v1/determination/vat/transactions
  • POST /v1/auditor/vat/audits
• Release note Release

v1.2.2 - 2023-11-28

• Updated GET /v1/auditor/vat/audits/{id}/results
• Sample Postman collection v1.2.2
• Release note Release

v1.2.1 - 2023-11-10

• Updated POST /v1/determination/vat/transactions
• Sample Postman collection v1.2.1
• Release note Release

v1.2.0 - 2023-09-15

• Updated POST /v1/determination/vat/transactions
• Sample Postman collection v1.2.0
• Release note Release

v1.1.2 - VAT Auditor - GA - v1 - 2023-07-28

• Published GET /v1/auditor/vat/audits/
• Published GET /v1/auditor/vat/audits/{id}
• Published GET /v1/auditor/vat/audits/{id}/results
• Sample Postman collection v1.1.2
• Release note Release

v1.1.1 - 2023-06-02

• Published GET /v0/auditor/vat/audits/{id}/results
• Sample Postman collection v1.1.1
• Release note Release

v1.1.0 - VAT Auditor - Preview - v0 - 2023-04-28

• Published POST /v1/auditor/vat/audits
• Published GET /v0/auditor/vat/audits
• Published GET /v0/auditor/vat/audits/{id}
• Published DELETE /v1/auditor/vat/audits/{id}
• Published GET /v1/operations/{id}
• Sample Postman collection v1.1.0
• Release note Release

v1.0.2 - 2023-01-06

• Added isExternalTransit = false to sample body
• Updated the response body of the transaction detail request GET /v1/determination/vat/transactions/{id}?detail=true
• Sample Postman collection v1.0.2

v1.0.1 - VAT Determination - 2022-06-29

• Published GET /v1/determination/vat/transactions
• Published GET /v1/determination/vat/transactions/{id}
• Sample Postman collection v1.0.1

v1.0.0 - VAT Determination - GA - v1 - 2022-06-28

• Published POST /v1/determination/vat/transactions