---
title: "Get customer settings"
method: GET
path: "/v1/settings/1nceos"
tags: ["Settings"]
---

# Get customer settings

`GET /v1/settings/1nceos`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/settings/1nceos`
- Auth: HTTP bearer

Gets customer settings related to 1NCE OS.

## Query parameters

- `pageSize` integer
- `page` integer
- `language` 'en' | 'de'

## Response `200`

OK

- GetResponseschema11: Get customer settings filtered by feature flags.
  - `items` GetResponseschema11ItemsInner[], required: List of settings.
    - `name` string, required: Name of the setting.
    - `description` string, required: Description of the setting.
    - `state` 'ENABLED' | 'DISABLED', required: State of the setting.
    - `details` GetResponseschema11ItemsInnerDetails: Details of the setting.
      - `credits` number: Credits remaining for ADVANCED_CELL_TOWER_LOCATION resolutions
      - `expiryDate` object: Expiry date of credits for ADVANCED_CELL_TOWER_LOCATION resolutions
      - `mode` 'CUSTOM' | 'DEFAULT': Operating mode of the setting. Present only for whitelisted settings that have a mode configured.
      - `frequency` integer: Global cell-tower resolution frequency in minutes (60-1440 inclusive).
  - `page` number, required: The number corresponding to the page for which data was requested.
  - `pageAmount` number, required: Total amount of pages to be queried using the given pageSize.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)