Harmonic.ai

Harmonic REST & GraphQL API

REST API for company search, enrichment, saved searches, list management, and bulk operations, plus a full GraphQL endpoint for flexible queries across companies, people, investors, lists, and custom fields. Auth via apikey header or OAuth 2.0 bearer tokens.

Documentation GitHub OpenAPI

Documentation

https://console.harmonic.ai/docs/api-reference/introduction

https://console.harmonic.ai/docs/api-reference/introduction

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/authentication/harmonic-ai-authentication.yml

Specifications

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-companies-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-persons-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-people-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-saved-searches-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-search-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-enrichment-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-email-enrichment-api-openapi.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-attachments-api-openapi.yml

Other Resources

https://api.harmonic.ai/graphql

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/conventions/harmonic-ai-conventions.yml

https://www.postman.com/harmonic-ai/harmonic/overview

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/data-model/harmonic-ai-data-model.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/errors/harmonic-ai-problem-types.yml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/overlays/harmonic-ai-security-overlay.yaml

https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/apis.yml

OpenAPI Specification

openapi: 3.1.0
info:
  title: Harmonic.ai Public companies API
  version: 0.0.1
  description: Public API documentation for Harmonic.ai.
tags:
- name: companies
paths:
  /companies:
    get:
      tags:
      - companies
      summary: Batch Get Company By Id Or Urn
      operationId: batch_get_company_by_id_or_urn_companies_get
      parameters:
      - name: ids
        in: query
        required: false
        schema:
          type: array
          items:
            type: integer
          default: []
          title: Ids
      - name: urns
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
          default: []
          title: Urns
      - name: extended
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Extended
      - name: include_fields
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Company fields to fetch.
          title: Include Fields
        description: Company fields to fetch.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - companies
      summary: Get Company By Identifiers
      operationId: get_company_by_identifiers_companies_post
      parameters:
      - name: linkedin_url
        in: query
        required: false
        schema:
          type: string
          description: Company LinkedIn profile URL.
          title: Linkedin Url
        description: Company LinkedIn profile URL.
        example: https://www.linkedin.com/company/facebook
      - name: website_url
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company website URL.
          title: Website Url
        description: Company website URL.
        example: https://www.harmonic.ai
      - name: twitter_url
        in: query
        required: false
        schema:
          type: string
          description: Company twitter URL.
          title: Twitter Url
        description: Company twitter URL.
        example: twitter.com/facebook
      - name: crunchbase_url
        in: query
        required: false
        schema:
          type: string
          description: Company Crunchbase profile URL.
          title: Crunchbase Url
        description: Company Crunchbase profile URL.
        example: https://www.crunchbase.com/organization/amazon
      - name: pitchbook_url
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company, Investor, or Advisor Pitchbook profile URL.
          title: Pitchbook Url
        description: Company, Investor, or Advisor Pitchbook profile URL.
        example: https://pitchbook.com/profiles/company/11919-79
      - name: instagram_url
        in: query
        required: false
        schema:
          type: string
          description: Company Instagram profile URL.
          title: Instagram Url
        description: Company Instagram profile URL.
        example: https://www.instagram.com/allbirds
      - name: facebook_url
        in: query
        required: false
        schema:
          type: string
          description: Company Facebook profile URL.
          title: Facebook Url
        description: Company Facebook profile URL.
        example: https://www.facebook.com/weareallbirds/
      - name: angellist_url
        in: query
        required: false
        schema:
          type: string
          description: Company Angellist profile URL.
          title: Angellist Url
        description: Company Angellist profile URL.
        example: https://angel.co/company/amazon
      - name: monster_url
        in: query
        required: false
        schema:
          type: string
          description: Company Monster profile URL.
          title: Monster Url
        description: Company Monster profile URL.
        example: https://www.monster.com/company/profiles/ikea/
      - name: indeed_url
        in: query
        required: false
        schema:
          type: string
          description: Company Indeed profile URL.
          title: Indeed Url
        description: Company Indeed profile URL.
        example: indeed.com/cmp/Ikea
      - name: stackoverflow_url
        in: query
        required: false
        schema:
          type: string
          description: Company StackOverflow profile URL.
          title: Stackoverflow Url
        description: Company StackOverflow profile URL.
        example: https://www.stackoverflow.com/jobs/companies/3db-labs
      - name: glassdoor_url
        in: query
        required: false
        schema:
          type: string
          description: Company Glassdoor profile URL.
          title: Glassdoor Url
        description: Company Glassdoor profile URL.
        example: https://www.glassdoor.com/Overview/Working-at-3rd-Digital-EI_IE3045173.11,22.htm
      - name: website_domain
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company website domain.
          title: Website Domain
        description: Company website domain.
        example: harmonic.ai
      - name: include_fields
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Company fields to fetch.
          title: Include Fields
        description: Company fields to fetch.
      - name: enrich_missing_company
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Enrich Missing Company
      - name: hide_non_surfaceable_company
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Hide Non Surfaceable Company
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/CompanyOutput'
                - type: 'null'
                title: Response Get Company By Identifiers Companies Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/entries:
    post:
      tags:
      - companies
      summary: Global Import Companies
      description: Import companies with global custom field values
      operationId: global_import_companies_companies_entries_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListEntriesBatchImportInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportCompaniesCanonicalsOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/custom_fields:
    get:
      tags:
      - companies
      summary: Get Global Custom Fields
      operationId: get_global_custom_fields_companies_custom_fields_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /companies/custom_field:
    post:
      tags:
      - companies
      summary: Create Global Custom Field
      operationId: create_global_custom_field_companies_custom_field_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCompanyListCustomFieldInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - companies
      summary: Update Global Custom Field
      operationId: update_global_custom_field_companies_custom_field_put
      parameters:
      - name: custom_field_urn
        in: query
        required: true
        schema:
          anyOf:
          - type: string
            pattern: urn:harmonic:company_list_custom_field:id
            title: CompanyListCustomFieldUrn
          - type: string
            pattern: urn:harmonic:list_attribute:id
            title: ListAttributeUrn
          - type: string
            pattern: urn:harmonic:record_attribute:id
            title: RecordAttributeUrn
          description: Custom field URN
          title: Custom Field Urn
        description: Custom field URN
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCompanyListCustomFieldInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - companies
      summary: Delete Custom Field
      operationId: delete_custom_field_companies_custom_field_delete
      parameters:
      - name: custom_field_urn
        in: query
        required: true
        schema:
          anyOf:
          - type: string
            pattern: urn:harmonic:company_list_custom_field:id
            title: CompanyListCustomFieldUrn
          - type: string
            pattern: urn:harmonic:list_attribute:id
            title: ListAttributeUrn
          - type: string
            pattern: urn:harmonic:record_attribute:id
            title: RecordAttributeUrn
          description: Custom field URN
          title: Custom Field Urn
        description: Custom field URN
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceUrnResponse_Union_CompanyListCustomFieldUrn__ListAttributeUrn__RecordAttributeUrn__'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/batchGet:
    post:
      tags:
      - companies
      summary: Batch Get Companies By Id Or Urn Using Post
      operationId: batch_get_companies_by_id_or_urn_using_post_companies_batchGet_post
      parameters:
      - name: extended
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Extended
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyBatchGetInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyOutput'
                title: Response Batch Get Companies By Id Or Urn Using Post Companies Batchget Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/{id_or_urn}:
    get:
      tags:
      - companies
      summary: Get Company By Id Or Urn
      operationId: get_company_by_id_or_urn_companies__id_or_urn__get
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: extended
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Extended
      - name: include_fields
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          title: Include Fields
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/{id_or_urn}/employees:
    get:
      tags:
      - companies
      summary: Get Employees
      operationId: get_employees_companies__id_or_urn__employees_get
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: employee_group_type
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/EmployeeGroupType'
          default: ALL
      - name: employee_status
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/EmployeeStatus'
          default: ACTIVE
      - name: user_connection_status
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/UserConnectionStatus'
      - name: page
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Page
      - name: size
        in: query
        required: false
        schema:
          type: integer
          default: 10
          title: Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchOutput_PersonUrn_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/{id_or_urn}/userConnections:
    get:
      tags:
      - companies
      summary: Get User Connections
      operationId: get_user_connections_companies__id_or_urn__userConnections_get
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserConnectionExtendedOutput'
                title: Response Get User Connections Companies  Id Or Urn  Userconnections Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/attachments:
    post:
      tags:
      - companies
      summary: Batch Get Attachments
      operationId: batch_get_attachments_companies_attachments_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchCompanyAttachmentsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BatchCompanyAttachmentsOutput'
                type: array
                title: Response Batch Get Attachments Companies Attachments Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - companies
      summary: Batch Delete Attachments
      operationId: batch_delete_attachments_companies_attachments_delete
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchDeleteAttachmentsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: integer
                title: Response Batch Delete Attachments Companies Attachments Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/{id_or_urn}/attachments:
    post:
      tags:
      - companies
      summary: Batch Create Attachments
      operationId: batch_create_attachments_companies__id_or_urn__attachments_post
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchCreateAttachmentsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCreateAttachmentsOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - companies
      summary: Batch Complete Upload
      operationId: batch_complete_upload_companies__id_or_urn__attachments_put
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchCompleteUploadRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttachmentMetadataListOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - companies
      summary: Link Attachments
      operationId: link_attachments_companies__id_or_urn__attachments_patch
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkAttachmentsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AttachmentMetadataOutput'
                title: Response Link Attachments Companies  Id Or Urn  Attachments Patch
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /companies/{id_or_urn}/attachments/{urn}:
    get:
      tags:
      - companies
      summary: Get Attachment Content
      operationId: get_attachment_content_companies__id_or_urn__attachments__urn__get
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: urn
        in: path
        required: true
        schema:
          type: string
          title: Urn
      - name: preview
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Preview
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAttachmentContentResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - companies
      summary: Delete Attachment
      operationId: delete_attachment_companies__id_or_urn__attachments__urn__delete
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: urn
        in: path
        required: true
        schema:
          type: string
          title: Urn
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: boolean
                title: Response Delete Attachment Companies  Id Or Urn  Attachments  Urn  Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /watchlists/companies:
    get:
      tags:
      - companies
      summary: Get Company Watchlists By Owner
      operationId: get_company_watchlists_by_owner_watchlists_companies_get
      parameters:
      - name: company_urns
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
          description: Only show those watchlists that contains company urns
          default: []
          title: Company Urns
        description: Only show those watchlists that contains company urns
      - name: watchlist_type
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/UserWatchlistType'
          - type: 'null'
          description: Fetch watchlists with specific type. If None is provided, it fetches all
          title: Watchlist Type
        description: Fetch watchlists with specific type. If None is provided, it fetches all
      - name: return_company_urns
        in: query
        required: false
        schema:
          type: boolean
          description: Whether the endpoint should return the company ids associated with the watchlist or not.
          default: true
          title: Return Company Urns
        description: Whether the endpoint should return the company ids associated with the watchlist or not.
      - name: return_company_count
        in: query
        required: false
        schema:
          type: boolean
          description: Whether the endpoint should return the number of companies associated with the watchlist or not.
          default: true
          title: Return Company Count
        description: Whether the endpoint should return the number of companies associated with the watchlist or not.
      - name: get_team_shared_list
        in: query
        required: false
        schema:
          type: boolean
          description: Fetch public watchlists shared by other users in the team
          default: true
          title: Get Team Shared List
        description: Fetch public watchlists shared by other users in the team
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyWatchlistOutput'
                title: Response Get Company Watchlists By Owner Watchlists Companies Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - companies
      summary: Create Company Watchlist
      operationId: create_company_watchlist_watchlists_companies_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyWatchlistInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceUrnResponse_Union_CompanyWatchlistUrn__SynapseListUrn__'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /watchlists/companies/{id_or_urn}/custom_field:
    post:
      tags:
      - companies
      summary: Create Company Watchlist Custom Field
      operationId: create_company_watchlist_custom_field_watchlists_companies__id_or_urn__custom_field_post
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCompanyListCustomFieldInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyListCustomFieldOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - companies
      summary: Update Company Watchlist Custom Field
      operationId: update_company_watchlist_custom_field_watchlists_companies__id_or_urn__custom_field_put
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: custom_field_urn
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: urn:harmonic:company_list_custom_field:id
            title: CompanyListCustomFieldUrn
          - type: string
            pattern: urn:harmonic:list_attribute:id
            title: ListAttributeUrn
          - type: string
            pattern: urn:harmonic:record_attribute:id
            title: RecordAttributeUrn
          - type: 'null'
          description: Custom field URN
          title: Custom Field Urn
        description: Custom field URN
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCompanyListCustomFieldInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyListCustomFieldOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - companies
      summary: Delete Company Watchlist Custom Field
      operationId: delete_company_watchlist_custom_field_watchlists_companies__id_or_urn__custom_field_delete
      parameters:
      - name: custom_field_urn
        in: query
        required: false
        schema:
          type: string
          pattern: urn:harmonic:company_list_custom_field:id
          title: Custom Field Urn
          description: Custom field URN
        description: Custom field URN
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceUrnResponse_CompanyListCustomFieldUrn_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /watchlists/companies/{id_or_urn}/imports:
    get:
      tags:
      - companies
      summary: Get Company Watchlist Imports
      operationId: get_company_watchlist_imports_watchlists_companies__id_or_urn__imports_get
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Page number
          default: 0
          title: Page
        description: Page number
      - name: size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Page size
          default: 50
          title: Size
        description: Page size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserCompaniesImportsOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /watchlists/companies/{id_or_urn}/named_views:
    post:
      tags:
      - companies
      summary: Upsert Company Watchlist Named Views
      operationId: upsert_company_watchlist_named_views_watchlists_companies__id_or_urn__named_views_post
      parameters:
      - name: id_or_urn
        in: path
        required: true
        schema:
          anyOf:
          - type: integer
          - type: string
            format: uuid
          - type: string
          title: Id Or Urn
      - name: named_view_urn
        in: query
        required: false
        schema:
          type: string
          pattern: urn:harmonic:company_list_named_view:id
          title: Named View Urn
          description: Named view urn
        description: Named view urn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListNamedViewUpsertInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/sc

# --- truncated at 32 KB (180 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harmonic-ai/refs/heads/main/openapi/harmonic-ai-companies-api-openapi.yml