# Versioning

When backwards-incompatible changes are made to the API, a new, dated version is released.

| Version | Release Date |
| ------- | ------------ |
| 11      | 2022-10-12   |
| 12      | 2024-05-06   |
| 13      | 2025-03-01   |
| 14      | 2026-06-01   |

A change is considered backwards-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 [account API settings](https://app.impact.com/secure/advertiser/accountSettings/techintegration/adv-wsapi-table-flow.ihtml), unless you override the API version. The changelog lists every available 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 [account API settings](https://app.impact.com/secure/advertiser/accountSettings/techintegration/adv-wsapi-table-flow.ihtml) to upgrade your API version. As a precaution, use API versioning to test a new API version before committing to an upgrade.

{% hint style="danger" %}
Upgrading your current account API version may break existing API calls that you have in place. Use caution when upgrading versions.
{% endhint %}

#### Versioning Examples

***

{% tabs %}
{% tab title="Querystring" %}

```bash
curl 'https://api.impact.com/Advertiser/<AccountSID>/Actions' \
	-d 'IrVersion=13' \
	-G
```

{% endtab %}

{% tab title="Header" %}

```bash
curl 'https://api.impact.com/Advertiser/<AccountSID>/Actions' \
	-H 'IR-Version: 13'
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v13/readme/versioning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.