Skip to content

Kuudo

Search Kuudo

Loading search…

<- Guides
Amazon Ads · Reporting

Amazon Ads Reporting v3 Deprecation: What Changes

Legacy reporting APIs retire in June 2027. Understand the v1 replacement, check changed measurement definitions, and start with one familiar report.

Amazon Ads reporting v3 deprecation affects sponsored ads and DSP workflows. Learn the June 2027 deadline, v1 changes and the AI-assisted migration path.

Kuudo
Reviewed by Kuudo Engineering
An illustrative ChatGPT migration plan identifies legacy v3 reporting jobs, maps them to v1 fields, and compares one report through Ads MCP before the June 2027 API retirement.
Illustrative API migration plan: define the replacement and compare its meaning before switching the reporting job.
TL;DR
  • Amazon lists June 30, 2027 as the hard shutoff for legacy v3 reporting across sponsored ads and DSP. Move affected API workflows before that date.
  • Reporting API v1 uses compatible fields instead of fixed report types and supports multidimensional, cross-product and authorized cross-account reports.
  • Ads MCP supports v1; the Reporting Skill supplies familiar template mappings and the report lifecycle. Compare definitions before replacing jobs.

Amazon Ads reporting v3 deprecation means legacy sponsored ads and Amazon DSP (demand-side platform) API reporting workflows need a replacement before Amazon's June 30, 2027 shutoff. Reporting API v1 is the successor for ad hoc and periodic reports. Inventory affected jobs, preserve their definitions and compare a v1 result before switching production reporting.

An agency's weekly sales number may exclude particular accounts or count only the advertised products. An endpoint change cannot preserve those rules by itself. Bring the old field list, account exclusions and sales definition to the Amazon Ads MCP and Reporting Skill, so the replacement report gets checked against the number your team has agreed to deliver.

The API sunset covers v3 sponsored ads and DSP reports

Amazon's reporting deprecation covers v3 report types for Sponsored Products, Sponsored Brands, Sponsored Display and DSP. Sponsored ads v2 reporting is also affected. The September 2026 announcement applies across API regions and advertiser types, and identifies June 30, 2027 as the shutoff date. Migrate before that date; the notice does not establish a cutoff hour or timezone. Amazon's deprecation announcement.

Start by finding the integration behind each recurring report. An agency platform, internal script or warehouse connector may own the job even when its output arrives as an ordinary spreadsheet. Record the responsible owner and whether the provider has a migration plan. Campaign metadata exports are outside this reporting retirement.

The legacy console report pages have an earlier December 2026 transition. That is a separate deadline: follow the console migration guide for saved schedules and historical downloads.

Reporting API v1 selects fields instead of fixed report types

Reporting API v1 defines reports through compatible dimensions and metrics. Amazon supports multidimensional, cross-ad-product and cross-account reporting, allowing combinations previously divided across separate report types. Account access and field availability still constrain each request. The v1 overview explains the replacement model.

Legacy starting pointReporting API v1 starting point
Pick a predefined report typeSelect compatible fields and row grain
Separate product or account reportsUse supported cross-product and authorized account scope
Product-specific metric labelsUse standardized Traffic, Engagement and Conversion categories

Traffic describes delivery and cost, Engagement describes interaction with the ad, and Conversion describes attributed outcomes. Flexibility does not make every field combination valid. Dimensions, attributes and metrics have compatibility rules; some financial metrics also require currency fields. Amazon's reporting concepts describe those constraints.

Standardized metrics need a comparison before replacement

The same business label can produce a different total after migration. For DSP, conversions now follow the traffic date, when the ad interaction occurred. Base purchases and detail-page-view metrics also include promoted and halo conversions. A promoted-only legacy comparison needs the corresponding promoted metric. Attribution interval suffixes leave metric names; campaign-default windows apply. Amazon's measurement changes explain these differences.

Compare old and new definitions before interpreting a discrepancy as a campaign performance change:

  • Match account, campaign, product and date scope.
  • Keep row grain, campaign timezone, currency and filters consistent.
  • Document attribution and promoted-versus-halo meaning.
  • Identify missing fields, derived calculations and required joins.

Track affected reporting jobs in a migration register:

RecordCapture for each job
Legacy jobReport name and integration
OwnerResponsible team or provider
DefinitionAccount scope, grain, fields and formulas
Replacementv1 request and field gaps
AcceptanceComparison decision

Completion alone does not establish legacy-column parity.

One checked v1 report provides a practical migration starting point

Kuudo's Amazon Ads MCP supports v1 report creation and retrieval. The Amazon Ads Reporting Skill adds premade Sponsored Products, Sponsored Brands and Sponsored Display definitions, with mapping notes for partial coverage and split requests. These templates reduce the work of assembling a new field definition; they do not promise exact legacy parity.

Choose one important report, capture its business definition and select the matching template. The connected AI client can prepare the request, create the asynchronous job, preserve its report ID and retrieve the completed files. The practical AI reporting guide provides the full template inventory, reusable reporting brief and copyable request.

Pace automated jobs within Amazon's rate, concurrency and report-size limits. The current v1 guidance applies limits per client ID across advertiser accounts. For continuous, high-volume or near-real-time acquisition, Amazon points teams toward Marketing Stream. Limits and best practices distinguish those use cases.

What happens next: compare one legacy report with its v1 replacement

Assign an owner to the first comparison. Keep its old definition, v1 request, field differences and acceptance decision together, then use that checked pattern for the remaining jobs before the API deadline. Follow the AI migration and reporting workflow when you are ready to run the comparison through Ads MCP and the Skill.

If your team also relies on console schedules, preserve those reports through the earlier unified reporting migration.

Private beta

Start with a familiar report

Use Amazon Ads MCP and the Reporting Skill to prepare and run a v1 replacement. The practical guide lists the bundled templates and a request you can adapt to your reporting rules.

See the AI reporting workflow

What you need to run reporting API migration

scope
Legacy v3 sponsored ads and DSP API reporting; console schedules have a separate December 2026 timeline
replacement
Amazon Reporting API v1; compatible dimensions and metrics with standardized measurement
automation
Amazon Ads MCP with authorized access and amazon-ads-reporting v0.4.4 in a compatible AI client
verification
Primary Amazon documentation and Kuudo tool/Skill sources checked November 6, 2026; no account report executed for this announcement
Related reading

Keep exploring reporting API migration

Use these companion guides to understand the inputs, follow-on analysis, and adjacent workflows behind this playbook.

FAQ

Is Reporting API v1 the same as the old sponsored ads v1 reporting API?

No. This announcement concerns the new Amazon Ads Reporting API v1 with flexible field-based report definitions. Use the current v1 documentation and compatible reporting tools rather than infer behavior from an older endpoint version label.

Does an unchanged campaign guarantee matching legacy and v1 totals?

No. Check the date basis, attribution window, currency, report grain and promoted-versus-halo scope. DSP conversion reporting now follows traffic date, and standardized base purchases and detail page views include promoted plus halo conversions.

Sources