Request billing adjustments

Requests one or more invoice adjustments (refunds) in a single call, forwarded to
the AWS Marketplace BatchCreateBillingAdjustmentRequest API.

Entries succeed and fail independently. The response is 202 Accepted with
two parallel arrays: billingAdjustments for entries AWS accepted, and errors
for entries it rejected. Match each result to its request entry by clientToken.
A 202 with an empty billingAdjustments array means every entry failed. Inspect
errors before treating the call as successful.

Accepted entries start at PENDING. AWS takes up to 72 hours to move an entry to
COMPLETED or VALIDATION_FAILED. Poll the list endpoint or subscribe to the
agreement_billing_adjustment_updated webhook rather than blocking on the
response.

clientToken is the idempotency key and must be unique per entry, not per
request. Replaying a token returns the original result instead of creating a
second adjustment.

Each adjustmentAmount is an unsigned magnitude (e.g. "200.00"), matching
AWS Marketplace create and read — the resource type implies a credit. Its value
must not exceed that invoice's pricingCurrencyAmount.maxAdjustmentAmount.
currencyCode must match the invoice currency. AWS enforces both and reports
violations as per-entry VALIDATION_EXCEPTION errors, not as a request-level
400.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≤ 64
^[A-Za-z0-9_/-]+$

AWS Marketplace agreement identifier

Body Params
billingAdjustments
array of objects
required
length between 1 and 5

The adjustments to request. Each entry is evaluated independently. The maximum
of 5 is a Tackle limit, not an AWS one.

billingAdjustments*
string
required
length ≤ 64
^[a-zA-Z0-9-]+$

Idempotency key, unique per entry rather than per request. Also the key
that matches this entry to its result or error in the response.

string
required
length ≤ 255

The invoice to adjust

string
required
^[0-9]+(\.[0-9]{1,8})?$

Unsigned decimal amount to adjust, as a string to avoid float rounding.
Matches AWS Marketplace BatchCreateBillingAdjustmentRequestEntry (pattern
[0-9]*(\.[0-9]{0,8})?). Must not exceed the invoice's
pricingCurrencyAmount.maxAdjustmentAmount.

string
required
length between 3 and 3

ISO 4217 code. Must match the invoice currency.

string
enum
required

Why the adjustment is being requested. This set is not interchangeable with
the cancellation reason codes.

Allowed:
string
length ≤ 500

Free-text detail retained with the request

Headers
string

The Tackle vendor this request operates on. Must be one of the vendors your token
permits, or the request is rejected with 403.

Optional only for single-vendor tokens, where it defaults to the token's primary
vendor. Multi-vendor callers should always send it — the fallback picks an
arbitrary vendor from the organizational unit, not a meaningful default.

Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json