---
title: Account Protection API Changelog
slug: public-apis/account-protection-api-changelog
createdAt: 2026-05-11T21:38:32.423Z
---

::::ExpandableHeading
###

**Topic type: Concept**

:::hint{type="warning"}
**Purpose:&#x20;**&#x52;ecord contractual and behavioral changes to the Account Protection API over time.&#x20;

**Audience:** API integrators and client developers maintaining or upgrading integrations.&#x20;

**Applies to:&#x20;**&#x54;he Account Protection API and its published OpenAPI reference.&#x20;

**Does not apply to:&#x20;**&#x49;nternal implementation changes that do not affect the public API contract.
:::
::::

This changelog documents **contractual and behavioral changes** to the **Account Protection API**. It is intended to help integrators understand how the API has evolved and assess the impact of changes on existing integrations.

The OpenAPI reference remains the **single -source of truth** for the current API contract. This changelog provides historical context and impact classification for changes reflected in the reference.

:::ExpandableHeading
## How to Read This Changelog

Each entry is listed in reverse chronological order and classified by **impact level**:

| Type                    | Meaning                                                                                                         | Client Action   |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- | --------------- |
| **Breaking**            | A change that may require code changes or integration updates.<br /><br />**Classifications**: Removed, Changed | Required update |
| **Backward-compatible** | A change that does not break existing integrations.<br /><br />**Classifications**: Added, Changed, Deprecated  | Optional update |
| **Behavioral**          | Contract unchanged, behavior changed.<br /><br />**Classification**: Changed                                    | Review          |
| **Documentation**       | A clarification or correction with no contract or behavior change.<br /><br />**Classification**: Clarified     | None            |

When a field or behavior is deprecated, the changelog records:

- the deprecation date
- the recommended replacement (if applicable)
- whether removal is planned for a future release
:::

***

# Changelog Entries

:::ExpandableHeading
## Version 2.13 (Documented Errors)

### Type: Documentation

**ClarifiedAdded**&#x20;

- Documented the list of errors, including 401, 500 and others.
:::

:::ExpandableHeading
## Version 2.12 (Expanded authentication options)

### Type: Backward-compatible

**Added**&#x20;

- Added support for **OAuth 2.0** (Client Credentials) authentication in addition to **Basic Authentication**
:::

:::ExpandableHeading
## Version 2.11 (Verification event enhancements)

### Type: Backward-compatible

**Added**&#x20;

- Added required `updateEventType `field to the verification event
- Added optional fields to the verification event:&#x20;
  - `verificationClassification`
  - `updateEventRecommendationDetail`

**Changed**&#x20;

- Added new option `newCodeWithinExpiry `to the `failureCode `field in the verification event
:::

:::ExpandableHeading
## Version 2.10 (Field relocation in payment schema)

### Type: Breaking

**Changed**&#x20;

- Moved `isPaymentRecurring `from the `paymentMethods `block to the `payment `block
:::

:::ExpandableHeading
## Version 2.9 (Schema and example alignment)

### Type: Documentation

**Clarified**

- Updated schema types and examples to ensure consistency and alignment
:::

:::ExpandableHeading
## Version 2.8 (Field removal)

### Type: Breaking

**Removed**&#x20;

- Removed `recommendationCode `from **Chargeback&#x20;**&#x61;nd **Verification&#x20;**&#x65;vents
:::

:::ExpandableHeading
## Version 2.7 (Response structure changes)

### Type: Breaking

**Changed**&#x20;

- Recalibrated nested blocks in the response structure

**Removed**&#x20;

- Removed `reasonCodes `block from the response
:::

:::ExpandableHeading
## Version 2.6 (New events and verification fields)

### Type: Backward-compatible

**Added**&#x20;

- Added success and `failureCode `fields to the verification event
- Added new **Refunds&#x20;**&#x65;vent to the API
:::

:::ExpandableHeading
## Version 2.5 (Major authentication and schema updates)

### Type: Breaking

**Changed**&#x20;

- Changed API base URL prefix to `adi.accertify.net`

**Removed**&#x20;

- Removed support for:
  - JWT Authentication
  - Custom Authentication

***

### Type: Backward-compatible

**Added**&#x20;

- Added `account `object to the Login event
- Added `secCard `as a payment type for corporate-issued payments used within secure payment portals
- Added `isRecurring `field to the `paymentMethods `object for subscriptions

**Changed**&#x20;

- Moved `accountStatus `and `hashedPassword `to the root level
:::

:::ExpandableHeading
## Version 2.4 (Verification and authentication enhancements)

### Type: Backward-compatible

**Added**&#x20;

- Added `success `and `failureCode `fields to the verification event
- Added new options to `verificationType `field:&#x20;
  - FIDO
  - magicLink
- Added `authenticationMethod `field to all events
:::

:::ExpandableHeading
## Version 2.3 (Guest checkout support)

### Type: Backward-compatible

**Added**

- Added `isGuestCheckout `field to `inventoryHold `and payment events
:::

:::ExpandableHeading
## Version 2.2 (Authentication method expansion)

### Type: Backward-compatible

**Added**&#x20;

- Introduced JWE authentication method
:::

:::ExpandableHeading
## Version 2.1 (Branding and new event)

### Type: Backward-compatible

**Added**&#x20;

- Added new **Inventory Hold** event

**Changed**&#x20;

- Updated API branding from ADI to **Account Protection**
:::

