Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

GetReport

Returns the contents of a report and the Content-MD5 header for the returned report body.

Description

The GetReport operation returns the contents of a report and the Content-MD5 header for the returned report body. Reports are retained for 90 days from the time they are generated.

You should compute the MD5 hash of the HTTP body and compare that with the returned Content- MD5 header value. If they do not match, it means the body was corrupted during transmission. If the report is corrupted, you should discard the result and automatically retry the request up to three more times. Please notify Amazon MWS if you receive a corrupted report body. The client library for the Reports API section, found on the Amazon MWS website, contains code for processing and comparing Content-MD5 headers. For more information on working with the Content-MD5 header, see the Amazon MWS Developer Guide.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
15 requests One request every minute 60 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Values
ReportId A unique identifier of the report to download. For most reports, this identifier is returned either in the ReportId of the GetReportList operation or in the GeneratedReportId of the GetReportRequestList operation. For sellers in India getting Amazon Easy Ship documents, this identifier is returned in the ReportReferenceId element of the processing report of the Easy Ship Feed. For more information see How to get invoice, shipping label, and warranty documents. Yes Default: none

Type: xs:string

Response elements

Name Description
Report The contents of the report document. Depending on the ReportType, this will either be a tab-delimited flat file, an XML document, or a PDF.

Type: xs:string

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

POST /Reports/2009-01-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
&Action=GetReport
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&ReportId=624169093
&SellerId=A1XEXAMPLE5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T18%3A12%3A20.015Z
&Version=2009-01-01
&Signature=sY%2BEJFLA1gmz78dEOofUcBWSM44%3D

↑ Top

Example response (tab-delimited flat file)

For information about standard response formatting, see Response format.

Show example code Hide example code

  order-id order-item-id purchase-date payments-date buyer-email 
  buyer-name buyer-phone-number sku product-name quantity-purchased 
  currency item-price item-tax shipping-price shipping-tax 
  ship-service-level recipient-name ship-address-1 ship-address-2 
  ship-address-3 ship-city ship-state ship-postal-code ship-country
  ship-phone-number delivery-start-date delivery-end-date 
  delivery-time-zone delivery-Instructions
103-26010-55904 394929210114 2011-02-09T02:46:57-08:00
2011-02-09T02:46:57-08:00 0g9lx423zn5@marketplace.amazon.com 
Joe Customer 404-555-1212 JW-RT1-HLD9 The Structure of Aikido: 
Volume 1: Kenjutsu and Taijutsu Sword and Open-Hand Movement 
Relationships (Structure of Aikido, Vol 1) 1 USD 19.49 0.00 3.99 
0.00 Standard Joe Customer 123 Main Street LAWRENCE CA 90044-2463 
US 404-555-1212

↑ Top