---
title: "Get global DQ settings"
method: GET
path: "/settings"
tags: ["Settings"]
---

# Get global DQ settings

`GET /settings`

Returns the current value of all global DQ settings exposed on the public API.

**Permissions**
- **Required:** `DATA_QUALITY`
- **Global bypass:**
  - `DATA_QUALITY` and `VIEW_PERMISSIONS_VIEW_ALL`
  - `DATA_QUALITY` and `RESOURCE_MANAGE_ALL`

## Response `200`

Settings retrieved successfully.

- Settings — Current values of all global DQ settings exposed on the public API.
  - `passingThreshold` integer, required — Global passing score threshold. Scores at or above this value are considered passing (green). Must be greater than failingThreshold.
  - `failingThreshold` integer, required — Global failing score threshold. Scores below this value are considered failing (red). Must be less than passingThreshold.
  - `lookbackLimit` integer, required — Maximum number of historical rule runs used when computing DQ scores.
  - `observationLimit` integer, required — Maximum number of rows processed per rule execution.
  - `previewLimit` integer, required — Maximum number of results shown in the dataset overview and rule workbench. UI-only — does not affect what is stored. Recommended values are 25, 50, 100, 250, or 500. If a different value is provided, it is rounded to the closest recommended value.
  - `breakRecordsLimit` integer, required — Maximum number of records returned when fetching break records for a rule. UI-only — does not affect what is stored. Recommended values are 25, 50, 100, 250, or 500. If a different value is provided, it is rounded to the closest recommended value.
  - `ruleRunTimeLimit` integer, required — Maximum time in minutes a rule is allowed to run before it is automatically timed out.
  - `jobLogRetentionHours` integer, required — Job log retention period in hours. Must be a multiple of 24 (minimum 1 day, maximum 30 days).
  - `platformLogRetentionHours` integer, required — Platform log retention period in hours. Must be a multiple of 24 (minimum 1 day, maximum 30 days).
  - `mapToPrimaryColumn` boolean, required — When enabled, rules are automatically mapped to the primary column of the dataset.
  - `mandatoryPrimaryRuleColumn` boolean, required — When enabled, a primary column must be set on every rule before it can be saved.
  - `mandatoryRuleDimension` boolean, required — When enabled, a dimension must be assigned to every rule before it can be saved.
  - `showDetailedException` boolean, required — When enabled, detailed exception stack traces are included in error responses. Recommended for non-production environments only.

## Other responses

- `401` — Unauthorized — authentication is required or the provided credentials are invalid.
- `403` — Forbidden — insufficient permissions.
- `500` — Internal Server Error

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)