# Retrieve Subaccounts
source: https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-subacc/index.md

## Overview {#overview}

This use case describes how you fetch a detailed list of subaccounts created under the specified account contract in the CMS.

## Sequence diagram {#sequence-diagram}

Diagram retrieve-subacc

### Explanation {#explanation}

1. The server sends a `GET` request to the `/accounts/{account_contract_id}/sub-accounts` endpoint to fetch a list of subaccounts associated with the `account_contract_id` in the CMS.
2. The API returns a summary of contracts under the `contract_id` stored in the CMS. Refer to [Endpoint](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-subacc/index.md#endpoint) to check the complete list of data returned by the endpoint. Tip: The operation supports [pagination](https://developer.mastercard.com/mastercard-processing-core/documentation/api-basics-section/pagination-filtering/index.md). Refer to [Sandbox testing](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-subaccounts/index.md) for information on how to execute the use case in the Sandbox environment.

## Endpoint {#endpoint}


API Reference: `GET /accounts/{account_contract_id}/sub-accounts`