Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141713478.8 KB

Returns the per-billing-month allocation history for credits applied to an Amazon Web Services account's bills. Traverses the consolidated billing family to capture cross-account credit applications. Supports pagination and optional filtering to a single credit.

post/#X-Amz-Target=AWSBilling.GetCreditAllocationHistory

Headers

X-Amz-Target'AWSBilling.GetCreditAllocationHistory' required

Request body

accountIdstring required

The Amazon Web Services account ID whose allocation history to retrieve. Must be a 12-digit numeric string.

creditIdinteger

Filters the result to a single credit. When omitted, returns allocation entries for all credits.

startDatestring date-time required

Inclusive start date as Unix epoch seconds. Must be on or before <code>endDate</code>. The range from <code>startDate</code> to <code>endDate</code> cannot exceed 24 billing months.

endDatestring date-time required

Inclusive end date as Unix epoch seconds.

nextTokenstring

Pagination token from a previous response. Pass the value returned in <code>nextToken</code> to retrieve the next page of results.

maxResultsinteger

The maximum number of records to return per page. Range: 1 to 1000. Default: 100.

Response

Success

partialResultsboolean required

<code>true</code> when data could not be retrieved for one or more billing months. The <code>failedMonths</code> field lists which months are missing.

failedMonthsBillingMonth[]

Billing months in <code>YYYY-MM</code> format that failed to return data. Non-empty only when <code>partialResults</code> is <code>true</code>.

nextTokenstring

Pagination token. Present when more pages are available; <code>null</code> when there are no more results.