# Adds address validation errors for CMRAs and registered agents to Accounts v1 and Accounts v2

## What’s new

Adds two values to the [requirements.errors[].code](https://docs.stripe.com/api/accounts/object.md?api-version=2026-09-30.endive#account_object-requirements-errors-code) and [future_requirements.errors[].code](https://docs.stripe.com/api/accounts/object.md?api-version=2026-09-30.endive#account_object-future_requirements-errors-code) enum properties on v1 objects, and to the [requirements.entries[].errors[].code](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-code) and [future_requirements.entries[].errors[].code](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-code) enum properties on v2 Accounts:

- `invalid_address_cmra_address`: Returned when an account’s address is identified as a Commercial Mail Receiving Agency (CMRA) or virtual mailbox address. To resolve this error, the account holder must update their address.
- `invalid_address_registered_agent_address`: Returned when an account’s address is identified as a registered agent address. To resolve this error, the account holder can update their address or upload a proof-of-address document.

For GA users, these new values provide more specific errors when we can’t accept an account address.

## Why is this a breaking change?

Integrations that read requirement error codes from Accounts v1 or Accounts v2 can now receive `invalid_address_cmra_address` and `invalid_address_registered_agent_address`. If your code uses strict enum matching or doesn’t handle unknown error codes, it can fail when it encounters these values.

## Impact

If your integration reads requirement errors from a v1 [Account](https://docs.stripe.com/api/accounts/object.md?api-version=2026-09-30.endive), a v1 [Bank Account](https://docs.stripe.com/api/customer_bank_accounts/object.md?api-version=2026-09-30.endive), a v1 [Capability](https://docs.stripe.com/api/capabilities/object.md?api-version=2026-09-30.endive), a v1 [Person](https://docs.stripe.com/api/persons/object.md?api-version=2026-09-30.endive), or a [v2 Account](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-09-30.endive), update its error-handling logic to support `invalid_address_cmra_address` and `invalid_address_registered_agent_address`. Review [address validation for commercial compliance](https://docs.stripe.com/issuing/commercial-compliance/address-validation.md) for integration guidance.

## Changes

#### REST API

| Values | Change | Enums |
| --- | --- | --- |
| `invalid_address_cmra_address`, `invalid_address_registered_agent_address` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-requirements-errors-code), [Capability.future_requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-future_requirements-errors-code), [Capability.requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-requirements-errors-code), [Person.future_requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-future_requirements-errors-code), [Person.requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-requirements-errors-code), [V2.Core.Account.future_requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-code), [V2.Core.Account.requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-code) |

#### Ruby

This change does not affect the Ruby SDK.

#### Python

| Values | Change | Enums |
| --- | --- | --- |
| `invalid_address_cmra_address`, `invalid_address_registered_agent_address` | Added | [Account.FutureRequirement.Error.code](/api/accounts/object?api-version=2026-09-30.endive#account_object-future_requirements-errors-code), [Account.Requirement.Error.code](/api/accounts/object?api-version=2026-09-30.endive#account_object-requirements-errors-code), [BankAccount.FutureRequirement.Error.code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-future_requirements-errors-code), [BankAccount.Requirement.Error.code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-requirements-errors-code), [Capability.FutureRequirement.Error.code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-future_requirements-errors-code), [Capability.Requirement.Error.code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-requirements-errors-code), [Person.FutureRequirement.Error.code](/api/persons/object?api-version=2026-09-30.endive#person_object-future_requirements-errors-code), [Person.Requirement.Error.code](/api/persons/object?api-version=2026-09-30.endive#person_object-requirements-errors-code), [V2.Core.Account.FutureRequirement.Entry.Error.code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-code), [V2.Core.Account.Requirement.Entry.Error.code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-code) |

#### PHP

| Values | Change | Enums |
| --- | --- | --- |
| `invalid_address_cmra_address`, `invalid_address_registered_agent_address` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-requirements-errors-code), [Capability.future_requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-future_requirements-errors-code), [Capability.requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-requirements-errors-code), [Person.future_requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-future_requirements-errors-code), [Person.requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-requirements-errors-code), [V2.Core.Account.future_requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-code), [V2.Core.Account.requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-code) |

#### Java

This change does not affect the Java SDK.

#### Node.js

| Values | Change | Enums |
| --- | --- | --- |
| `invalid_address_cmra_address`, `invalid_address_registered_agent_address` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2026-09-30.endive#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-requirements-errors-code), [Capability.future_requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-future_requirements-errors-code), [Capability.requirements.errors[].code](/api/capabilities/object?api-version=2026-09-30.endive#capability_object-requirements-errors-code), [Person.future_requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-future_requirements-errors-code), [Person.requirements.errors[].code](/api/persons/object?api-version=2026-09-30.endive#person_object-requirements-errors-code), [V2.Core.Account.future_requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-code), [V2.Core.Account.requirements.entries[].errors[].code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-code) |

#### Go

| Values | Change | Enums |
| --- | --- | --- |
| `invalid_address_cmra_address`, `invalid_address_registered_agent_address` | Added | [BankAccountFutureRequirementsErrors.Code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-future_requirements-errors-Code), [BankAccountRequirementsErrors.Code](/api/customer_bank_accounts/object?api-version=2026-09-30.endive#customer_bank_account_object-requirements-errors-Code), [V2CoreAccountFutureRequirementsEntryError.Code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-future_requirements-entries-errors-Code), [V2CoreAccountRequirementsEntryError.Code](/api/v2/core/accounts/object?api-version=2026-09-30.endive#v2_account_object-requirements-entries-errors-Code) |

#### .NET

This change does not affect the .NET SDK.

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench.
2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
   - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-09-30.endive`
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Ruby SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Python SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your PHP SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Java SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Node SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Go SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your .NET SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

## Related changes

- [Adds rejected status for Accounts v2 capabilities](https://docs.stripe.com/changelog/endive/2026-09-30/rejected-accounts-v2-capabilities.md)
- [Replaces the generic fraud rejection reason with more granular fraud reasons](https://docs.stripe.com/changelog/endive/2026-09-30/updated-reject-reason-codes.md)
- [Removes the configurations parameter from the Account Links v2 API](https://docs.stripe.com/changelog/endive/2026-09-30/removes-configurations-parameter-from-v2-core-account-links-api.md)
- [Standardizes SEPA Direct Debit payment settings in the Accounts API](https://docs.stripe.com/changelog/endive/2026-09-30/sepa-debit-settings-accounts.md)
- [Shows errors for eventually due requirements](https://docs.stripe.com/changelog/endive/2026-09-30/shows-errors-for-eventually-due-requirements.md)
- [Distinguishes platform-initiated account rejections from Stripe rejections](https://docs.stripe.com/changelog/endive/2026-09-30/platform-rejection-reasons.md)
- [Adds additional shared fields to customer sharing](https://docs.stripe.com/changelog/endive/2026-09-30/additional-shared-fields-customer-sharing.md)