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

GetReportListByNextToken

Returns a list of reports using the NextToken, which was supplied by a previous request to either GetReportListByNextToken or GetReportList, where the value of HasNext was true in the previous call.

Description

The GetReportListByNextToken operation returns a list of reports that match the query parameters, using the NextToken, which was supplied by a previous call to either GetReportListByNextToken or a call to GetReportList, where the value of HasNext was true in the previous call.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
30 requests One request every two seconds 1800 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
NextToken A string token returned in a previous call. Use the NextToken to call the operation again if the return value of HasNext is true. Yes Type: xs:string

Response elements

Name Description
NextToken A string token used to pass information to another call. Use the NextToken to call the operation again if the value of HasNext is true.

Type: xs:string

HasNext A Boolean value that indicates whether there are more items to return, requiring additional calls to this operation to retrieve them. The value is true if there are more items to retrieve; otherwise false.

Type: xs:boolean

ReportInfo Detailed information about a report.

Type: ReportInfo

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
&Acknowledged=false
&Action=GetReportListByNextToken
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&NextToken=2YgYW55IPQhvu5hbCBwbGVhc3VyZS4=
&ReportTypeList.Type.1=_GET_MERCHANT_LISTINGS_DATA_
&SellerId=A1XEXAMPLE5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T18%3A12%3A19.796Z
&Version=2009-01-01
&Signature=3yvUqWWBpLDld9CCx0ANjVU95ks%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetReportListByNextTokenResponse
    xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <GetReportListByNextTokenResult>
        <NextToken>none</NextToken>
        <HasNext>false</HasNext>
        <ReportInfo>
            <ReportId>898899473</ReportId>
            <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
            <ReportRequestId>2278662938</ReportRequestId>
            <AvailableDate>2009-02-10T09:22:33+00:00</AvailableDate>
            <Acknowledged>false</Acknowledged>
        </ReportInfo>
    </GetReportListByNextTokenResult>
    <ResponseMetadata>
        <RequestId>fbf677c1-dcee-4110-bc88-2ba3702e331b</RequestId>
    </ResponseMetadata>
</GetReportListByNextTokenResponse>

↑ Top