PDP API release notes

These release notes list new features and updates for the Price Discovery and Provisioning (PDP) API. The following sections detail the implementation status and upcoming updates to the Deals and Provisoning schema. For past updates, see PDP API changelog.

NOTE: Stay tuned for updates as we enhance your API experience!

Download the latest schema

The PDP API evolves as the team implements many features while in closed beta. To assist the early adopters working on PDP API integrations, the schema files for Deals and Provisioning are available for download. For field descriptions, see Deals object reference or Provisioning object reference, respectively.

The following table shows the PDP API schemas available for download, publishing details, and respective guides. The PDP API uses the latest version of each schema.

Schema File Last Updated Description Guides
Deals V3 July 27, 2026 The Deals V3 schema describes the terms of a deal, deal types, deal management, deal quality metrics, and deal statuses in the deal life cycle. Deals
Provisioning V3 Mar. 31, 2026 The Provisioning V3 schema contains party identifiers, classifications, and other fields to describe the relationship between the buying party and selling party. Provisioning

PDP API changelog

This changelog documents updates to The Trade Desk Price Discovery and Provisioning (PDP) API, including new features, enhancements, and deprecations. Each entry details the change type, its impact, and any necessary actions to ensure a smooth transition.

General changelog

The following table lists the PDP API changes to the Deals and Known Agents endpoints, ordered by date in descending order. Refer to the table for documentation on different change types, and required actions or lack thereof.

IMPORTANT: If you see "Action Required (Coming Soon)" in the Action Required column, please contact your Technical Account Manager for guidance.

Date Area Change Type Description Action required Learn more
July 7, 2026 Deals Deprecation The dealQualityScore sort input has been deprecated. Use the dealQualityMetrics object to sort deals by the deal quality score. Deal queries
June 25, 2026 Deals Deprecation The mobileApps field has been deprecated. Update your inventory composition workflows to use the apps field. Inventory Composition object
June 25, 2026 Deals Refactor The ObservedInventoryComposition values can now return null. No action required. ObservedInventoryComposition object
June 25, 2026 Deals Addition The nonDecisionedIneligibilityReasons field has been added to the commitmentFinancialTerms object to support non-decisioned deal creation. No action required. Commitment Financial Terms
May 6, 2026 Deals Addition The calculateNonDecisionedTerms field has been added to the commitmentFinancialTerms object to support non-decisioned deal creation. No action required. Commitment Financial Terms
April 29, 2026 Deals Validation The contact object is no longer required in the buyingParty object. No action required. Pick Your Buying Party
April 16, 2026 Deals Addition The mediaType field now supports NATIVE, NATIVE_VIDEO, and UNKNOWN as values. No action required Inventory Selection Enumeration Values
Mar 26, 2026 Provisioning Addition A new SellersJsonMappingsForAccount query has been added. No action required. Known Agents
Mar 26, 2026 Deals Validation Signals in the biddingTerms field can now be set as empty array. You can ignore commitment deal signal requirements by passing an empty array. BiddingTerms Enumeration Values
Feb 16, 2026 Deals Addition Multi-channel support has been added to fixed-price deals. These deals terms accept any combination of channels, except all channels. No action required. Inventory Channel Composition
Jan 29, 2026 Deals Refactor The dateTimeRange field has been deprecated in deal quality filters. To filter deal quality by time, use the lookbackPeriod field. Lookback Period Enumeration Values
Jan 29, 2026 Deals Validation A fixed-price commitment deal must have a minimum bid rate of at least 90% to be eligible for a buying party to target it in a non-decisioned ad group. No action required. Deal Objects
Jan 29, 2026 Deals Addition Multi-channel support has been added to variable-price deals. These deals terms accept any combination of channels, except all channels.
NOTE: Fixed-price commitment deals still allow only one channel.		 No action required. Inventory Channel Composition
Jan 29, 2026 Deals Refactor The displayName now supports up to 256 characters. No action required. Deal Objects
Jan 29, 2026 Deals Refactor The displayName and biddingTerms fields are now optional. No action required. Deal Objects
Jan 29, 2026 Deals Addition The ownerId field has been added to the deal revise, remove, and pause mutations. No action required. Coming Soon
Oct 31, 2025 Deals Addition The inventoryChannelComposition field is now required when creating deals. Add an inventory channel to your deal. Inventory channel composition
Oct 27, 2025 Deals Addition Two new queries have been added to retrieve a list of parties with existing deals. No action required. Deal parties queries
Oct 27, 2025 Deals Addition The HOME_ASSISTANT device type is now supported in CTV, audio, video, and display channels. No action required. Inventory channel
Oct 27, 2025 Deals Addition Deals can now be sorted and filtered chronologically using the lastUpdatedAt and lastUpdatedAtDateTimeRange fields. No action required. Deal queries
Oct 27, 2025 Deals Addition Deals can be filtered by the KAID of the owner using the owner field. No action required. Deal queries
Aug 19, 2025 Deals Rename The inventoryUniqueness field has been renamed to inventoryExclusivity. Update your workflows to use the new name. QualityMetrics object
Jul 29, 2025 Deals Refactor The included field is now required when applying selection types. Update your deal workflows to use the field. Inventory Selection object
Jul 29, 2025 Deals Addition The performanceMetricsType input field has been added to the deal measurements query. This field is required. Update your deal measurement workflows to use the new field. PerformanceMetrics object
Jul 29, 2025 Deals Addition The aggregate input field has been added to the deal measurements query. This field is required. Update your deal measurement workflows to use the new field. PerformanceMetrics object
Jul 29, 2025 Deals Refactor When querying for observed data, the auctionType field has been changed to auctionTypes.
NOTE: This is a different data type that supports multiple auction types, instead of one type.		 Update your deal measurement workflows to use the new field. ObservedData object
June 23, 2025 Deals Refactor The dealStatus enum values have changed.
NOTE: The CANCELLED value spelling is now CANCELED (with one "L").		 Update your deal workflows to use the status values. Deal status values
June 23, 2025 Deals Refactor The currencyCode value can now be revised before a deal is accepted. No action required. Revise deals
June 23, 2025 Deals Refactor The dealId and knownAgentId fields in contributing deals have been renamed to id and ownerId, respectively. No action required. Contributing deals
June 23, 2025 Deals Refactor The minDailyAvails and minWinRate fields are no longer required when querying deals. No action required. Deal queries
June 23, 2025 Deals Rename The sellerId field has been renamed to sellingPartyId. Update your workflows to use the new name. Inventory Composition object
June 23, 2025 Deals Rename The buyerId and buyerName fields have been renamed to buyingPartyId and buyingPartyName, respectively. Update your workflows to use the new names. N/A
June 23, 2025 Deals Addition The contributingDeals object now supports the isRemoved filter. No action required. Contributing deals
June 23, 2025 Deals Removal The contributingDealsUpdate mutation has been removed. Use the dealRevise mutation to update your contributing deals. Contributing deals
June 23, 2025 Deals Rename The VideoDimensions object now uses the width and height field instead of w and h. Update your field names accordingly. N/A
June 23, 2025 Deals Rename The contact field in the dealNoteCreate mutation has been renamed to createdBy. Update the mutation to use the new field name. Deal notes
May 30, 2025 Deals Rename The PositiveAndNegativeSelection and PositiveOrNegativeSelection objects have been renamed to the SingleSelection and MultiSelection objects, respectively. No action required. Inventory Selection object
May 30, 2025 Deals Refactor The biddingTerms field has been moved to the inventoryComposition object. Update your workflows to follow the new structure. Inventory Composition object
May 30, 2025 Deals Addition A new required cancellationTerms field has been added to commitment deals. Calls must include the new field. Update your commitment deal workflows to provide cancellation terms. Deal terms
May 30, 2025 Deals Refactor The mediaComposition object has been refactored into the inventoryChannelComposition object. Calls that include the old fields return an error. Update your deal workflows to follow the new structure. Inventory channel objects
May 30, 2025 Deals Rename The supplyComposition object has been renamed to inventoryComposition. Calls that include the old fields use the wrong object. Update your deal workflows to use the new name. Inventory Composition object
May 30, 2025 Deals Addition The expansionTerms object now requires a threshold field. Calls that don't include the new field return an error. Update your deal expansion workflows to use threshold. Deal expansion
May 30, 2025 Deals Rename The violationPeriod field has been renamed to period. Calls that include the old fields now return an error. Update your workflows to use period instead of violationPeriod. Deal expansion
May 30, 2025 Deals Removal The activationMode field has been removed from the expansion terms. Calls that include this field now return an error. Remove the activationMode field from your queries and mutations. Deal expansion
May 30, 2025 Deals Removal The managed and external deal objects have been removed. Update your deal workflows to remove these objects. N/A
May 30, 2025 Deals Rename The contact object has been renamed to contacts and supports a list of party contacts. Calls that include the old field now return an error. Update your mutations use contacts instead of contact. Deal object
May 30, 2025 Deals Rename The inventorySupplier object has been renamed to sellingParty. Calls that include the old field now return an error. Update your mutations to replace inventorySupplier with sellingParty. Deal object
May 30, 2025 Deals and Known Agents Rename The inventorySupplierId field has been renamed to accountId. Calls that include the old field now return an error. Update your mutations to use accountId instead of inventorySupplierId. N/A
May 30, 2025 Deals Refactor The biddingPermissions field has been renamed to buyingPermissions, moved to the top-level Deal object, and is no longer required. Calls that follow the old structure now return an error. Update your deal queries and mutations with the new structure.
  • Initiate and negotiate deals
  • BuyingPermissions object
May 30, 2025 Known Agents Rename The buyer field has been renamed to agency. Calls that include the old fields now return an error. Update your known agent queries to replace buyer with agency. Known agent objects
May 30, 2025 Known Agents Replacement The KnownAgentBuyer object has been replaced by the KnownAgentAgency object. Update any known agent filters that searched for the BUYER value to use the AGENCY value. Known agents
May 15, 2025 Deals Refactor The VideoDimensions object has been changed to remove the adformats and dimensions fields. Calls that include the old fields now return an error. Apply dimensions directly within the included and excluded fields. VideoChannelComposition
May 15, 2025 Deals Enhancement A new optional startDelay field has been added to the AudioComposition object. No action required. AudioChannelComposition
May 15, 2025 Known Agents Replacement The KnownAgentReseller object has been replaced by the KnownAgentIntermediary object. Update any known agent filters that searched for the RESELLER value to use the INTERMEDIARY value. Known agents
May 15, 2025 Deals Rename The discountPercentage field has been renamed to discountPercent. Calls that include the old field now return an error. Update your deal workflows to replace discountPercentage with discountPercent. N/A
May 15, 2025 Deals Rename The mediaSpend field has been renamed to mediaSpendGoal. Calls that include the old field are deprecated. Update your deal workflows to use mediaSpendGoal instead of mediaSpend.
  • CommitmentFinancialTerms object
  • EndeavorFinancialTerms object
May 15, 2025 Deals Rename The inventoryBuyer field has been renamed to buyingParty. Calls that include the old field now return an error. Update your deal workflows to use buyingParty instead of inventoryBuyer. Deal object reference
May 6, 2025 Deals Refactor The includedValues field in customAttributes now only requires a single list instead of a list of lists. Calls that use a nested list now return an error. Remove the outside list from your respective queries and mutations. CustomAttributes object
May 6, 2025 Deals Removal The reseller and resellerId fields have been removed from deal terms. Calls that include these old fields now return an error. Remove the reseller and resellerId field from your respective queries and mutations. N/A
May 6, 2025 Deals Rename The Section enumeration type has been renamed to CustomAttributeSection. No action required. Section enumeration values
May 6, 2025 Deals Rename The firstPartyData object has been renamed to customAttributes. Calls that include the old field now return an error. Update your deal workflows to use customAttributes instead of firstPartyData. CustomAttributes object
May 6, 2025 Deals Rename Logical objects that previously used the "Targeting" suffix have been renamed to use "Selection" instead. For example, PositiveAndNegativeTargeting is now PositiveAndNegativeSelection. No action required. Composition selection types
May 6, 2025 Deals Rename Deal term fields that previously used the "Targeting" suffix have been renamed to use "Composition" instead. For example, supplyTargeting is now supplyComposition. Update your deal workflows to use the new fields with "Composition." Inventory composition terms.
May 6, 2025 Deals Rename The dimensions field in the VideoComposition object has been renamed to videoDimensions. Calls that include the old field now return an error. Update the dimensions field to videoDimensions when using video composition. VideoChannelComposition object
May 6, 2025 Deals Addition The base and expansion objects have been added to support deal expansion. Calls without the base object now return an error. Add the base object when using the PositiveAndNegativeSelection or PositiveOrNegativeSelection objects. Deal expansion
Apr. 30, 2025 Deals Addition The sellerIds and publisherIds fields have been changed to use the include and exclude values for positive or negative logic. Calls that include these old fields now return an error. Update the fields to use the PositiveOrNegativeSelection object. Inventory Selection object
Apr. 24, 2025 Deals Removal The makegoodsTerm field has been removed from the deal terms. Calls that include this field now return an error. Remove the makegoodsTerm field from your queries and mutations. N/A
Mar. 27, 2025 Known Agents Enhancement A new knownAgent query filter for parentKnownAgentId is now available to identify accounts based on the parent known agent. No action required. Known agents
Mar. 27, 2025 Known Agents Enhancement A new optional logourl field has been added to the seller known agent and reseller known agent objects. No action required. Known agent objects

Feature status updates

The PDP API documentation and schema may include fields that are currently under development and might not be fully functional at the time of release.

The following labels are used to describe feature status:

The following table lists the statuses of non-functional queries and mutations, including fields in the PDP API.

Status Field Operation Type
In development deals.terms.spendTiers Mutation field
Planned deals.terms.financialTerms.minCpmPerSec Mutation field