---
title: "List Observe company fields"
method: GET
path: "/api/v1/ackdb/observe/companies/fields"
tags: ["ackDB"]
---

# List Observe company fields

`GET /api/v1/ackdb/observe/companies/fields`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/observe/companies/fields`
- Auth: HTTP bearer

Returns the field catalog for company filtering/sorting/projection - system attributes, registered traits (scope=entity), and event types - each with coverage, legal operators, and value type.

## Response `200`

The field catalog (may be coverage-ordered).

- object
  - `data` AckdbFieldDescriptor[], required
    - `key` string, required
    - `label` string, required
    - `group` 'system' | 'trait' | 'event', required
    - `valueType` 'string' | 'number' | 'boolean' | 'date' | 'string_array', required
    - `source` string, required
    - `coverage` integer, required
    - `sortable` boolean, required
    - `filterable` boolean, required
    - `operators` string[], required: Operators legal for this field (trait/attribute operators or event predicates).
    - `allowedValues` unknown[]: Enum constraint from the trait definition, if any.
      - unknown
    - `distinctValuesUrl` string: Present only when the field supports a distinct-value picker (string/string_array traits, whitelisted system attributes, string/string_array emf__ columns) - the grain-correct URL to fetch values from. Absent means free-text input.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)