listActionPlans

get

https://sellingpartnerapi-na.amazon.com/actionPlans/2026-06-01/plans

Returns a paginated list of the seller's action plans, sorted newest first by createdDate. Multiple filters are combined with a logical AND. Multiple values in a single filter are combined with a logical OR.

Query Params

statuses

array of strings

Filters by plan status.

statuses

Allowed:

planTemplateIds

array of strings

Filters by plan template IDs. Multiple values allowed.

planTemplateIds

actionItemIds

array of strings

Filters by associated action item IDs. Multiple values allowed.

actionItemIds

createdAfter

date-time

Plans created at or after this timestamp. Timestamp is in ISO 8601 format.

createdBefore

date-time

Plans created at or before this timestamp. Timestamp is in ISO 8601 format.

pageSize

integer

≤ 20

Defaults to 10

Maximum number of results per page.

pageToken

string

A token to retrieve a specific page of results. Pass the nextToken value from a previous response.

Note: The previousToken value is not yet supported.

locale

string

The locale for localized content, as an ISO 639 language code and ISO 3166 country code separated by a hyphen. Defaults to en-US.

includedData

array of strings

Additional data to return in the response. Specify steps to return each plan's steps with their resolved input and output values.

includedData

Allowed:

Responses

Language

Loading…

Response

Choose an example:

application/json

200Success.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.