---
title: "Get an app's exclusions, or the built-in default when it has none saved"
method: GET
path: "/api/{org_id}/rum/analytics/settings"
tags: ["Product Analytics"]
---

# Get an app's exclusions, or the built-in default when it has none saved

`GET /api/{org_id}/rum/analytics/settings`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/rum/analytics/settings`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/rum/analytics/settings/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Query parameters

- `app` string, required

## Response `200`

Success

- AppSettings: An app's exclusions; with no stored row, `id` and the audit fields are null and `version` 0.
  - `app` string, required
  - `bots` boolean, required
  - `builtinBots` BuiltinBots, required: The `builtinBots` response field, built from `BUILTIN_BOTS`.
    - `devices` string[], required
    - `families` string[], required
    - `version` integer, required
  - `createdAt` integer, nullable
  - `createdBy` string, nullable
  - `id` string, nullable
  - `pages` PageRule[], required
    - `op` 'eq' | 'prefix' | 'regex', required: How an ignored-page rule compares its value with a page key.
    - `value` string, required
  - `rulesHash` string, required
  - `sessions` SessionRule[], required
    - `field` 'user_agent_user_agent_family' | 'user_agent_os_family' | 'user_agent_device_family' | 'geo_info_country' | 'geo_info_city' | 'usr_id' | 'usr_email' | 'usr_anonymous_id' | 'env' | 'version', required: A built-in session field a rule can select on, named as its `_rumdata` column.
    - `op` 'eq' | 'in' | 'prefix' | 'suffix' | 'contains' | 'regex', required: How a rule value is compared with a field: `in` lists every value, the rest take one each.
    - `values` string[], required
  - `updatedAt` integer, nullable
  - `updatedBy` string, nullable
  - `version` integer, required

## Other responses

- `400`: Invalid app
- `500`: Internal error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)
