# Identities

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