# Identities (v3)

**Note:** **Identity Management v3** is scheduled for release in **March 2026**. For early access or specific migration details, please contact your Ripple representative.
    
Use these API operations to manage your identities with **Identity Management v3** (recommended for all new integrations).

For more information about identity management, see [Payment identities](/products/payments-direct-2/@v2026.03/api-docs/concepts/payment-identities) and [Financial instruments](/products/payments-direct-2/@v2026.03/api-docs/concepts/financial-instruments).

| Operation | Method | Description |
| --- | --- | --- |
| [Create an identity (v3)](./#operation/createIdentity) | POST | Create a new identity (INDIVIDUAL/BUSINESS; ORIGINATOR/BENEFICIARY). |
| [Get a list of identies (v3)](./#operation/getIdentities) | GET | Retrieve a list of identities with optional filters (e.g., `paymentRole`, `identityType`). |
| [Get an identity by ID (v3)](./#operation/getIdentityById) | GET | Retrieve a specific identity by `identityId` (latest version by default). |
| [Update an identity (v3)](./#operation/putIdentity) | PUT | Update one or more fields; creates a new version. |
| [Deactivate an identity (v3)](./#operation/deactivateIdentityV3) | DELETE | Set the identity state to `DEACTIVATED` (cannot be used for new payments). |
| [Add a financial instrument (v3)](./#operation/createFinancialInstrument) | POST | Add a financial instrument to an identity. |
| [Get a list of financial instruments (v3)](./#operation/getFinancialInstruments) | GET | Get a list of financial instruments for an identity. |
| [Get a financial instrument by ID (v3)](./#operation/getFinancialInstrumentById) | GET | Get a specific financial instrument by `financialInstrumentId`. |
| [Update a financial instrument (v3)](./#operation/putFinancialInstrument) | PUT | Update a financial instrument by `financialInstrumentId`. |
| [Deactivate a financial instrument (v3)](./#operation/deactivateFinancialInstrumentV3) | DELETE | Deactivate a financial instrument by `financialInstrumentId`. |