GET /api/v2/buyer/advertisers/{advertiserId}/event-sources
Returns the event sources registered on an advertiser. Each source is an event data pipeline (pixel, SDK, warehouse sync, CRM feed, MMP feed) that log-event references by event_source_id. Register or update sources with Sync event sources.
Request
Parameters
Response
eventTypes is null when the source accepts all types. mapping, integrationPlatform, and testEventCode are Apostra extensions populated by Sync event sources. valueCurrencies, actionSource, and surface are null until declared in a sync; a source without valueCurrencies stays on legacy event compatibility and is not eligible for canonical ROAS.
health carries two independent signals, never merged: health.status (not_seen, receiving, or needs_attention) is Scope3’s own observed ingestion pipeline state, updated from accepted or rejected log-event calls. health.grade (insufficient, minimum, good, or excellent) is the AdCP assessment grade, derived from ingestion recency and unresolved errors — a source with no events yet, or whose most recent signal is an unresolved error, is insufficient; one that received events before but nothing in the last 7 days is minimum; within 7 days but not 24 hours is good; within the last 24 hours with no active error is excellent.
managedBy is buyer for sources you register through sync, or seller for sources a seller provisions directly; sellerId names the seller account a source has been provisioned on, once known. total is the count matching the query, ignoring pagination.
Errors
404 NOT_FOUND—advertiserIddoes not exist or is not visible to the authenticated account.
Related
Event source tasks
All event source operations
Log Events guide
How event sources and log-event fit together
Sync event sources
Register or update source configs
Conversion API
Identity-hashing rules and event payloads