---
title: "Retrieve an account mapping association."
method: GET
path: "/v1/persons/{person_id}/deposit_accounts/{account_id}/mappings"
tags: ["Savings Accounts"]
---

# Retrieve an account mapping association.

`GET /v1/persons/{person_id}/deposit_accounts/{account_id}/mappings`

Returns the details of a savings account mapping, including the associated main account IBAN and the currently assigned interest tier.

## Path parameters

- `person_id` string, required
- `account_id` string, required

## Response `200`

The mapping association was retrieved successfully.

- GetDepositAccountMappingResponse
  - `id` string, required — Mapping Id of this account association.
  - `main_account_id` string — ID of the internal main account.
  - `main_account_iban` string — IBAN of the external main account.
  - `deposit_account_id` string — ID of the savings account.
  - `status` 'OPENED' | 'TAX_REGISTERED' | 'ACTIVE' | 'INACTIVE' | 'FAILED', required — The current status of the savings account.
  - `deposit_type` 'SAVINGS_ACCOUNT', required — The account type.
  - `interest_tier` 'INTEREST_BASE_TIER' | 'INTEREST_TIER_1' | 'INTEREST_TIER_2' | 'INTEREST_TIER_3' | 'INTEREST_TIER_4' | 'INTEREST_TIER_5' — Tier to which the savings account belongs. **Note:** If you've configured multiple standard interest rates (tiered interest rates), send the interest tier value in this field. If no value is sent, the system will default to the base tier.

## Other responses

- `404` — The provided resource could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)
