---
title: "Get account dormancy"
method: GET
path: "/corporate/v1/account-dormancy/{externalAccountId}"
tags: ["Dormancy"]
---

# Get account dormancy

`GET /corporate/v1/account-dormancy/{externalAccountId}`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/corporate/v1/account-dormancy/{externalAccountId}`
- Auth: HTTP bearer

Retrieves an account dormancy configuration by the account external ID.

## Path parameters

- `externalAccountId` string, required

## Response `200`

OK

- GetAccountDormancyResponse: Get account-dormancy-control response object
  - `id` string, uuid: Account dormancy control ID generated internally
  - `external_account_id` string: Custom account ID. Used as the key for all operations (manage accounts, transactions, etc.) on the corporate layer. This field is: - Unique within the Organization - Immutable: The field cannot be updated. - Not recyclable: You can't reuse an external account ID, even if the account that was using it has been canceled.
  - `account_id` integer: Account ID
  - `dormancy_config_id` string, uuid: Dormancy configuration ID generated internally
  - `inactive_since` string: Date of the last time the account had any activities. Format = yyyy-mm-dd:hr:mm:ss.
  - `inactivity_time` integer: Number of days the account has been inactive.<br> `inactivity_time` is calculated as `current_datetime` - `inactive_since` in UTC timezone.
  - `target_type` 'DIVISION' | 'PROGRAM': Dormancy configuration target
  - `target_id` string: Target ID. When `target_type` is `DIVISION`, this value is the division code. Likewise, when `target_type` is `PROGRAM`, the value is the program ID, and so on.

## Other responses

- `400`: Bad request
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/banking-transaction-banking.md) - [All operations](https://skmtc.dev/pismo/apis/banking-transaction-banking/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-transaction-banking/revisions/1334306c9303?raw)
