GET /v3/crmdata/segment/{advertiserId}/{crmDataId} → Advertiser.crmDataSegmentStatus

Overview

Property	Value
REST endpoint	`GET /v3/crmdata/segment/{advertiserId}/{crmDataId}`
GraphQL query	Advertiser.crmDataSegmentStatus
Return type	`CrmDataSegmentStatus`

Request and filter field mapping

REST field	GraphQL argument	GraphQL type	Required	Notes
`advertiserId`	(parent—Advertiser.id)	ID!	Required	Path parameter; resolved via parent Advertiser, not a public arg on `crmDataSegmentStatus`.
`crmDataId`	`crmDataId`	ID!	Required	Required resolver arg on Advertiser.`crmDataSegmentStatus`.

Response field mapping

REST response field	GraphQL field	GraphQL type	Nullable	Notes
`AdvertiserId`	(parent—Advertiser.id)	ID!	Not nullable	Omitted from CrmDataSegmentStatus; available from parent Advertiser.
`CrmDataId`	(CrmDataSegment.id)	ID!	Not nullable	Omitted from CrmDataSegmentStatus; available via `crmDataId` arg or `crmDataSegment`(id:) query.
`SegmentName`	(CrmDataSegment.name)	String!	Not nullable	Omitted from CrmDataSegmentStatus; available on CrmDataSegment.name.
`FirstPartyDataId`	`firstPartyDataId`	ID	Nullable	N/A
`ActiveIds`	`activeIds`	Long	Nullable	N/A
`ReceivedIds`	`receivedIds`	Long	Nullable	N/A
`LastUpdatedAt`	`lastUpdatedAt`	DateTime	Nullable	N/A
`Region`	(CrmDataSegment.region)	CrmDataRegion!	Not nullable	Omitted from CrmDataSegmentStatus; available on CrmDataSegment.region.
`SegmentType`	`segmentType`	SegmentType!	Not nullable	REST enum Targeting/TargetingNPI/Conversion maps to GraphQL SegmentType (TargetingNpi in schema).
`LatestActivatedDrop.State`	`latestActivatedDrop.state`	CrmDataDropState!	Not nullable	N/A
`LatestActivatedDrop.PiiType`	`latestActivatedDrop.piiType`	CrmDataPiiType!	Not nullable	REST field deprecated 2026-10-04; maps single PiiType only.
`LatestActivatedDrop.PiiTypes`	`latestActivatedDrop.piiType`	CrmDataPiiType!	Not nullable	Not currently available in GraphQL
`LatestActivatedDrop.MergeMode`	`latestActivatedDrop.mergeMode`	MergeMode!	Not nullable	N/A
`LatestActivatedDrop.SegmentType`	`latestActivatedDrop.segmentType`	SegmentType!	Not nullable	N/A
`LatestActivatedDrop.TtlInMinutes`	`latestActivatedDrop.ttlInMinutes`	Long!	Not nullable	N/A
`LatestActivatedDrop.RetentionEnabled`	`latestActivatedDrop.retentionEnabled`	Boolean!	Not nullable	N/A
`LatestActivatedDrop.RetentionRemainingInDays`	`latestActivatedDrop.retentionRemainingInDays`	Long!	Not nullable	N/A
`LatestActivatedDrop.CreatedAt`	`latestActivatedDrop.createdAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.PiiUploadedAt`	`latestActivatedDrop.piiUploadedAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.ProcessingAt`	`latestActivatedDrop.processingAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.IngestedAt`	`latestActivatedDrop.ingestedAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.SucceededAt`	`latestActivatedDrop.succeededAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.CancelledAt`	`latestActivatedDrop.cancelledAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.FailedAt`	`latestActivatedDrop.failedAt`	DateTime	Nullable	N/A
`LatestActivatedDrop.FailureMessage`	`latestActivatedDrop.failureMessage`	String	Nullable	N/A
`LatestActivatedDrop.ReceiptFileUrl`	`latestActivatedDrop.receiptFileUrl`	String	Nullable	N/A
`LatestActivatedDrop.Statistics.TotalRecords`	`latestActivatedDrop.statistics.totalRecords`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.ValidRecords`	`latestActivatedDrop.statistics.validRecords`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.UniqueIdDeficit`	`latestActivatedDrop.statistics.uniqueIdDeficit`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.SucceededRecords`	`latestActivatedDrop.statistics.succeededRecords`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.FailedRecords`	`latestActivatedDrop.statistics.failedRecords`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.EmptyRecords`	`latestActivatedDrop.statistics.emptyRecords`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.EmailRecordsNotInAcceptedEmailDomain`	`latestActivatedDrop.statistics.emailRecordsNotInAcceptedEmailDomain`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.EmailHashRecordsNotBase64EncodedSha256`	`latestActivatedDrop.statistics.emailHashRecordsNotBase64EncodedSha256`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.EmailInvalidFormat`	`latestActivatedDrop.statistics.emailInvalidFormat`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.IngestedInvalidCsvFormat`	`latestActivatedDrop.statistics.ingestedInvalidCsvFormat`	Long	Nullable	N/A
`LatestActivatedDrop.Statistics.IngestedRecords`	`latestActivatedDrop.statistics.ingestedRecords`	Long	Nullable	N/A

Code examples

REST example

GET /v3/crmdata/segment/{advertiserId}/{crmDataId} HTTP/1.1
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

GraphQL example

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

query CrmDataSegmentStatus {
  advertiser(id: "adv123") {
    crmDataSegmentStatus(crmDataId: "crm-segment-id") {
      firstPartyDataId
      activeIds
      receivedIds
      lastUpdatedAt
      segmentType
      latestActivatedDrop {
        state
        mergeMode
        ttlInMinutes
      }
    }
  }
}