Versioning

When backward-incompatible changes are made to the API, a new, dated version is released. The current version is 14 (2022-10-12).

Version	Release Date
11	2018-05-30
12	2021-08-05
13	2022-02-01
14	2022-10-12
15	2025-03-01
16	2026-06-01

A change is considered backward-incompatible when under the following conditions:

• Resources or fields are removed from responses
• The meaning (Type) of an attribute changes

Note that the version of an API does not increase when new resources are added or when new fields are added to a resource.

All requests use your partner account API settings unless you override the API version.

To set the API version on a specific request, you can add the IrVersion query string parameter or IR-Version header.

You can visit your partner account API settings to upgrade your API version. As a precaution, use API versioning to test a new API version before committing to an upgrade.

Warning: Upgrading your current account API version may break existing API calls that you have in place. As such, use caution when upgrading versions.

Versioning examples

QUERY STRING PARAMETER

curl 'https://api.impact.com/Mediapartners/<AccountSID>/Actions' \
	-d 'IrVersion=14' \
	-G

HEADER

curl 'https://api.impact.com/Mediapartners/<AccountSID>/Actions' \
	-d 'IrVersion=14' \
	-G