# Data Management
source: https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/index.md

## Overview {#overview}

The use cases in this section provide various scenarios for updating and retrieving data of the CMS objects:

* client
* account contract
* card contract

Each use case provides the following information:

* A brief description of the use case
* A sequence diagram
* A detailed explanation
* A part of API specification with the endpoint(s) used in the use case

The following use cases are provided in this section:

|             Section              |                                                                                                                     Use case                                                                                                                     |           OperationId           | Method |                            URI                             |
|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|--------|------------------------------------------------------------|
| Data management                  | [Update Client data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/update-client-data/index.md)                                                                                            | updateClient                    | PATCH  | /clients/{client_id}                                       |
|                                  | [Update Account Contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/update-accnt-contract-data/index.md)                                                                          | updateAccountContract           | PATCH  | /accounts/{account_contract_id}                            |
|                                  | [Update Card Contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/update-card-contract-data/index.md)                                                                              | updateCardContract              | PATCH  | /cards/{card_contract_id}                                  |
|                                  | [Relink Account Contract to another Client](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/relink-acct-con-another-client/index.md)                                                         | changeAccountContractClient     | PUT    | /accounts/{account_contract_id}/client-identifier          |
|                                  | [Relink Subaccount to another parent Account Contract and Client](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/relink-subacct-another-par-acct-con/index.md)                              | changeContractMainContract      | PUT    | /contracts/{contract_id}/main-contract                     |
|                                  | [Relink Card Contract to another Client](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/relink-card-con-another-client/index.md)                                                            | changeCardContractClient        | PUT    | /cards/{card_contract_id}/client-identifier                |
|                                  | [Relink Card contract to another Account contract](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/relink-card-con-another-acc-con/index.md)                                                 | changeCardContractMainContract  | PUT    | /cards/{card_contract_id}/main-contract                    |
|                                  | [Add or update Custom Data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/add-update-custom-data/index.md)                                                                                 | setClientCustomData             | POST   | /clients/{client_id}/custom-data                           |
|                                  |                                                                                                                                                                                                                                                  | setContractCustomData           | POST   | /contracts/{contract_id}/custom-data                       |
|                                  | [Add an Address](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/add-an-address/index.md)                                                                                                    | addClientAddress                | POST   | /clients/{client_id}/addresses                             |
|                                  |                                                                                                                                                                                                                                                  | addContractAddress              | POST   | /contracts/{contract_id}/addresses                         |
|                                  | [Update an Address](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/update-an-address/index.md)                                                                                              | updateClientAddress             | PUT    | /clients/{client_id}/addresses/{address_type}              |
|                                  |                                                                                                                                                                                                                                                  | updateContractAddress           | PUT    | /contracts/{contract_id}/addresses/{address_type}          |
| Query CMS to get particular data | [Retrieve Client data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-client-data/index.md)                                                          | getClient                       | GET    | /clients/{client_id}                                       |
|                                  | [Retrieve Account contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-acct-con-data/index.md)                                              | getAccountContract              | GET    | /accounts/{account_contract_id}                            |
|                                  | [Retrieve a list of Card Plastics](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-list-of-card-plastics/index.md)                                    | getCardPlastics                 | GET    | /cards/{card_contract_id}/plastics                         |
|                                  | [Retrieve CVC2](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-cvc2/index.md)                                                                        | getCVC                          | POST   | /cards/{card_contract_id}/card-verification-codes/searches |
|                                  | [Retrieve a list of Account Contracts for a Client](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-list-acc-contracts-for-client/index.md)           | getAccountContractsByClient     | GET    | /clients/{client_id}/account-contracts                     |
|                                  | [Retrieve a list of Card Contracts for a Client](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-list-card-contracts-for-client/index.md)             | getCardContractsByClient        | GET    | /clients/{client_id}/card-contracts                        |
|                                  | [Retrieve technical Accounts](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-technical-acc/index.md)                                                 | getTechnicalAccounts            | GET    | /contracts/{contract_id}/technical-accounts                |
|                                  | [Retrieve Contract tree structure summary](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-con-tree-struct-summary/index.md)                          | getContractTreeSummary          | GET    | /contracts/{contract_id}/tree-summaries                    |
|                                  | [Retrieve Account Contract or Card Contract status](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-acc-or-card-con-status/index.md)                  | getAccountContractStatus        | GET    | /accounts/{account_contract_id}/statuses                   |
|                                  |                                                                                                                                                                                                                                                  | getCardContractStatus           | GET    | /cards/{card_contract_id}/statuses                         |
|                                  | [Retrieve Subaccounts](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-subacc/index.md)                                                               | getSubAccountContracts          | GET    | /accounts/{account_contract_id}/sub-accounts               |
|                                  | [Retrieve a list of Card Contracts for an Account Contract](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-list-card-contracts-for-acc-con/index.md) | getCardContractsByAccount       | GET    | /accounts/{account_contract_id}/card-contracts             |
|                                  | [Retrieve Custom Data](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-custom-data/index.md)                                                          | getClientCustomData             | GET    | /clients/{client_id}/custom-data/{tag_name}                |
|                                  |                                                                                                                                                                                                                                                  | getContractCustomData           | GET    | /contracts/{contract_id}/custom-data/{tag_name}            |
|                                  | [Retrieve Addresses](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-addresses/index.md)                                                              | getClientAddresses              | GET    | /clients/{client_id}/addresses                             |
|                                  |                                                                                                                                                                                                                                                  | getContractAddresses            | GET    | /contracts/{contract_id}/addresses                         |
|                                  | [Retrieve financial information](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-fin-info/index.md)                                                   | getContractFinancials           | GET    | /contracts/{contract_id}/financials                        |
|                                  | [Retrieve Contract's balances](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-con-balances/index.md)                                                 | getContractBalances             | GET    | /contracts/{contract_id}/balances                          |
|                                  | [Retrieve authentication parameter's value](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-auth-para-value/index.md)                                 | getAuthenticationParameterValue | GET    | /contracts/{contract_id}/authentication-parameter-values   |
|                                  | [Retrieve Tariffs](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-tariffs/index.md)                                                                  | getContractTariffData           | GET    | /contracts/{contract_id}/tariff-data                       |

