GetSettings

[POST] .../v1/firm/getsettings

Returns settings enterprise. Use this method to read firm-level settings after selecting a company or before editing configuration values. The request requires firm_id as a Equal filter and the response returns setting id, key, translated name, data type, value and last_update. The caller must have firm select permission; missing body, invalid firm_id, denied access, missing settings and storage errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.

Filterable Fields

Field Type Description
firm_id int Firm ID.

Request Example

{
  "filters": [
    {
      "field": "firm_id",
      "operator": "Equal",
      "value": "2"
    }
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Array of FirmSetting Result object.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 41,
      "key": "rounding_enabled",
      "name": "Rounding enabled",
      "value": "true",
      "name_var": "ROUNDING_ENABLED",
      "dataType": "bool",
      "last_update": 1712345600
    }
  ]
}