--- title: "Fetch Audience" method: GET path: "/studio/v1/audiences/{audienceId}" tags: ["Audiences"] --- # Fetch Audience `GET /studio/v1/audiences/{audienceId}` ## Request - Base URL: `https://api.zoominfo.com/gtm` - URL: `https://api.zoominfo.com/gtm/studio/v1/audiences/{audienceId}` - Auth: OAuth 2 - Authorization code: `https://login.zoominfo.com` - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:audience:read` Retrieves the full state of a single audience by its `audienceId`. Returns all audience attributes — name, type, source origin, current `recordCount`, folder location, creation and update timestamps, and the complete column structure with all column properties. Use this endpoint to check audience configuration before writing rows or before running enrichment. Returns `200` with the audience resource. Returns `404` if no audience matches the provided `audienceId`. ## Path parameters - `audienceId` string, uuid, required ## Response `200` Success - ReadAudienceDetailJsonApiModel: JSON API model for Audience detail responses. - `data` ReadAudienceDetail, required: Audience read detail request resource. - `id` string, required: The unique identifier for the resource - `type` string, required: The type of the resource - `attributes` ReadAudienceDetailAttributes, required: Audience attributes returned by detail endpoints. - `name` string, required: Display name of the audience. - `description` string: Optional free-text description of the audience's purpose or contents. - `notes` string: Optional notes about the audience for internal reference. - `recordCount` integer, required: Total number of rows currently in the audience. Read-only; updated automatically as rows are added or removed. - `type` 'CONTACT' | 'COMPANY', required: Determines the record type the audience holds. Set at creation and cannot be changed. - `folderId` string: UUID of the folder that contains this audience. If omitted on create, a new folder matching the audience name is created automatically. - `origin` 'CUSTOM' | 'ZOOMINFO_PUBLIC_API' | 'ZOOMINFO_SEARCH' | 'CRM' | 'CSV' | 'ZOOMINFO_SIGNALS' | 'SNOWFLAKE' | 'ZOOMINFO' | 'DERIVED_ZOOMINFO_CONTACTS' | 'DERIVED_CRM_CONTACTS' | 'DERIVED_CRM_ACCOUNTS' | 'DERIVED_CRM_OPPORTUNITIES' | 'AUDIENCE_COPY' | 'GRAPHQL', required: Indicates how the audience was originally populated. Read-only; set by the system based on the creation method. - `folderName` string: Display name of the folder that contains this audience. - `columns` ReadColumn[]: The Columns in the audience - `id` string, required: The unique identifier for the resource - `type` string, required: The type of the resource - `attributes` ReadColumnAttributes, required: Base attributes shared by all column types in an audience. - `name` string, required: Display name of the column shown in the UI and returned in row responses. - `dataType` 'TEXT' | 'BOOLEAN' | 'DATE' | 'STRING_LIST' | 'NUMBER_LIST' | 'EMAIL_LIST' | 'PHONE_LIST' | 'PHONE' | 'EMAIL' | 'LARGE_TEXT' | 'INTEGER' | 'DECIMAL' | 'OBJECT' | 'URL' | 'URL_LIST' | 'CHECKBOX' | 'PERCENT' | 'OPAQUE_IDENTIFIER' | 'ORDINAL_IDENTIFIER' | 'REFERENCE' | 'PICKLIST' | 'MULTIPICKLIST' | 'CURRENCY' | 'ZI_CONTACT_ID' | 'ZI_COMPANY_ID' | 'MARKUP' - `isDeletable` boolean, required: Whether this column can be deleted via the Delete Column endpoint. Read-only; set by the system. - `isEditable` boolean, required: Whether this column's value can be updated via the Update rows endpoint. Read-only; set by the system. - `isExportable` boolean, required: Whether this column's values can be included in data exports. Read-only; set by the system. - `isFilterable` boolean, required: Whether this column supports row filtering via the filterCriteria. Read-only; set by the system. - `isFrozen` boolean: Whether this column is pinned (frozen) to the left in grid views. Optional; defaults to `false`. - `isHidden` boolean: Whether this column is hidden from grid views. Optional; defaults to `false`. - `isSortable` boolean, required: Whether this column supports row sorting via the List Rows endpoint. Read-only; set by the system. - `columnType` 'CUSTOM' | 'CRM_SEARCH' | 'CRM' | 'CSV' | 'FORMULA' | 'ACCOUNT_AI' | 'CONNECTORS' | 'ROUTING' | 'SNOWFLAKE' | 'AI' | 'AGENT_TEAMS' | 'ZOOMINFO_COPILOT_SIGNALS' | 'ZOOMINFO_AUDIENCE' | 'ZOOMINFO_JOB_POSTINGS' | 'ZOOMINFO_WEBSIGHTS' | 'ZOOMINFO_CONTACT_CHANGES' | 'ZOOMINFO_TECHNOLOGIES' | 'ZOOMINFO_INTENT' | 'ZOOMINFO_SCOOPS' | 'ZOOMINFO_COMPANY' | 'ZOOMINFO_CONTACT' | 'ZOOMINFO_CUSTOM' | 'ZOOMINFO_MATCH' | 'ZOOMINFO_CONTACT_SEARCH' | 'SIGNALS_AUDIENCE_DEFAULT' | 'JSON_PARSER' | 'REFERENCE_MAPPER' | 'AUDIENCE_LOOKUP' | 'GRAPHQL_AUDIENCE_DEFAULT' | 'GRAPHQL' | 'ACCOUNT_LOOK_ALIKE' | 'CONTACT_LOOK_ALIKE' | 'ZOOMINFO_FEDERATED_SEARCH' | 'IN_MARKET_SCORE' | 'LOCATION_FIRMOGRAPHIC' | 'ZOOMINFO_SEARCH' | 'ZOOMINFO_SEARCH_AUDIENCE_DEFAULT', required - `prompt` string: Formula or AI prompt used to generate values for this column. Returned for `FORMULA` and `AI` columns. - `tool` 'AI_DATA_ANALYSIS' | 'AI_WEB_RESEARCH' | 'AI_CONVERSATION_INTELLIGENCE' | 'AI_EMAILER': Defines AI tool names used by AI columns and data dependency discovery. - `dataDependencies` ColumnContextInput[]: List of data dependencies that provide context to the AI model for this column. Returned for `AI` columns if data dependencies were specified. - `id` string, required: The `columnId` of an existing column in the audience whose values should be included as context for the AI when generating values for the column, OR the `id` of a knowledge base attribute configured. - `type` 'COLUMN' | 'KNOWLEDGE_BASE', required: Defines the type of context input used for AI column generation. - `scriptConfiguration` ScriptConfiguration: Optional script configuration returned for `FORMULA` columns. Contains the generated expression and its language. - `language` 'JAVASCRIPT', required: Supported expression languages for formula columns. - `expression` string, required: Generated formula expression evaluated for this column. - `matchCriteria` MatchCriteria[]: List of match criteria defining how rows are matched against ZoomInfo data. Returned for `ZOOMINFO_MATCH` columns. - `columnId` string, required: The `columnId` of the audience column whose value is used as the match input. - `mappedTo` 'COMPANY_WEBSITE' | 'COMPANY_NAME' | 'ZOOMINFO_COMPANY_ID' | 'COMPANY_COUNTRY' | 'COMPANY_STATE' | 'COMPANY_CITY' | 'COMPANY_ZIP_CODE' | 'COMPANY_PHONE' | 'COMPANY_TICKER' | 'COMPANY_LINKEDIN_ID' | 'COMPANY_IP_ADDRESSES' | 'COMPANY_METRO_AREA' | 'COMPANY_LINKEDIN_URL' | 'COMPANY_FACEBOOK_URL' | 'COMPANY_TWITTER_URL' | 'COMPANY_GOOGLE_PLUS_URL' | 'COMPANY_YOUTUBE_URL' | 'COMPANY_LOCATION' | 'COMPANY_LOCATION_CODE' | 'CONTACT_FIRST_NAME' | 'CONTACT_LAST_NAME' | 'CONTACT_EMAIL' | 'JOB_TITLE' | 'DIRECT_PHONE' | 'MOBILE_PHONE' | 'CONTACT_STREET' | 'CONTACT_CITY' | 'CONTACT_STATE' | 'CONTACT_COUNTRY' | 'CONTACT_ZIP_CODE' | 'ZOOMINFO_CONTACT_ID' | 'CONTACT_MIDDLE_NAME' | 'CONTACT_LINKEDIN_URL' | 'CONTACT_TWITTER_URL' | 'CONTACT_LINKEDIN_COMPANY_ID' | 'CONTACT_ZOOMINFO_COMPANY_ID' | 'CONTACT_PARENT_ID' | 'CONTACT_HASHED_EMAILS' | 'CONTACT_LINKEDIN_PRIVATE_IDS', required - `meta` ColumnMeta: Metadata for Column model. - `createdAt` string, date-time, required: The timestamp when the resource was created - `createdById` integer, required: Id of the user who created the resource - `createdByName` string, required: Name of the user who created the resource - `updatedAt` string, date-time, required: The timestamp when the resource was last updated - `updatedById` integer, required: Id of the user who last updated the resource - `updatedByName` string, required: Name of the user who last updated the resource - `zoomInfoSearchCriteria` ZoomInfoSearchCriteria: ZoomInfo search criteria configuration for audience targeting. At least one of `companySearch` or `contactSearch` must be provided. - For `COMPANY` audiences, `companySearch` is required; `contactSearch` is optional. - For `CONTACT` audiences, `contactSearch` is required; `companySearch` is optional. Use the [Lookup Data](ref:lookupinterface_lookup) endpoint to retrieve valid values where applicable. - `companySearch` ZoomInfoSearchCriteriaCompanySearch: Company search configuration. - `marketingDepartmentBudgetMin` integer: Minimum marketing department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0, maximum value is 2147483647 (approximately 2 trillion). - `marketingDepartmentBudgetMax` integer: Maximum marketing department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 1, maximum value is 2147483647 (approximately 2 trillion). - `financeDepartmentBudgetMin` integer: Minimum finance department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0, maximum value is 2147483647 (approximately 2 trillion). - `financeDepartmentBudgetMax` integer: Maximum finance department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 1, maximum value is 2147483647 (approximately 2 trillion). - `itDepartmentBudgetMin` integer: Minimum information technology department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0, maximum value is 2147483647 (approximately 2 trillion). - `itDepartmentBudgetMax` integer: Maximum information technology department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 1, maximum value is 2147483647 (approximately 2 trillion). - `hrDepartmentBudgetMin` integer: Minimum human resources department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0, maximum value is 2147483647 (approximately 2 trillion). - `hrDepartmentBudgetMax` integer: Maximum human resources department budget amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 1, maximum value is 2147483647 (approximately 2 trillion). - `certified` integer: Denotes if ZoomInfo's research and data team has confirmed activity within the past 12 months. 1 = certified, 0 = not certified. - `excludeDefunctCompanies` boolean: Defaults to false. Set true to exclude defunct companies from results. - `businessModel` string[]: Search using Business Model (B2C, B2B, B2G) for a company. Default is All. - `underManagement` boolean: Returns whether or not record is under management if set to true. - `companyTicker` string[]: Company stock ticker symbol. - `companyDescription` string: Search for companies based on description. Accepts a space-separated list of individual words. - `companyType` string: Company type. Accepts a comma-separated list of types. Allowed values (case-insensitive): `none`, `private`, `public`, `npo`, `education`, `government`, `other`. - `address` string: Full Company Address. - `street` string: Street address portion of the company's location. - `state` string: State or province of the company's address. - `zipCode` string: Zip Code or Postal Code of the company's address. May only contain letters, numbers, whitespace, and the special characters `,-`. - `country` string: Country of the primary address of the associated company. - `continent` string: Continent of the primary address of the associated company. - `zipCodeRadiusMiles` integer: Used in conjunction with zipCode, designates a geographical radius (in miles) from the zipCode provided. Supported values are [10, 25, 50, 100, 250] - `hashTagString` string: Hash tags for a company. Can include a comma-separated list. - `techAttributeTagList` string: Technology Product Tags. Can include a comma-separated list. - `primaryIndustriesOnly` boolean: Default is false. Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. - `subUnitTypes` string: Company sub types (e.g., division, subsidiary). Use this in conjunction with parentId or ultimateParentId. - `industryCodes` string: Top-level industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. - `industryKeywords` string: Industry keywords associated with a company. Can include either 'AND' or 'OR' operators. For example, 'software AND security' or 'software OR security' - `sicCodes` string: The Standard Industrial Classification is a system for classifying industries by a four-digit code numerical assigned by the U.S. government to business establishments to identify the primary business of the establishment. Accepts a comma-separated list. - `naicsCodes` string: Four-digit numerical codes assigned by the U.S. government to business establishments to identify the primary business of the establishment. Accepts a comma-separated list of values. - `revenue` string: Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. - `revenueMin` integer: Minimum annual revenue for a company in U.S. dollars (expressed in thousands). Use with revenueMax to set a range. - `revenueMax` integer: Maximum annual revenue for a company in U.S. dollars (expressed in thousands). Use with revenueMin to set a range. - `employeeRangeMin` string: Minimum employee count for a company. Use with employeeRangeMax to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. - `employeeRangeMax` string: Maximum employee count for a company. Use with employeeRangeMin to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. - `employeeCount` string: Employee count range. Accepts a comma-separated list of values. Alternatively, for more granular ranges, you can use the employeeRangeMin and employeeRangeMax parameters. - `companyRanking` string: Company ranking (e.g., Fortune 500). Accepts a comma-separated list of IDs. - `metroRegion` string: Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. - `locationSearchType` string: Location type (PersonOrHQ, PersonAndHQ, Person, HQ, PersonThenHQ). - `fundingAmountMin` integer: Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0. If fundingAmountMin is used without fundingAmountMax, the result will be the amount specified or greater. - `fundingAmountMax` integer: Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0. If fundingAmountMax is used without fundingAmountMin, the result will be the amount specified or less. - `fundingStartDate` string, date: Start date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. - `fundingEndDate` string, date: End date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. - `recentFundingRoundTypes` string[]: Filters for companies whose most recent funding round matches one of the given types. Accepts an array of values from the endpoint: /lookup/funding-round-types. This is a different filter mode than allFundingRoundTypes (which matches any round in the company's history), so only one of the two should be supplied per request. - `allFundingRoundTypes` string[]: Filters for companies that have had any funding round (at any point in their history) matching one of the given types. Accepts an array of values from the endpoint: /lookup/funding-round-types. This is a different filter mode than recentFundingRoundTypes (which matches only the most recent round), so only one of the two should be supplied per request. - `zoominfoContactsMin` string: Minimum number of ZoomInfo contacts associated with company. - `zoominfoContactsMax` string: Maximum number of ZoomInfo contacts associated with company. - `excludedRegions` string: Accepts a comma-separated list of U.S. and Canada states and metro areas. Companies from any of these regions will be excluded from search results. - `companyStructureIncludedSubUnitTypes` string: Company hierarchical structure values. Accepts a comma-separated list of values from 'UNSPECIFIED', 'LOCATION', 'DIVISION', 'ACQUISITION', 'SUBSIDIARY', 'FORMER_NEW_NAME'. - `oneYearEmployeeGrowthRateMin` string: Minimum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMax to set a range. - `oneYearEmployeeGrowthRateMax` string: Maximum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMin to set a range. - `twoYearEmployeeGrowthRateMin` string: Minimum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMax to set a range. - `twoYearEmployeeGrowthRateMax` string: Maximum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMin to set a range. - `parentId` string: ZoomInfo Company ID for parent company. - `ultimateParentId` string: Company sub types (e.g., division, subsidiary). Use this in conjunction with parentId or ultimateParentId. - `companyId` string: Unique ZoomInfo identifier for a company. - `companyName` string: Company name. - `companyWebsite` string: Company website URL in http://www.example.com format. Accepts a comma-separated list. - `engagementStartDate` string, date: Engagement start date in YYYY-MM-DD format. - `engagementEndDate` string, date: Engagement end date in YYYY-MM-DD format. EngagementStartDate is required. - `engagementType` string[]: List of engagement types to search for. Accepted values are 'email', 'phone', 'online meeting'. Accepts a comma-separated list of these values. - `excludeTechAttributeTagList` string: Exclude companies with these technology product tags. String can be one value ('131315') or a comma-separated list which is treated as OR logic ('131315, 132222'). Individual values can also include AND logic ('131315 AND 131301, 132222'). This last example would be evaluated as ((131201 AND 131301) OR 132222). - `contactSearch` ZoomInfoSearchCriteriaContactSearch: Contact search configuration. - `lastUpdatedDateAfter` string, date: Limit results to only contacts that have a `lastUpdateDate` **after** the provided value. The value must be a date formatted using the ISO 8601 date format (YYYY-MM-DD). Example value: `2024-01-01` will return only contacts with a `lastUpdatedDate` after January 1, 2024 - `validDateAfter` string, date: Limit results to only contacts that have a `validDate` **after** the provided value. The value must be a date formatted using the ISO 8601 date format (YYYY-MM-DD) Example value: `2024-01-01` will return only contacts with a `validDate` after January 1, 2024 - `phone` string[]: List of phone numbers used to locate the contacts you are searching for. The phone numbers can either be direct dial office phone numbers or mobile phone numbers. Contacts will be returned if they match a single phone number from the provided list. Phone numbers can be formatted in any standard format as all non-digit characters will be stripped before searching. Example: `800-555-2345` is functionally equivalent to `8005552345` as an input value - `positionStartDateMin` string, date: Minimum date for when a contact began current employment. Use with positionStartDateMax to set a range. Uses YYYY-MM-DD format. - `positionStartDateMax` string, date: Maximum date for when a contact began current employment. Use with positionStartDateMin to set a range. Uses YYYY-MM-DD format. - `supplementalEmail` string[]: Supplemental email address for the contact in example@example.com format. - `webReferences` string[]: List of Web References for a contact. Default criteria is OR between multiple values. Should only contain english letters and numbers. - `buyingGroup` string[]: Filters results based on the provided Buying Group ID. Only one ID can be submitted. - `techSkills` string[]: List of technology skill IDs for a contact. Default criteria is OR between multiple values. Should only contain string numbers. Find the IDs for the skills in the lookup endpoint. - `yearsOfExperience` string: Total years of experience. Accepts a comma-separated list. Allowed values: `0-1`, `2-3`, `4-5`, `6-7`, `8-9`, `10-14`, `15-19`, `20-29`, `30-39`, `40-49`, `50-59`. - `personId` string: Unique ZoomInfo identifier for the contact. Can include a comma-separated list. - `emailAddress` string: Email address for the contact in example@example.com format. Accepts a comma-separated list. - `hashedEmail` string: Hashed email value for the contact. Allows searching via an email address with the extra security of not exposing the email. Supported hash algorithms are: MD5, SHA1, SHA256 and SHA512. - `fullName` string: Contact full name. - `firstName` string: Contact first name. - `middleInitial` string: Contact middle initial. - `lastName` string: Contact last name. - `jobTitle` string: Contact title at current place of employment. Use OR to input multiple job titles. Each title may only contain letters, numbers, whitespace, and the special characters `+&,./'-"` (parentheses are not permitted; use exactJobTitle if parentheses are required). - `exactJobTitle` string: Contact title at current place of employment using exact match logic. Use OR to input multiple job titles. Each title may only contain letters, numbers, whitespace, and the special characters `+&,./'-"()`. Unlike jobTitle, parentheses are permitted here. - `excludeJobTitle` string: Comma-separated list of job titles to exclude from search results. Each title may only contain letters, numbers, whitespace, and the special characters `+&,./'-"` (parentheses are not permitted). - `managementLevel` string: Contact management level at current place of employment. Accepts a comma-separated list. Allowed values (case-insensitive): `Board Member`, `C Level Exec`, `VP Level Exec`, `Director`, `Manager`, `Non Manager`. - `excludeManagementLevel` string: Comma-separated list of management levels to exclude from search results. Allowed values (case-insensitive): `Board Member`, `C Level Exec`, `VP Level Exec`, `Director`, `Manager`, `Non Manager`. - `department` string: Contact department at current place of employment. Accepts a comma-separated list of values. - `boardMember` string: Exclude or include board members from search results. Default behavior is to exclude board members from search results. Submit this as `include` to include board members, set this as `only` to only include board members. - `excludePartialProfiles` boolean: Defaults to false. To include partial profiles in your search results, set this to true. Contacts who do not have an active company associated with them are considered partial profiles. - `executivesOnly` boolean: Defaults to false. Set this to true to include only executives in search results. - `requiredFields` string: Specify a list of required fields for each record returned. Can include a comma-separated list of these values (case-insensitive): `email` (business email), `phone` (direct or company phone), `directPhone` (contact's direct phone), `personalEmail`, `mobilePhone`. - `contactAccuracyScoreMin` string: Minimum accuracy score for search results. This score indicates the likelihood that a contact is reachable and still employed by the company listed. Minimum score is 70 and maximum is 99. - `contactAccuracyScoreMax` string: Maximum accuracy score for search results. This score indicates the likelihood that a contact is reachable and still employed by the company listed. Minimum score is 70 and maximum is 99. - `jobFunction` string: Contact job function at their current place of employment. - `lastUpdatedInMonths` integer: Number of months within which the contact's profile was last updated. Minimum value is 0. - `hasBeenNotified` string: Defaults to include. Set this to `exclude` to exclude contacts who have been notified of inclusion in ZoomInfo's database. Set this to `only` to only include contacts who have been notified. - `companyPastOrPresent` string: Defaults to `present`, which only includes the present company for a contact. Set this to `past` to return past companies, set this to `pastAndPresent` to include both. - `school` string: School name. - `degree` string: Searches by contact's education. - `locationCompanyId` integer[]: Searches by contact's locationIds. - `underManagement` boolean: Returns whether or not record is under management if set to true. - `employmentHistory` ContactsEmploymentHistory[]: Search by contact's past employments. Accepts an array of past employment criteria. Contacts matching ANY of the provided past employment records will be returned. - `companyName` string, required: Company name of past employment. - `jobTitle` string, required: Job title at past employment. - `companyTicker` string[]: Company stock ticker symbol. - `companyDescription` string: Search for companies based on description. Accepts a space-separated list of individual words. - `companyType` string: Company type. Accepts a comma-separated list of types. Allowed values (case-insensitive): `none`, `private`, `public`, `npo`, `education`, `government`, `other`. - `address` string: Full Company Address. - `street` string: Street address portion of the company's location. - `state` string: State or province of the company's address. - `zipCode` string: Zip Code or Postal Code of the company's address. May only contain letters, numbers, whitespace, and the special characters `,-`. - `country` string: Country of the primary address of the associated company. - `continent` string: Continent of the primary address of the associated company. - `zipCodeRadiusMiles` integer: Used in conjunction with zipCode, designates a geographical radius (in miles) from the zipCode provided. Supported values are [10, 25, 50, 100, 250] - `hashTagString` string: Hash tags for a company. Can include a comma-separated list. - `techAttributeTagList` string: Technology Product Tags. Can include a comma-separated list. - `primaryIndustriesOnly` boolean: Default is false. Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. - `subUnitTypes` string: Company sub types (e.g., division, subsidiary). Use this in conjunction with parentId or ultimateParentId. - `industryCodes` string: Top-level industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. - `industryKeywords` string: Industry keywords associated with a company. Can include either 'AND' or 'OR' operators. For example, 'software AND security' or 'software OR security' - `sicCodes` string: The Standard Industrial Classification is a system for classifying industries by a four-digit code numerical assigned by the U.S. government to business establishments to identify the primary business of the establishment. Accepts a comma-separated list. - `naicsCodes` string: Four-digit numerical codes assigned by the U.S. government to business establishments to identify the primary business of the establishment. Accepts a comma-separated list of values. - `revenue` string: Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. - `revenueMin` integer: Minimum annual revenue for a company in U.S. dollars (expressed in thousands). Use with revenueMax to set a range. - `revenueMax` integer: Maximum annual revenue for a company in U.S. dollars (expressed in thousands). Use with revenueMin to set a range. - `employeeRangeMin` string: Minimum employee count for a company. Use with employeeRangeMax to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. - `employeeRangeMax` string: Maximum employee count for a company. Use with employeeRangeMin to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. - `employeeCount` string: Employee count range. Accepts a comma-separated list of values. Alternatively, for more granular ranges, you can use the employeeRangeMin and employeeRangeMax parameters. - `companyRanking` string: Company ranking (e.g., Fortune 500). Accepts a comma-separated list of IDs. - `metroRegion` string: Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. - `locationSearchType` string: Location type (PersonOrHQ, PersonAndHQ, Person, HQ, PersonThenHQ). - `fundingAmountMin` integer: Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0. If fundingAmountMin is used without fundingAmountMax, the result will be the amount specified or greater. - `fundingAmountMax` integer: Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). Minimum value is 0. If fundingAmountMax is used without fundingAmountMin, the result will be the amount specified or less. - `fundingStartDate` string, date: Start date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. - `fundingEndDate` string, date: End date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. - `recentFundingRoundTypes` string[]: Filters for companies whose most recent funding round matches one of the given types. Accepts an array of values from the endpoint: /lookup/funding-round-types. This is a different filter mode than allFundingRoundTypes (which matches any round in the company's history), so only one of the two should be supplied per request. - `allFundingRoundTypes` string[]: Filters for companies that have had any funding round (at any point in their history) matching one of the given types. Accepts an array of values from the endpoint: /lookup/funding-round-types. This is a different filter mode than recentFundingRoundTypes (which matches only the most recent round), so only one of the two should be supplied per request. - `zoominfoContactsMin` string: Minimum number of ZoomInfo contacts associated with company. - `zoominfoContactsMax` string: Maximum number of ZoomInfo contacts associated with company. - `excludedRegions` string: Accepts a comma-separated list of U.S. and Canada states and metro areas. Companies from any of these regions will be excluded from search results. - `companyStructureIncludedSubUnitTypes` string: Company hierarchical structure values. Accepts a comma-separated list of values from 'UNSPECIFIED', 'LOCATION', 'DIVISION', 'ACQUISITION', 'SUBSIDIARY', 'FORMER_NEW_NAME'. - `oneYearEmployeeGrowthRateMin` string: Minimum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMax to set a range. - `oneYearEmployeeGrowthRateMax` string: Maximum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMin to set a range. - `twoYearEmployeeGrowthRateMin` string: Minimum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMax to set a range. - `twoYearEmployeeGrowthRateMax` string: Maximum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMin to set a range. - `parentId` string: ZoomInfo Company ID for parent company. - `ultimateParentId` string: Company sub types (e.g., division, subsidiary). Use this in conjunction with parentId or ultimateParentId. - `companyId` string: Unique ZoomInfo identifier for a company. - `companyName` string: Company name. - `companyWebsite` string: Company website URL in http://www.example.com format. Accepts a comma-separated list. - `engagementStartDate` string, date: Engagement start date in YYYY-MM-DD format. - `engagementEndDate` string, date: Engagement end date in YYYY-MM-DD format. EngagementStartDate is required. - `engagementType` string[]: List of engagement types to search for. Accepted values are 'email', 'phone', 'online meeting'. Accepts a comma-separated list of these values. - `excludeTechAttributeTagList` string: Exclude companies with these technology product tags. String can be one value ('131315') or a comma-separated list which is treated as OR logic ('131315, 132222'). Individual values can also include AND logic ('131315 AND 131301, 132222'). This last example would be evaluated as ((131201 AND 131301) OR 132222). - `meta` AudienceMeta: Metadata for Audience model. - `createdAt` string, date-time, required: The timestamp when the resource was created - `createdById` integer, required: Id of the user who created the resource - `createdByName` string, required: Name of the user who created the resource - `updatedAt` string, date-time, required: The timestamp when the resource was last updated - `updatedById` integer, required: Id of the user who last updated the resource - `updatedByName` string, required: Name of the user who last updated the resource ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `429`: Too Many Requests --- [API](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/revisions/93a0bebaaac8?raw)