---
title: "Retrieve registration settings"
method: GET
path: "/api/oianalytics/registration"
tags: ["OIAnalytics Registration"]
---

# Retrieve registration settings

`GET /api/oianalytics/registration`

Returns the current OIAnalytics registration settings

## Response `200`

The registration settings

- RegistrationSettingsDTO — Registration settings Data Transfer Object. Represents the registration settings for the engine.
  - `id` string, required — The unique identifier of the entity.
  - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
    - `id` string, required — The unique identifier of the user.
    - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
  - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
    - `id` string, required — The unique identifier of the user.
    - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
  - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
  - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
  - `host` string, required — The host URL for registration.
  - `activationCode` string, nullable, required — The activation code for registration.
  - `status` 'NOT_REGISTERED' | 'PENDING' | 'REGISTERED', required — Type representing a registration status.
  - `activationDate` string, required — Represents an instant in time as an ISO 8601 string.
  - `activationExpirationDate` string — Represents an instant in time as an ISO 8601 string.
  - `checkUrl` string, nullable, required — The URL to check registration status.
  - `useProxy` boolean, required — Whether to use a proxy for registration.
  - `proxyUrl` string, nullable, required — The proxy URL for registration.
  - `proxyUsername` string, nullable, required — The username for proxy authentication.
  - `useApiGateway` boolean, required — Whether to use an API Gateway
  - `apiGatewayHeaderKey` string, nullable, required — The header key for the API gateway
  - `apiGatewayBaseEndpoint` string, nullable, required — The base endpoint used by the API gateway
  - `acceptUnauthorized` boolean, required — Whether to accept unauthorized certificates.
  - `commandRefreshInterval` number, double, required — The interval in seconds for refreshing commands.
  - `commandRetryInterval` number, double, required — The interval in seconds for retrying commands.
  - `messageRetryInterval` number, double, required — The interval in seconds for retrying messages.
  - `commandPermissions` object, required — Permissions for various commands.
    - `updateNorthCacheContent` boolean, required — Permission to remove cache content.
    - `getNorthCacheFileContent` boolean, required — Permission to get cache file content.
    - `searchNorthCacheContent` boolean, required — Permission to search cache content.
    - `updateHistoryCacheContent` boolean, required — Permission to move cache content.
    - `getHistoryCacheFileContent` boolean, required — Permission to get cache file content.
    - `searchHistoryCacheContent` boolean, required — Permission to search cache content.
    - `setpoint` boolean, required — Permission to apply setpoints.
    - `deleteNorth` boolean, required — Permission to delete a north connector.
    - `updateNorth` boolean, required — Permission to update a north connector.
    - `createNorth` boolean, required — Permission to create a north connector.
    - `createOrUpdateSouthItemsFromCsv` boolean, required — Permission to create or update south items from CSV.
    - `deleteSouth` boolean, required — Permission to delete a south connector.
    - `updateSouth` boolean, required — Permission to update a south connector.
    - `createSouth` boolean, required — Permission to create a south connector.
    - `createOrUpdateHistoryItemsFromCsv` boolean, required — Permission to create or update history items from CSV.
    - `deleteHistoryQuery` boolean, required — Permission to delete a history query.
    - `updateHistoryQuery` boolean, required — Permission to update a history query.
    - `createHistoryQuery` boolean, required — Permission to create a history query.
    - `deleteCertificate` boolean, required — Permission to delete a certificate.
    - `updateCertificate` boolean, required — Permission to update a certificate.
    - `createCertificate` boolean, required — Permission to create a certificate.
    - `deleteIpFilter` boolean, required — Permission to delete an IP filter.
    - `updateIpFilter` boolean, required — Permission to update an IP filter.
    - `createIpFilter` boolean, required — Permission to create an IP filter.
    - `deleteScanMode` boolean, required — Permission to delete a scan mode.
    - `updateScanMode` boolean, required — Permission to update a scan mode.
    - `createScanMode` boolean, required — Permission to create a scan mode.
    - `updateRegistrationSettings` boolean, required — Permission to update registration settings.
    - `updateEngineSettings` boolean, required — Permission to update engine settings.
    - `regenerateCipherKeys` boolean, required — Permission to regenerate cipher keys.
    - `restartEngine` boolean, required — Permission to restart the engine.
    - `updateVersion` boolean, required — Permission to update the engine version.

---

[API](https://skmtc.net/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.net/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/fe8fd32c9fdc/schema)