# List stored settings

Source: https://api-docs.magicdoor.com/api-reference/settings/list-stored-settings

Returns every row the company has actually saved for one settings type — the company-level row and all overrides, flat and unresolved. Rows the company has never saved are simply absent; nothing is filled in with defaults. Requires the `settings:read` permission.

`GET https://services.magicdoor.com/settings/company-portal/settings/{settingsType}/all`

**Authentication:** bearer token in the `Authorization` header, as `Bearer <token>`.

## Path parameters

- `settingsType` (enum<string>, required) — Which family of settings to act on. Matched case-insensitively against the registered settings types. One of: `achpaymentprocessing`, `agentschat`, `associationviolation`, `autopayincentives`, `chat`, `chatai`, `chatailease`, `chataileaserenewal`, `chataileaserentersinsurance`, `chataimaintenancerequests`, `chataitranslation`, `communications`, `company`, `contribution`, `depositpayment`, `distribution`, `email`, `emailnotification`, `latefees`, `leasechartofaccount`, `leaseinvoice`, `leaserenewal`, `leaserentersinsurance`, `maintenancerequest`, `maintenancerequestrunbook`, `managementfee`, `outgoingpayments`, `property`, `rentalapplication`, `rentalapplicationbilling`, `rentalapplicationchartofaccount`, `rentalapplicationgeneral`, `rentalapplicationpayment`, `rentalapplicationpaymentaccount`, `rentalapplicationquestionnaire`, `rentalapplicationscreening`, `rentpayment`, `rentpaymentfailurefee`, `rentpaymentnotification`, `rentpaymentprocessingfees`, `syndication`, `tenantautopayfailednotification`, `tenantpaymentreminder`, `text`, `workorder`. Example: `property`.

## Example request

```bash
curl --request GET \
  --url 'https://services.magicdoor.com/settings/company-portal/settings/property/all' \
  --header 'Authorization: Bearer <token>'
```

## Responses

### 200 — Every stored row, in no guaranteed order. Empty when nothing has been saved.

- `…settings properties` (object) — Each array element carries the properties of the chosen settings type at its top level, alongside the three fields below.
- `level` (enum<string>) — The kind of entity this stored row is attached to. One of: `company`, `portfolio`, `property`, `unit`, `lease`.
- `levelId` (string) — The id of the entity this stored row is attached to. At company level this is the company's own id.
- `groupId` (string) — Identifies rows written together by a single multi-target override call. Absent on rows written on their own.

```json
[
  {
    "reserve": 350,
    "ownerApprovalLimit": 500,
    "vendorApprovalLimit": 250,
    "level": "company",
    "levelId": "1830472847398404096"
  },
  {
    "reserve": 500,
    "ownerApprovalLimit": 1000,
    "vendorApprovalLimit": 250,
    "level": "property",
    "levelId": "1842918365109710848",
    "groupId": "9f3c1a72-5f18-4b6d-9f0a-2c3d4e5f6a7b"
  }
]
```

### 401 — The access token is missing, expired, or invalid.

### 403 — The caller does not hold the `settings:read` permission.

### 404 — No settings type is registered under the `settingsType` in the URL.

```json
{
  "type": "https://httpstatuses.com/404",
  "title": "Not Found",
  "status": 404,
  "detail": "Unknown settings type: propertysettings",
  "instance": "/company-portal/settings/propertysettings/company",
  "traceId": "0HN7GK9C2M4PQ"
}
```