---
title: "Get Company Watchlist Entries"
method: GET
path: "/watchlists/companies/{id_or_urn}/entries"
tags: ["companies"]
---

# Get Company Watchlist Entries

`GET /watchlists/companies/{id_or_urn}/entries`

## Request

- Base URL: `https://api.harmonic.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.harmonic.ai/watchlists/companies/{id_or_urn}/entries`
- Auth: none declared
- TypeScript: <https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/docs/watchlists/companies/:id_or_urn/entries/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id_or_urn` union, required
  - integer
  - string, uuid
  - string

## Query parameters

- `page` integer, nullable: Page number
- `size` integer: Page size
- `sort_field` string: Sort field
- `sort_descending` boolean: Is sort order descending
- `search_query` string, nullable: Search query
- `cursor` string, nullable: After cursor
- `sort_custom_field_urn` union: Sort by a built-in field URN, custom-field URN, or record/list attribute URN (e.g. urn:harmonic:company_field:company_name or urn:harmonic:record_attribute:company:name).
  - string
  - string
  - string
  - string
  - string

## Response `200`

Successful Response

- GetCompanyWatchlistEntriesOutput
  - `entries` CompanyWatchlistEntry[]
    - `company_urn` string, required
    - `watchlist_urn` union, required
      - string
      - string
    - `entry_urn` union, required
      - string
      - string
    - `custom_field_values` CompanyListCustomFieldValueOutput[]
      - `created_at` string, required
      - `updated_at` string, required
      - `urn` union, required
        - string
        - string
        - string
        - string
      - `custom_field_urn` union, required
        - string
        - string
        - string
        - string
      - `data` union, required
        - CheckboxListCustomFieldValue
          - `value` boolean, nullable
        - NumberListCustomFieldValue
          - `value` number, nullable
        - TextListCustomFieldValue
          - `value` string, nullable
        - SingleListSelectCustomFieldValue
          - `value` string, nullable
        - MultiSelectListCustomFieldValue
          - `value` string[]
        - PersonSelectCustomFieldValue
          - `value` string[]
        - RecordReferenceListCustomFieldValue
          - `value` string[]
        - DateListCustomFieldValue
          - `value` string, nullable
        - WebsiteListCustomFieldValue
          - `value` string, nullable
        - StatusListCustomFieldValue
          - `value` string, nullable
      - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'SINGLE_SELECT' | 'MULTI_SELECT' | 'PERSON' | 'WEBSITE' | 'CHECKBOX' | 'STATUS' | 'RECORD_REFERENCE', required
    - `entry_created_at` string, date-time, required
    - `entry_updated_at` string, date-time, required
    - `cursor` string, nullable
    - `added_by` string, nullable
  - `page_info` PaginationMetadata
    - `next` string, nullable
    - `current` string, nullable
    - `has_next` boolean, required
  - `total_count` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-16** `c6f98176f3d7`: 1 info
  - added `subschema #4: IntegrationAttributeUrn` to the `entries/items/custom_field_values/items/custom_field_urn` response property `anyOf` list for the response status `200`
- **2026-08-19** `fbef1ba78f96`: 3 info
  - removed `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue` from the `entries/items/custom_field_values/items/data` response property `anyOf` list for the response status `200`
  - removed the `EMAIL` enum value from the `entries/items/custom_field_values/items/type` response property for the response status `200`
  - removed the `OWNER` enum value from the `entries/items/custom_field_values/items/type` response property for the response status `200`
- **2026-08-19** `2100d53a6676`: 2 warning, 1 info
  - added the new `EMAIL` enum value to the `entries/items/custom_field_values/items/type` response property for the response status `200`
  - added the new `OWNER` enum value to the `entries/items/custom_field_values/items/type` response property for the response status `200`
  - added `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue` to the `entries/items/custom_field_values/items/data` response property `anyOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/changes/watchlists/companies/:id_or_urn/entries/get.md)

---

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