POST /v3/delta/bidlist/query/global → Query.globalBidListDelta(input: GlobalBidListDeltaInput)

Overview

Property	Value
REST endpoint	`POST /v3/delta/bidlist/query/global`
GraphQL query	Query.globalBidListDelta(input: GlobalBidListDeltaInput)
Return type	`BidListDelta`

Request and filter field mapping

REST field	GraphQL argument	GraphQL type	Required	Notes
`PartnerId`	`input.partnerId`	ID	Optional	Optional partner scope filter for global bid lists visible to that partner.
`LastChangeTrackingVersion`	`input.lastChangeId`	ID	Optional	String form of the REST tracking version. Pass null or omit for the latest change ID.
`ReturnEntireBidList`	N/A	N/A	Optional	Not currently available in GraphQL

Response field mapping

REST response field	GraphQL field	GraphQL type	Nullable	Notes
`LastChangeTrackingVersion`	`nextChangeTrackingVersion`	Long!	Not nullable	Use the string form as `input.lastChangeId` on the next delta call.
`ElementIds`	`changedBidLists[].bidList.id`	ID!	Not nullable	Derive IDs from `changedBidLists { bidList { id } }` when not selecting full bid list fields.
`BidLists`	`changedBidLists`	[BidListDeltaEntry!]!	Not nullable	Each entry wraps a `BidList` entity reference plus optional `isDeleted`.
`MoreBidListsAvailable`	`moreBidListsAvailable`	Boolean	Nullable	True when additional changed bid lists exist beyond this page.

Endpoint-specific nested types and enums

BidListDeltaEntry

REST field	GraphQL field	GraphQL type	Nullable	Notes
`BidLists[].IsDeleted`	`isDeleted`	Boolean	Nullable	True when the bid list was deleted; null when REST returned IDs only.
`BidLists[].BidListId`	`bidList.id`	ID!	Not nullable	Entity reference to the changed bid list.

BidList (via `changedBidLists[].bidList`)

REST field (BidListSummary)	GraphQL field	GraphQL type	Nullable	Notes
BidListId	`id`	ID!	Not nullable	N/A
Name	`name`	String!	Not nullable	N/A
BidListSource	`source`	BidListSource!	Not nullable	N/A
BidListAdjustmentType	`adjustmentType`	BidListAdjustmentType!	Not nullable	N/A
ResolutionType	`resolutionType`	MultipleMatchResolutionType!	Not nullable	N/A
BidLinesCount	`bidLinesCount`	Int!	Not nullable	N/A
BidListOwner	`ownerType`	BidListOwnerType!	Not nullable	REST `BidListOwner` enum → `ownerType`.
BidListOwnerId	`owner`	BidListOwner	Nullable	Entity reference for the owning partner/advertiser/campaign/ad group.
IsGlobal	N/A	N/A	N/A	Not currently available in GraphQL
IsDeleted	`isDeleted`	Boolean	Nullable	On parent `BidListDeltaEntry`, not on `BidList`.
BidListDimensions	`dimensions`	[BidListDimension!]!	Not nullable	N/A
IsAvailableForLibraryUse	`isAvailableForLibraryUse`	Boolean!	Not nullable	N/A

Code examples

The following are examples of querying global bid list deltas with REST and GraphQL.

Basic delta query:

REST example

POST /v3/delta/bidlist/query/global HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

{
  "PartnerId": "partner789",
  "LastChangeTrackingVersion": null,
  "ReturnEntireBidList": false
}

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query GlobalBidListDelta {
  globalBidListDelta(input: {
    partnerId: "partner789"
  }) {
    nextChangeTrackingVersion
    moreBidListsAvailable
    changedBidLists {
      isDeleted
      bidList {
        id
      }
    }
  }
}

Full bid list summary fields:

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query GlobalBidListDeltaWithSummaries {
  globalBidListDelta(input: {
    partnerId: "partner789"
    lastChangeId: "100"
  }) {
    nextChangeTrackingVersion
    moreBidListsAvailable
    changedBidLists {
      isDeleted
      bidList {
        id
        name
        source
        adjustmentType
        resolutionType
        bidLinesCount
        dimensions
        isAvailableForLibraryUse
        ownerType
      }
    }
  }
}