---
title: "The catalog surface visible to this key: entities with typed column_info (type, operators, aggregates), metrics, and a trimmed request vocabulary. Identity-free; never consumes quota."
method: GET
path: "/v1/entities"
---

# The catalog surface visible to this key: entities with typed column_info (type, operators, aggregates), metrics, and a trimmed request vocabulary. Identity-free; never consumes quota.

`GET /v1/entities`

## Request

- Base URL: `https://api.instabug.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.instabug.com/v1/entities`
- Auth: HTTP bearer

## Response `200`

Entity listing (/v1 shape)

- PublicEntitiesResponse
  - `catalog_version` string, required
  - `entities` PublicEntity[], required
    - `column_info` ColumnInfo[], required
      - `aggregates` string[], required
      - `deprecated` DeprecationInfo
        - `date` string, required
        - `replacement` string
      - `description` string
      - `name` string, required
      - `operators` string[], required
      - `select_only` boolean
      - `single_key` boolean
      - `type` string, required
    - `level` string, required
    - `metrics` string[], required
    - `name` string, required
    - `pinned_conditions` object
  - `limits` Limits, required
    - `default_rows` integer, required
    - `max_rows` integer, required
    - `max_top_n` integer, required
  - `vocabulary` Vocabulary, required
    - `compare_periods` string[], required
    - `having_operators` string[], required
    - `time_buckets` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: Key does not cover the application, entity scope, or level
- `429`: Rate limited or too many concurrent queries. details.reason says which (rate_limit | concurrency); Retry-After says when to retry. The monthly quota never rejects

---

[API](https://skmtc.dev/instabug/apis/luciq-query-api.md) - [All operations](https://skmtc.dev/instabug/apis/luciq-query-api/llms.txt) - [OpenAPI document](https://skmtc.dev/instabug/apis/luciq-query-api/revisions/e446f3c9b6b4?raw)