ZoomInfo Lookup API

openapi: 3.2.0
info:
  title: Zoominfo Lookup API
  version: '1.0'
  x-refined-note:
  - x-last-validated differs across the merged source definitions and was not carried
  description: 'Operations tagged Lookup across 2 of this provider''s published API definitions: zoominfo-gtm-data-v1-openapi.json, zoominfo-lookup-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.zoominfo.com/gtm
  description: Base URL for the Data API
- url: https://api.zoominfo.com
  description: ZoomInfo API Production Server
tags:
- name: Lookup
paths:
  /data/v1/lookup/{fieldName}:
    get:
      operationId: LookupInterface_lookup
      summary: Lookup Data
      description: Returns lookup data.
      parameters:
      - name: fieldName
        in: path
        required: true
        description: The name of the lookup field e.g. 'company-rankings'
        schema:
          $ref: '#/components/schemas/FieldNameEnum'
      - name: filter[category]
        in: query
        required: false
        description: The category of the lookup field. Only applicable when accessing hashtag lookups e.g. 'Unified Communications'
        schema:
          type: string
        explode: false
      - name: filter[parentCategory]
        in: query
        required: false
        description: The parentCategory. Only applicable when accessing hashtag and tech lookups e.g. 'Communication and Collaboration'
        schema:
          type: string
        explode: false
      - name: filter[subCategory]
        in: query
        required: false
        description: The subCategory. Only applicable when accessing hashtag and tech lookups e.g. 'Unified Communications as a Service'
        schema:
          type: string
        explode: false
      - name: filter[vendor]
        in: query
        required: false
        description: The vendor of the lookup field. Only applicable when accessing hashtag and tech lookups e.g. 'microsoft corporation'
        schema:
          type: string
        explode: false
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/LookupResponse'
              examples:
                Look up board member filters:
                  summary: Look up board member filters
                  description: This example demonstrates how to look up board member filters using the ZoomInfo API. The response includes a sample list of available filters for board members.
                  value:
                    data:
                    - attributes:
                        name: exclude
                      id: exclude
                      type: BoardMember
                    - attributes:
                        name: include
                      id: include
                      type: BoardMember
                Look up buying groups:
                  summary: Look up buying groups
                  description: This example demonstrates how to look up buying groups using the ZoomInfo API. The response includes a sample list of available buying group types.
                  value:
                    data:
                    - attributes:
                        accessLevel: private
                        isDefault: false
                        name: HR Decision Makers
                        personas:
                        - departmentsAndJobFunctions:
                          - Human Resources
                          managementLevels:
                          - C_EXECUTIVES
                          - VP_EXECUTIVES
                          - DIRECTOR
                          - MANAGER
                          titles: null
                      id: '1913024'
                      type: BuyingGroup
                    - attributes:
                        accessLevel: private
                        isDefault: false
                        name: SecondTestGroup
                        personas:
                        - departmentsAndJobFunctions:
                          - Medical & Health
                          managementLevels:
                          - VP_EXECUTIVES
                          titles:
                          - Dentist
                      id: '1913025'
                      type: BuyingGroup
                Look up company rankings:
                  summary: Look up company rankings
                  description: This example demonstrates how to look up company rankings using the ZoomInfo API. The response includes a sample company ranking.
                  value:
                    data:
                    - attributes:
                        name: Fortune 500
                      id: fortune500
                      type: CompanyRanking
                Look up company types:
                  summary: Look up company types
                  description: This example demonstrates how to look up company types using the ZoomInfo API. The response includes a sample company type.
                  value:
                    data:
                    - attributes:
                        name: private
                      id: private
                      type: CompanyType
                Look up continents:
                  summary: Look up continents
                  description: This example demonstrates how to look up continents using the ZoomInfo API. The response includes a sample continent.
                  value:
                    data:
                    - attributes:
                        name: Africa
                      id: africa
                      type: Continent
                Look up countries:
                  summary: Look up countries
                  description: This example demonstrates how to look up countries using the ZoomInfo API. The response includes a sample country.
                  value:
                    data:
                    - attributes:
                        name: Bahamas
                      id: bahamas
                      type: Country
                Look up departments:
                  summary: Look up departments
                  description: This example demonstrates how to look up departments using the ZoomInfo API. The response includes a sample department.
                  value:
                    data:
                    - attributes:
                        name: Information Technology
                      id: '5'
                      type: Department
                Look up employee count ranges:
                  summary: Look up employee count ranges
                  description: This example demonstrates how to look up employee count ranges using the ZoomInfo API. The response includes a sample employee count range.
                  value:
                    data:
                    - attributes:
                        name: 1 - 5
                      id: 1to4
                      type: EmployeeCount
                Look up hashtag results:
                  summary: Look up hashtag results
                  description: This example demonstrates how to look up hashtag results using the API. The response includes a sample hashtag result.
                  value:
                    data:
                    - attributes:
                        name: 250+ Doctors
                      id: '#250_plus_doctors'
                      type: Hashtag
                Look up industry categories:
                  summary: Look up industry categories
                  description: This example demonstrates how to look up industry categories using the API. The response includes a sample industry category.
                  value:
                    data:
                    - attributes:
                        name: Animals & Livestock
                      id: agriculture.animals
                      type: Industry
                Look up intent topics:
                  summary: Look up intent topics
                  description: This example demonstrates how to look up intent topics using the ZoomInfo API. The response includes a sample intent topic.
                  value:
                    data:
                    - attributes:
                        category: Cloud
                        department: Information Technology
                        description: ''
                        jobFunction: Cloud / Mobility
                        name: Cloud Applications
                      id: Cloud Applications
                      type: IntentTopic
                Look up job functions:
                  summary: Look up job functions
                  description: This example demonstrates how to look up job functions using the API. The response includes a sample job function.
                  value:
                    data:
                    - attributes:
                        name: Project Development
                      id: '4.11'
                      type: JobFunction
                Look up job title hierarchies:
                  summary: Look up job title hierarchies
                  description: This example demonstrates how to look up job titles using the ZoomInfo API. The response includes samples of job titles.
                  value:
                    data:
                    - attributes:
                        name: C-Level
                        order: '2'
                      id: exec
                      type: JobTitle
                    - attributes:
                        name: VP-Level
                        order: '3'
                      id: vp
                      type: JobTitle
                Look up management levels:
                  summary: Look up management levels
                  description: This example demonstrates how to look up management levels using the API. The response includes a sample management level.
                  value:
                    data:
                    - attributes:
                        name: VP Level Execs
                      id: VP Level Exec
                      type: ManagementLevel
                Look up metro region:
                  summary: Look up metro region
                  description: This example demonstrates how to look up metro refions using the ZoomInfo API. The response includes a sample metro region.
                  value:
                    data:
                    - attributes:
                        name: AL - Birmingham
                      id: usa.alabama.birmingham
                      type: MetroRegion
                Look up NAICS codes:
                  summary: Look up NAICS codes
                  description: This example demonstrates how to look up NAICS codes using the API. The response includes a sample NAICS code.
                  value:
                    data:
                    - attributes:
                        name: Soybean Farming
                      id: '11111'
                      type: NAICSCode
                Look up news categories:
                  summary: Look up news categories
                  description: This example demonstrates how to look up news categories using the API. The response includes a sample news category.
                  value:
                    data:
                    - attributes:
                        name: GENERAL_NEWS
                      id: GENERAL_NEWS
                      type: NewsCategory
                Look up revenue ranges:
                  summary: Look up revenue ranges
                  description: This example demonstrates how to look up revenue ranges using the API. The response includes a sample revenue range.
                  value:
                    data:
                    - attributes:
                        name: '500'
                      id: under500k
                      type: RevenueRange
                Look up scoop departments:
                  summary: Look up scoop departments
                  description: This example demonstrates how to look up scoop departments using the API. The response includes a sample scoop department.
                  value:
                    data:
                    - attributes:
                        name: Sales
                      id: '5'
                      type: ScoopDepartment
                Look up scoop topics:
                  summary: Look up scoop topics
                  description: This example demonstrates how to look up scoop topics using the API. The response includes a sample scoop topic.
                  value:
                    data:
                    - attributes:
                        name: Award
                      id: '5'
                      type: ScoopTopic
                Look up scoop types:
                  summary: Look up scoop types
                  description: This example demonstrates how to look up scoop types using the API. The response includes a sample scoop type.
                  value:
                    data:
                    - attributes:
                        name: Divestiture
                      id: '5'
                      type: ScoopType
                Look up SIC codes:
                  summary: Look up SIC codes
                  description: This example demonstrates how to look up SIC codes using the API. The response includes a sample SIC code.
                  value:
                    data:
                    - attributes:
                        name: Rice
                      id: '0112'
                      type: SICCode
                Look up states:
                  summary: Look up states
                  description: This example demonstrates how to look up states using the ZoomInfo API. The response includes a sample state.
                  value:
                    data:
                    - attributes:
                        name: Alaska
                      id: usa.alaska
                      type: State
                Look up sub-unit types:
                  summary: Look up sub-unit types
                  description: This example demonstrates how to look up sub-unit types using the API. The response includes a sample sub-unit type.
                  value:
                    data:
                    - attributes:
                        name: UNSPECIFIED
                      id: UNSPECIFIED
                      type: SubUnitType
                Look up tech categories:
                  summary: Look up tech categories
                  description: This example demonstrates how to look up tech categories using the API. The response includes a sample tech category.
                  value:
                    data:
                    - attributes:
                        categories:
                        - Applicant Tracking Systems
                      id: Human Resources
                      type: TechCategory
                Look up tech products:
                  summary: Look up tech products
                  description: This example demonstrates how to look up tech products using the API. The response includes a sample tech products.
                  value:
                    data:
                    - attributes:
                        name: Skype for Business
                        attribute: 333.202.28.24617
                      id: '24617'
                      type: TechProduct
                Look up tech skills:
                  summary: Look up tech skills
                  description: This example demonstrates how to look up tech skills using the API. The response includes a sample tech skills.
                  value:
                    data:
                    - attributes:
                        name: talentReef
                      id: '1000'
                      type: TechSkill
                Look up tech vendors:
                  summary: Look up tech vendors
                  description: This example demonstrates how to look up tech vendors using the API. The response includes a sample tech vendor.
                  value:
                    data:
                    - attributes:
                        name: Appier Inc.
                      id: Appier Inc.
                      type: TechVendor
                Look up ranges for years of experience:
                  summary: Look up ranges for years of experience
                  description: This example demonstrates how to look up ranges for years of experience using the API. The response includes a sample years of experience range.
                  value:
                    data:
                    - attributes:
                        name: 4-5
                      id: 4-5
                      type: YearsOfExperience
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '429':
          description: Too Many Requests
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
      tags:
      - Lookup
      security:
      - OAuth2Auth:
        - api:data:company
        - api:data:contact
        - api:data:intent
        - api:data:news
        - api:data:scoops
        - api:data:lookup
      x-api-roles:
      - fea:zia
      - fea:api
      x-api-role-requirement: ANY_REQUIRED
      x-api-scope-requirement: ANY_REQUIRED
    servers:
    - url: https://api.zoominfo.com/gtm
      description: Base URL for the Data API
  /data/v1/lookup/search:
    get:
      operationId: LookupSearchInterface_lookupSearch
      summary: Lookup Search Fields
      description: Returns lookup search fields based on entity and field type filters.
      parameters:
      - name: filter[entity]
        in: query
        required: true
        description: The entity type to filter by. Options are 'contact', 'company', 'scoop', 'news', or 'intent'.
        schema:
          $ref: '#/components/schemas/SearchEntityNameEnum'
        explode: false
      - name: filter[fieldType]
        in: query
        required: true
        description: The field type to filter by. Options are 'input' or 'output'.
        schema:
          $ref: '#/components/schemas/FieldTypeEnum'
        explode: false
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/LookupSearchResponse'
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '429':
          description: Too Many Requests
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
      tags:
      - Lookup
      security:
      - OAuth2Auth:
        - api:data:company
        - api:data:contact
        - api:data:intent
        - api:data:news
        - api:data:scoops
        - api:data:lookup
      x-api-roles:
      - fea:zia
      - fea:api
      x-api-role-requirement: ANY_REQUIRED
      x-api-scope-requirement: ANY_REQUIRED
    servers:
    - url: https://api.zoominfo.com/gtm
      description: Base URL for the Data API
  /data/v1/lookup/enrich:
    get:
      operationId: LookupEnrichInterface_lookupEnrich
      summary: Lookup Enrich Fields
      description: Returns lookup enrich fields based on entity and field type filters.
      parameters:
      - name: filter[entity]
        in: query
        required: true
        description: The entity type to filter by. Options are 'contact', 'company', 'scoop', 'news', 'intent', 'technology', 'orgChart', or 'corporate-hierarchy'.
        schema:
          $ref: '#/components/schemas/EnrichEntityNameEnum'
        explode: false
      - name: filter[fieldType]
        in: query
        required: true
        description: The field type to filter by. Options are 'input' or 'output'.
        schema:
          $ref: '#/components/schemas/FieldTypeEnum'
        explode: false
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/LookupEnrichResponse'
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '429':
          description: Too Many Requests
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
      tags:
      - Lookup
      security:
      - OAuth2Auth:
        - api:data:company
        - api:data:contact
        - api:data:intent
        - api:data:news
        - api:data:scoops
        - api:data:lookup
      x-api-roles:
      - fea:zia
      - fea:api
      x-api-role-requirement: ANY_REQUIRED
      x-api-scope-requirement: ANY_REQUIRED
    servers:
    - url: https://api.zoominfo.com/gtm
      description: Base URL for the Data API
  /lookup/companyranking:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Company Ranking
      description: Retrieve accepted Company Ranking values
      operationId: CompanyRanking
      parameters: []
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Tue, 17 Sep 2019 15:03:51 GMT
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: keep-alive
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            CF-Ray:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 517bf8185879ae06-BOS
            Expect-CT:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
            Set-Cookie:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: _pxhd=65d3624b622354d497d15cd8f518d9003708630dad6c7226d0b798c059302a3a:97799611-d95b-11e9-9c4e-21d6673962fa; path=/;
            vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Via:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1.1 google, 1.1 google
            x-application-context:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: application:production:8080
            X-RateLimit-Limit:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '1000'
            X-RateLimit-Remaining:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '999'
            X-RateLimit-Reset:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '1568732631'
            Server:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: cloudflare
          content:
            application/json;charset=utf-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GetCompanyRanking'
                description: ''
                examples:
                - - Id: fortune100
                    Name: Fortune 100
                  - Id: fortune500
                    Name: Fortune 500
                  - Id: fortune1000
                    Name: Fortune 1000
                  - Id: global500
                    Name: Global 500
                  - Id: private500
                    Name: America's Largest
                  - Id: russell3000
                    Name: Russell 3000
                contentMediaType: application/json;charset=utf-8
              example:
              - Id: fortune100
                Name: Fortune 100
              - Id: fortune500
                Name: Fortune 500
              - Id: fortune1000
                Name: Fortune 1000
              - Id: global500
                Name: Global 500
              - Id: private500
                Name: America's Largest
              - Id: russell3000
                Name: Russell 3000
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/continent:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Continent
      description: Retrieve accepted Continent values
      operationId: Continent
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/country:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Country
      description: Retrieve accepted Country values
      operationId: Country
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/state:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo State
      description: Retrieve accepted State values
      operationId: State
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/department:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Contact Departments
      description: Retrieve accepted Contact Department values
      operationId: ContactDepartments
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/employeecount:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Employee Count
      description: Retrieve accepted Employee Count values
      operationId: EmployeeCount
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/siccode:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Sic Codes
      description: Retrieve accepted Standard Industrial Classification (SIC) values
      operationId: SICCodes
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/naicscode:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Naics Codes
      description: Retrieve accepted North American Industry Classification System (NAICS) values
      operationId: NAICSCodes
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      security:
      - bearerAuth: []
    servers:
    - url: https://api.zoominfo.com
      description: ZoomInfo API Production Server
  /lookup/industry:
    parameters: []
    get:
      tags:
      - Lookup
      summary: Zoominfo Industry Codes
      description: 'Retrieve accepted Industry Code values


        '
      operationId: IndustryCodes
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
      deprecated: false
      x-microcks-operation:


# --- truncated at 32 KB (131 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoominfo/refs/heads/main/openapi/zoominfo-lookup-api-openapi.yml