listTransactions

get

https://sellingpartnerapi-na.amazon.com/finances/2024-06-19/transactions

Returns transactions for the given parameters. Financial events might not include orders from the last 48 hours.

Usage plan:

Rate (requests per second)	Burst
0.5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits.

❗️
To view the response
The response to this operation cannot be displayed in this reference because of technical issues. For this operation's response schema, refer to listTransactions.

Query Params

postedAfter

date-time

The response includes financial events posted on or after this date. This date must be in ISO 8601 date-time format. The date-time must be more than two minutes before the time of the request.

This field is required if you do not specify a related identifier.

postedBefore

date-time

The response includes financial events posted before (but not on) this date. This date must be in ISO 8601 date-time format.

The date-time must be later than PostedAfter and more than two minutes before the request was submitted. If PostedAfter and PostedBefore are more than 180 days apart, the response is empty.

Default: Two minutes before the time of the request.

marketplaceId

string

The identifier of the marketplace from which you want to retrieve transactions. The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace, refer to Marketplace IDs.

transactionStatus

string

The status of the transaction.

Possible values:

DEFERRED: the transaction is currently deferred.
RELEASED: the transaction is currently released.
DEFERRED_RELEASED: the transaction was deferred in the past, but is now released. The status of a deferred transaction is updated to DEFERRED_RELEASED when the transaction is released.

relatedIdentifierName

string

The name of the relatedIdentifier.

Possible values:

FINANCIAL_EVENT_GROUP_ID: the financial event group ID associated with the transaction.
ORDER_ID: the order ID associated with the transaction.

Note:

FINANCIAL_EVENT_GROUP_ID and ORDER_ID are the only relatedIdentifier with filtering capabilities at the moment. While other relatedIdentifier values will be included in the response when available, they cannot be used for filtering purposes.

relatedIdentifierValue

string

The value of the relatedIdentifier.

nextToken

string

The response includes nextToken when the number of results exceeds the specified pageSize value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until nextToken is null. Note that this operation can return empty pages.

Responses

Language

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.