# Zoominfo APIs Documentation > An interactive platform offering comprehensive documentation for all ZoomInfo API endpoints. It features an API testing playground, real-time code examples, and detailed guides on authentication, rate limits, and usage best practices, designed to streamline integration and accelerate development. ## Get Started: API - [Overview](https://docs.gtm.ai/docs/overview.md) - [Standard App](https://docs.gtm.ai/docs/standard-app.md) - [Partner App](https://docs.gtm.ai/docs/partner-app.md) - [Authorization Code Flow (PKCE)](https://docs.gtm.ai/docs/authorization-code-flow-pkce.md) - [Refresh Tokens Flow](https://docs.gtm.ai/docs/refresh-tokens-flow.md) - [Client Credentials Flow](https://docs.gtm.ai/docs/client-credentials-flow.md) - [API Conventions](https://docs.gtm.ai/docs/api-conventions.md): Shared request, response, pagination, error, and identifier conventions for the ZoomInfo GTM API. - [Rate Limits](https://docs.gtm.ai/docs/rate-limits.md): Learn how ZoomInfo API rate limits work and how to build integrations that handle them gracefully. - [Pagination, Batching and Bulk](https://docs.gtm.ai/docs/pagination-batching-and-bulk.md): Pagination, Batching, and Bulk Workloads - [Status Codes and Errors](https://docs.gtm.ai/docs/status-codes-and-errors.md) - [Webhook and Events](https://docs.gtm.ai/docs/webhook-and-events.md): Stream ZoomInfo events to build responsive AI agents and automated workflows - [ZoomInfo OAuth Scopes](https://docs.gtm.ai/docs/zoominfo-oauth-scopes.md): Full list of the OAuth 2.0 scopes that can be used to access different parts of the ZoomInfo API - [OpenAPI Specifications](https://docs.gtm.ai/docs/openapi-specifications.md) - [Credit Usage and Limits](https://docs.gtm.ai/docs/credit-usage-and-limits.md) - [Test API Access](https://docs.gtm.ai/docs/test-api-access.md) ## Get Started: MCP - [Connect to ZoomInfo MCP](https://docs.gtm.ai/docs/connect-to-zoominfo-mcp.md) - [Available MCP Tools](https://docs.gtm.ai/docs/available-mcp-tools.md) ## Get Started: CLI - [ZoomInfo CLI](https://docs.gtm.ai/docs/zoominfo-cli.md) ## Get Started: Products - [Companies & Contacts](https://docs.gtm.ai/docs/companies-contacts.md) - [Signals & Insights](https://docs.gtm.ai/docs/signals-insights.md) - [Audiences](https://docs.gtm.ai/docs/audiences.md) - [Data Quality](https://docs.gtm.ai/docs/data-quality.md): Clean up your lists. Prepare, segment, and score your records before they reach your CRM. ## Get Started: Tutorials - [Find contacts using filters](https://docs.gtm.ai/docs/find-contacts-using-filters.md) ## API Reference: API Setup - [ZoomInfo API](https://docs.gtm.ai/reference/api-overview.md) - [Authentication](https://docs.gtm.ai/reference/oauth-authentication.md) - [OpenAPI Specification](https://docs.gtm.ai/reference/openapi-specification.md) ## API Reference: Data API V1 - [Data API Overview](https://docs.gtm.ai/reference/data-api-overview.md) - [Search Contacts](https://docs.gtm.ai/reference/searchinterface_searchcontact.md): Returns a list of Contacts from ZoomInfo's data that meet the specified search criteria. Input parameters may require specific values. You can use the [Lookup Data](ref:lookupinterface_lookup)… - [Search Companies](https://docs.gtm.ai/reference/searchinterface_searchcompany.md): Returns a list of Companies from ZoomInfo's data that meet the specified search criteria. Input parameters may require specific values. You can use the [Lookup Data](ref:lookupinterface_lookup)… - [Search Intent](https://docs.gtm.ai/reference/searchinterface_searchintent.md): **Prerequisite:** To use Search Intent, your ZoomInfo package must include access to the Intent SKU. Returns a list of Intent Signals from ZoomInfo's data that meet the specified search criteria. It… - [Search News](https://docs.gtm.ai/reference/searchinterface_searchnews.md): Returns a list of News articles from ZoomInfo's data that meet the specified search criteria. All inputs are optional, but at least one input must be set to get a successful response. Input… - [Search Scoops](https://docs.gtm.ai/reference/searchinterface_searchscoop.md): Returns a list of Scoops from ZoomInfo's data that meet the specified search criteria. Scoops are real-time business intelligence signals that provide timely insights into significant events and… - [Enrich Contacts](https://docs.gtm.ai/reference/enrichinterface_enrichcontact.md): Enrich Contacts can be used to retrieve detailed information about up to 25 individual contact records. Best practice is to first use the [Search Contacts](ref:searchinterface_searchcontact) to… - [Enrich Companies](https://docs.gtm.ai/reference/enrichinterface_enrichcompany.md): The Enrich Companies endpoint can be used to retrieve detailed information about up to 25 individual company records. Best practice is to first use [Search… - [Enrich Corporate Hierarchy](https://docs.gtm.ai/reference/enrichinterface_enrichcorporatehierarchy.md): Enrich the corporate hierarchy structure of up to 25 individual company records. Based on the provided inputs, ZoomInfo will find the Company that best matches in provided inputs and return the full… - [Enrich Intent](https://docs.gtm.ai/reference/enrichinterface_enrichintent.md): **Prerequisite:** To use Enrich Intent, your ZoomInfo package must include access to the Intent SKU. Fetch Intent Signals for a company, enriching that company's details with relevant buyer intent… - [Enrich News](https://docs.gtm.ai/reference/enrichinterface_enrichnews.md): Enrich the specified company with relevant News articles. A company identifier must be provided (companyId, companyName, companyWebsite); all other criteria are optional. Input parameters may… - [Enrich Org Charts](https://docs.gtm.ai/reference/enrichinterface_enrichorgchart.md): Enrich the specified Company by providing Org Chart information. For each request, a ZoomInfo Company identifier and at least one ZoomInfo Department identifier are required. This endpoint then… - [Enrich Scoops](https://docs.gtm.ai/reference/enrichinterface_enrichscoop.md): Enrich the specified company with relevant Scoops. A company identifier must be provided (companyId, companyName, companyWebsite); all other criteria are optional. Input parameters may require… - [Enrich Technologies](https://docs.gtm.ai/reference/enrichinterface_enrichtechnology.md): Return a list of technologies from ZoomInfo's company data that match to the provided company. Technologies data provides a list of technologies that ZoomInfo has identified the matched company is… - [Enrich Hashtags](https://docs.gtm.ai/reference/enrichinterface_enrichhashtag.md): Return a list of hashtags from ZoomInfo's company data that match to the provided company. Hashtags are predefined categorical labels that classify companies based on specific business… - [Lookup Data](https://docs.gtm.ai/reference/lookupinterface_lookup.md): Returns lookup data. - [Lookup Search Fields](https://docs.gtm.ai/reference/lookupsearchinterface_lookupsearch.md): Returns lookup search fields based on entity and field type filters. - [Lookup Enrich Fields](https://docs.gtm.ai/reference/lookupenrichinterface_lookupenrich.md): Returns lookup enrich fields based on entity and field type filters. - [Usage Data](https://docs.gtm.ai/reference/userinterface_userusage.md): Returns current user's API usage and limits. ## API Reference: Context API V1 - [Get Account Summary](https://docs.gtm.ai/reference/accountsummaryinterface_getaccountsummary.md): Retrieve the account summary for a specific company. - [Ask Account Summary Question](https://docs.gtm.ai/reference/accountsummaryinterface_askaccountsummaryquestion.md): Ask a question about the account summary of a specific company. - [Get insights by type](https://docs.gtm.ai/reference/insightsinterface_getcompanyinsightsbytype.md): Retrieve sales intelligence signals for up to 50 companies, filtered by signal type. Signals include funding events, leadership changes, intent spikes, hiring anomalies, and more. # Insights API -… - [Find Similar Companies](https://docs.gtm.ai/reference/companylookalikesinterface_companylookalikes.md): Company Lookalikes can be used to retrieve a ranked list of companies that are similar to a given reference company. The similar companies are identified using a machine learning model that analyzes… - [Get Contact Recommendations](https://docs.gtm.ai/reference/contactrecommendationsinterface_getcontactrecommendations.md): Contact Recommendations can be used to retrieve a ranked list of people at a target company who are most relevant for a given sales motion (use case), such as prospecting, deal acceleration, or… - [Get Contact Lookalikes](https://docs.gtm.ai/reference/contactlookalikesinterface_getcontactlookalikes.md): Contact Lookalikes can be used to retrieve a ranked list of people who are most similar to a given reference person. The recommendations are generated by a machine learning model that compares the… - [List Customer Buyer Personas](https://docs.gtm.ai/reference/customerbuyerpersonainterface_listcustomerbuyerpersonas.md): Returns the list of Customer Buyer Personas configured for the authenticated customer. A Buyer Persona represents a profile of a key decision-maker or influencer that a company's sales and marketing… - [Upsert Customer Buyer Persona](https://docs.gtm.ai/reference/customerbuyerpersonainterface_upsertcustomerbuyerpersona.md): Creates or updates a Customer Buyer Persona. This endpoint performs an upsert operation: If an `id` is included in the request body, the existing persona is updated. Only the fields provided in the… - [Get Customer Buyer Persona](https://docs.gtm.ai/reference/customerbuyerpersonainterface_getcustomerbuyerpersona.md): Retrieves a single Customer Buyer Persona by its unique identifier. A Buyer Persona represents a profile of a decision-maker or stakeholder that the customer's sales and marketing teams target. Each… - [Delete Customer Buyer Persona](https://docs.gtm.ai/reference/customerbuyerpersonainterface_deletecustomerbuyerpersona.md): Permanently deletes a Customer Buyer Persona identified by `buyerPersonaId`. Deleting a persona removes the associated buyer profile from the system and from any go-to-market configuration that… - [Archive Buyer Persona](https://docs.gtm.ai/reference/customerbuyerpersonainterface_archivecustomerbuyerpersona.md): Archives a Customer Buyer Persona. Archiving hides the persona from standard list responses while retaining the record for historical reference, audit compliance, and potential restoration. Archived… - [Unarchive Buyer Persona](https://docs.gtm.ai/reference/customerbuyerpersonainterface_unarchivecustomerbuyerpersona.md): Restores a previously archived Customer Buyer Persona. Unarchiving makes the persona visible again in standard list responses and allows it to be used again in GTM configuration and workflows. When a… - [List Customer Competitors](https://docs.gtm.ai/reference/customercompetitorsinterface_listcustomercompetitors.md): Returns the list of Customer Competitors configured for the authenticated customer. A Customer Competitor represents a company that competes with the customer's products or services in the market.… - [Upsert Customer Competitor](https://docs.gtm.ai/reference/customercompetitorsinterface_upsertcustomercompetitor.md): Creates or updates a Customer Competitor. This endpoint performs an upsert operation: If an `id` is included in the request body, the existing competitor record is updated. Only the attributes… - [Get Customer Competitor by ID](https://docs.gtm.ai/reference/customercompetitorsinterface_getcustomercompetitor.md): Retrieves a single Customer Competitor by its unique identifier. A Customer Competitor represents a company that competes with the customer's products or services. Competitor records capture… - [Delete Customer Competitor](https://docs.gtm.ai/reference/customercompetitorsinterface_deletecustomercompetitor.md): Permanently deletes a Customer Competitor identified by `competitorId`. Deleting a competitor removes the associated competitive intelligence from the system. This is a hard delete operation and… - [Archive Customer Competitor](https://docs.gtm.ai/reference/customercompetitorsinterface_archivecustomercompetitor.md): Archives a Customer Competitor. Archiving hides the competitor from standard list responses while retaining the record for historical reference and audit purposes. Archived competitors remain stored… - [Unarchive Customer Competitor](https://docs.gtm.ai/reference/customercompetitorsinterface_unarchivecustomercompetitor.md): Restores a previously archived Customer Competitor. Unarchiving makes the competitor visible again in standard list responses and allows it to be used again in competitive intelligence workflows.… - [List Ideal Customer Profiles](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_listidealcompanysegments.md): Returns a List of Ideal Customer Profile (ICPs) configured for the authenticated customer. An Ideal Customer Profile represents a target company profile that aligns with a company's go-to-market… - [Upsert Ideal Customer Profile](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_upsertidealcompanysegment.md): Creates or updates an Ideal Customer Profile. This endpoint performs an upsert operation: If an `id` is included in the request body, the existing segment is updated. Only the attributes provided in… - [Get an Ideal Customer Profile](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_getidealcompanysegment.md): Retrieves a single Ideal Customer Profile by its unique identifier. An Ideal Customer Profile defines the profile of organizations that best match a company's target market. Segments typically… - [Delete Ideal Customer Profile](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_deleteidealcompanysegment.md): Permanently deletes an Ideal Customer Profile identified by `segmentId`. Deleting a segment removes the associated target company profile from the system and from any go-to-market configuration that… - [Archive ICP](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_archiveidealcompanysegment.md): Archives an Ideal Customer Profile. Archiving hides the segment from standard list responses while retaining the record for historical reference, audit purposes, and possible restoration. Archived… - [Unarchive ICP](https://docs.gtm.ai/reference/customeridealcompanysegmentinterface_unarchiveidealcompanysegment.md): Restores a previously archived Ideal Customer Profile. Unarchiving makes the segment visible again in standard list responses and allows it to be used again in GTM targeting and configuration… - [Get Customer Settings](https://docs.gtm.ai/reference/customersettingsinterface_getcustomersettings.md): Retrieves the customer settings for the authenticated customer. Customer Settings represent the core company-level configuration. This includes foundational information such as the company name,… - [Upsert Customer Settings](https://docs.gtm.ai/reference/customersettingsinterface_upsertcustomersettings.md): Creates or updates the Customer Settings for the authenticated customer. Customer Settings store the Company Overview configuration including the company name, description, elevator pitch, and… - [Delete Customer Settings](https://docs.gtm.ai/reference/customersettingsinterface_deletecustomersettings.md): Permanently deletes the Customer Settings record for the authenticated customer. Customer Settings store the customers Company Overview configuration. Deleting this record removes that configuration… - [List Products or Services](https://docs.gtm.ai/reference/organizationofferingsinterface_listorganizationofferings.md): Returns the complete list of Products or Services configured for the authenticated customer. An Product or Service represents a product, service, or solution provided by your company and forms the… - [Upsert Product or Service](https://docs.gtm.ai/reference/organizationofferingsinterface_upsertorganizationoffering.md): Creates or updates a Product or Service for the authenticated customer. A Product or Service represents a product, service, or solution provided by your company. Products or Services form the… - [Get Product or Service](https://docs.gtm.ai/reference/organizationofferingsinterface_getorganizationoffering.md): Retrieves a single product or service by ID. A product or service represents a discrete product or service provided by your company and forms the foundation of your go-to-market configuration.… - [Delete Product or Service](https://docs.gtm.ai/reference/organizationofferingsinterface_deleteorganizationoffering.md): Permanently deletes a Product or Service identified by `offeringId`. A Product or Service represents a product, service, or solution provided by your company and serves as a core component of your… - [Archive Product or Service](https://docs.gtm.ai/reference/organizationofferingsinterface_archiveorganizationoffering.md): Archives an Product or Service identified by `offeringId`. Archiving hides the product or service from standard list responses while retaining the record for historical reference, audit purposes,… - [Unarchive Product or Service](https://docs.gtm.ai/reference/organizationofferingsinterface_unarchiveorganizationoffering.md): Restores a previously archived Product or Service. Unarchiving makes the product or service visible again in standard list responses and reactivates it for use across GTM configuration workflows.… ## API Reference: GTM Studio API V1 - [Create New Folder](https://docs.gtm.ai/reference/folders_createfolder.md): Creates a new folder for organizing audiences in GTM Studio. Folders group related audiences together, making it easier to navigate and manage large collections — for example, grouping by campaign,… - [List Folders](https://docs.gtm.ai/reference/folders_listfolders.md): Retrieves a paginated list of all folders, with optional filtering and sorting. Use this endpoint to browse the folder structure or to find a `folderId` before creating or moving an audience. Filter… - [Get Specific Folder](https://docs.gtm.ai/reference/folders_getfolderbyid.md): Retrieves the full state of a single folder by its `folderId`. Returns all folder attributes — name, starred status, description, notes, creation and update timestamps, and the list of `audienceId`… - [Update Folder](https://docs.gtm.ai/reference/folders_updatefolder.md): Updates one or more attributes of an existing folder without requiring a full replacement. Supported fields: `name`, `starred`, `description`, and `notes`. Only fields present in the request body are… - [Delete Specific Folder](https://docs.gtm.ai/reference/folders_deletefolder.md): Permanently deletes a folder from GTM Studio. Deleting a folder removes the audiences it contained as well. This action is irreversible. Returns `204 No Content` on success. Returns `404` if no… - [Create New Audience](https://docs.gtm.ai/reference/audiences_createaudience.md): Create a named working list of people (`CONTACT`) or companies (`COMPANY`) to drive a GTM motion — campaign targeting, enrichment runs, outbound sequences, or importing leads from trade shows and… - [List Audiences](https://docs.gtm.ai/reference/audiences_listaudiences.md): Search and browse all GTM Studio audiences. The primary way to discover an `audienceId` before loading rows, managing columns, or triggering enrichment. Also use this to check what audiences already… - [Fetch Audience](https://docs.gtm.ai/reference/audiences_getaudience.md): 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,… - [Delete Audience](https://docs.gtm.ai/reference/audiences_deleteaudience.md): Permanently deletes an audience and all associated data — rows, column definitions, and enrichment history. This action is irreversible; the audience and all its data cannot be recovered after… - [Update Audience](https://docs.gtm.ai/reference/audiences_patchaudience.md): Updates one or more metadata attributes of an existing audience without requiring a full replacement. Supported fields: `name`, `folderId`, `description`, and `notes`. Only fields present in the… - [Get Audience Filter Metadata](https://docs.gtm.ai/reference/audiences_getaudiencefiltermetadata.md): Returns the available filter operators for each column in the specified audience. Use this endpoint before building a filter-based row query to discover which operators — such as `EQUALS`,… - [Upsert Column Match Criteria](https://docs.gtm.ai/reference/audiences_upsertmatchcriteria.md): Upserts match criteria for the audience's designated match column (the column used for enrichment matching). Match criteria define how audience column values are mapped to ZoomInfo attributes (for… - [Enrich Audience](https://docs.gtm.ai/reference/audiences_enrichaudience.md): Initiates an asynchronous enrichment job that appends ZoomInfo intelligence data to rows in the specified audience. The request body must include a `scope` field specifying the enrichment target: -… - [Get Job Status](https://docs.gtm.ai/reference/audiences_getjobstatus.md): Returns the current status and progress of any previously initiated asynchronous job for an audience. Covers all job types: `AUDIENCE_CREATE`, `AUDIENCE_ENRICH`, and `ROW_UPSERT`. Provide the… - [Create New Columns](https://docs.gtm.ai/reference/columns_addcolumns.md): Add columns to an audience to define the shape of data it holds. Do this before loading rows — `columnId` values returned here are required by [Bulk Upsert Rows](ref:rows_upsertrows). Choose… - [Get Column Data Dependencies](https://docs.gtm.ai/reference/columns_getsupporteddatadependencies.md): Returns the available data dependencies for AI-powered columns so clients can build valid prompts and grounding context before creating the column. This endpoint solves data dependency discovery for… - [Update Column](https://docs.gtm.ai/reference/columns_patchcolumn.md): Updates a specific column's definition within an audience. Supported fields: `name`, `isFrozen`, and `isHidden`. Only fields present in the request body are modified. Use this endpoint to rename a… - [Delete Column](https://docs.gtm.ai/reference/columns_deletecolumn.md): Permanently removes a specific column from an audience, including all cell values stored in that column across every row. Only columns where `isDeletable` is `true` can be removed using this… - [Get Row by ID](https://docs.gtm.ai/reference/rows_getrowbyid.md): Retrieves a single row from an audience by its `rowId`. Returns the full row record including all cell values and their `CellState` — `RESULT` (value present), `BLANK` (no value set), `LOADING`… - [List Rows](https://docs.gtm.ai/reference/rows_listrows.md): Retrieves rows from an audience with support for filtering, sorting, and pagination. Rows are individual contact or company records; each row contains cells keyed by `columnId`, where each cell… - [Upsert Rows](https://docs.gtm.ai/reference/rows_upsertrows.md): Creates and/or updates up to 50 rows in an audience in a single synchronous operation. Each entry in the request body includes cell values keyed by `columnId`. Including a `rowId` updates that… - [Delete Rows](https://docs.gtm.ai/reference/rows_deleterows.md): Permanently removes multiple rows from an audience in a single bulk operation. Provide an array of `rowId` values in the request body. All row data and associated cell values are deleted and cannot… - [Bulk Upsert Rows](https://docs.gtm.ai/reference/rows_bulkupsertrows.md): Load records into an audience — create new rows, update existing ones, or mix both in a single call. This is the primary way to populate an audience with GTM data: trade show leads, CRM exports,… ## API Reference: Marketing API V1 - [Creates a new audience](https://docs.gtm.ai/reference/audienceinterface_createaudience.md): Creates a new audience. - [Lists all audiences](https://docs.gtm.ai/reference/audienceinterface_getaudiences.md): Lists all audiences. - [Gets existing audience by ID](https://docs.gtm.ai/reference/audienceinterface_getaudience.md): Gets an existing audience. - [Updates audience by ID](https://docs.gtm.ai/reference/audienceinterface_updateaudience.md): Updates an existing audience. - [Deletes audience by ID](https://docs.gtm.ai/reference/audienceinterface_deleteaudience.md): Deletes an existing audience. - [Creates new audience upload](https://docs.gtm.ai/reference/audienceinterface_uploadaudience.md): Create a new audience segment upload. - [Gets audience upload status](https://docs.gtm.ai/reference/audienceinterface_getaudienceupload.md): Gets the upload status for an existing audience. ## API Reference: Platform API V1 - [Upsert Content Interactions](https://docs.gtm.ai/reference/engagementscontroller_upsertcontentinteractions.md): Create or update content interaction engagement records - [Get content interaction](https://docs.gtm.ai/reference/engagementscontroller_getcontentinteractionengagement.md): Retrieve a specific content interaction engagement by ID - [Delete content interaction](https://docs.gtm.ai/reference/engagementscontroller_deletecontentinteractionengagement.md): Delete a content interaction engagement record ## API Reference: Agent API V1 - [List Agents](https://docs.gtm.ai/reference/agentscontroller_listagents.md): Lists all agents available to your tenant, including ZoomInfo managed agents and your tenant's published Agent Teams. Before running an agent, use [Get Agent Details](ref:agentscontroller_getagent)… - [Get Agent Details](https://docs.gtm.ai/reference/agentscontroller_getagent.md): Retrieves the full details for a specific agent, including the inputs required to run it. Call this endpoint before starting a run. The expected input is defined in `inputSchema`, which describes the… - [Start Agent Run](https://docs.gtm.ai/reference/agentscontroller_startagentrun.md): Starts a new run for the specified agent. By default, agent runs are asynchronous. The request returns the in-progress run, including its run id in `data.id`, while execution continues in the… - [List Agent Runs](https://docs.gtm.ai/reference/agentscontroller_listagentruns.md): Lists the run history for a specific agent, with the most recent runs returned first. Use this endpoint to review previous and active runs for the agent. To retrieve the current status and results of… - [Start Agent Run (Stream)](https://docs.gtm.ai/reference/agentscontroller_streamagentrun.md): Starts a new agent run and streams progress and output over Server Sent Events (`text/event-stream`). The first event includes the runId as `task.id`. Store this value so you can retrieve the run… - [Get Agent Run](https://docs.gtm.ai/reference/agentscontroller_getagentrun.md): Retrieves the current status and results of a specific agent run. Use the run id returned in `data.id` by [Start Agent Run](ref:agentscontroller_startagentrun) or the first event of a streaming run… - [Resume Agent Run Stream](https://docs.gtm.ai/reference/agentscontroller_resumeagentrunstream.md): Reconnects to an existing agent run and streams its progress and output using Server-Sent Events (`text/event-stream`). Use this endpoint to reconnect to a run if a [Start Agent Run… ## API Reference: Data Quality API V1 - [Prepare Data Quality](https://docs.gtm.ai/reference/preparecontroller_prepare.md): Processes values (phone, email, address, company name, website, job title, or person name) through the Data Quality pipeline and returns the prepared results. The request body is bulk and… - [List Normalize Configs](https://docs.gtm.ai/reference/normalizeconfigs_listnormalizeconfigs.md): Returns a paginated list of stored normalization configurations, each with its full `name`, `description`, `status`, and `rules`, plus `createdAt`/`updatedAt` under `meta`. Filter by `filter[name]`… - [Create Normalize Config](https://docs.gtm.ai/reference/normalizeconfigs_createnormalizeconfig.md): Creates a new normalization configuration. Provide `name`, an optional `description`, and the `rules` grouped by rule group. Server-assigned fields (`id`, `status`, and timestamps) are ignored on… - [Get Normalize Config](https://docs.gtm.ai/reference/normalizeconfigs_getnormalizeconfig.md): Returns a single normalization configuration by id, including its full `name`, `description`, `status`, and `rules`. Returns `200` with the config. Returns `404` if no config has the given… - [Update Normalize Config](https://docs.gtm.ai/reference/normalizeconfigs_updatenormalizeconfig.md): Partially updates a normalization configuration. Only the attributes present in the request body are changed; omitted attributes are left untouched. Supports updating `name`, `description`, `status`,… - [Delete Normalize Config](https://docs.gtm.ai/reference/normalizeconfigs_deletenormalizeconfig.md): Permanently deletes a normalization configuration along with its rules. Returns `204` with no body on success. Returns `404` if no config has the given `configId`. - [List Score Configs](https://docs.gtm.ai/reference/score_listscoreconfigs.md): Returns a paginated list of attribute-score model configurations. Each item carries the full config definition — `name`, `status`, `modelType`, the ordered `elements` (with their `rules` and… - [Create Score Config](https://docs.gtm.ai/reference/score_createscoreconfig.md): Creates a new score configuration. Provide `name` and the ordered `elements` (each with its `field`, `weight`, and `rules` → `criteria`). Server-assigned fields (`id`, `status`, `modelType`,… - [Get Score Config](https://docs.gtm.ai/reference/score_getscoreconfig.md): Returns a single score configuration by id, including its full `elements` (with their `rules` and `criteria`), `status`, and the derived `fieldsUsedInRules`. Returns `200` with the score config.… - [Update Score Config](https://docs.gtm.ai/reference/score_updatescoreconfig.md): Partially updates a score configuration. Only the attributes present in the request body are changed; omitted attributes are left untouched. Returns `200` with the updated score config. Returns… - [Delete Score Config](https://docs.gtm.ai/reference/score_deletescoreconfig.md): Permanently deletes a score configuration. Returns `204` with no body on success. Returns `404` if no config has the given `configId`. - [Run Scoring](https://docs.gtm.ai/reference/score_runscore.md): Submits a batch of records for scoring and blocks until results are available. Returns `200 OK` with per-record scores inline. Unknown `configIds` are ignored: a well-formed id that does not match… - [List Segment Configs](https://docs.gtm.ai/reference/segments_listsegmentconfigs.md): Returns a paginated list of segment configurations. Each item carries the full config definition including `segments` and their `rules`. Filter by `filter[name]` (case-insensitive contains match on… - [Create Segment Config](https://docs.gtm.ai/reference/segments_createsegmentconfig.md): Creates a new segment configuration. Provide `name`, `action`, and the ordered `segments[]` (each with its `outputValue` and `rules[]`). `mergeOperator` is optional and defaults to `,`.… - [Get Segment Config](https://docs.gtm.ai/reference/segments_getsegmentconfig.md): Returns a single segment configuration by id, including its full `segments[]` / `rules[]` definition and the distinct `fieldsUsedInRules`. Returns `200` with the segment config. Returns `404` if no… - [Update Segment Config](https://docs.gtm.ai/reference/segments_updatesegmentconfig.md): Partially updates a segment configuration. Only the attributes present in the request body are changed; omitted attributes are left untouched. When `segments` is provided, it replaces the existing… - [Delete Segment Config](https://docs.gtm.ai/reference/segments_deletesegmentconfig.md): Permanently deletes a segment configuration. Returns `204` with no body on success. Returns `404` if no config has the given `configId`. - [Run Segmentation](https://docs.gtm.ai/reference/segments_runsegment.md): Submits a batch of records for segmentation and blocks until results are available. Returns `200 OK` with per-record segment assignments inline. Unknown `configIds` are ignored: a well-formed id… ## Recipes - [Authorization Code Flow with PKCE](https://docs.gtm.ai/recipes/codeverifier-with-pcke.md)