---
title: "POST /#X-Amz-Target=AWSBilling.GetCreditAllocationHistory"
method: POST
path: "/#X-Amz-Target=AWSBilling.GetCreditAllocationHistory"
---

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

`POST /#X-Amz-Target=AWSBilling.GetCreditAllocationHistory`

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.

## Headers

- `X-Amz-Target` 'AWSBilling.GetCreditAllocationHistory', required

## Request body

- GetCreditAllocationHistoryRequest
  - `accountId` string, required — The Amazon Web Services account ID whose allocation history to retrieve. Must be a 12-digit numeric string.
  - `creditId` integer — Filters the result to a single credit. When omitted, returns allocation entries for all credits.
  - `startDate` string, 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.
  - `endDate` string, date-time, required — Inclusive end date as Unix epoch seconds.
  - `nextToken` string — Pagination token from a previous response. Pass the value returned in <code>nextToken</code> to retrieve the next page of results.
  - `maxResults` integer — The maximum number of records to return per page. Range: 1 to 1000. Default: 100.

## Response `200`

Success

- GetCreditAllocationHistoryResponse
  - `creditAllocationHistoryList` CreditAllocationHistoryEntry[] — Allocation entries sorted by <code>billingMonth</code> in descending order.
    - `creditId` string, required — The identifier of the credit that was applied.
    - `creditAmount` object, required — The amount of credit applied. Negative values represent credits that reduced the bill.
      - `currencyCode` string, required — The ISO 4217 currency code for the amount (for example, <code>USD</code>).
      - `currencyAmount` string, required — The amount as a decimal string (for example, <code>"743.21"</code>). Negative values represent credits that reduce a bill.
    - `description` string — A human-readable description of the credit allocation.
    - `accountId` string, required — The Amazon Web Services account the credit was applied to.
    - `appliedServiceName` string, required — The Amazon Web Services service the credit was applied to.
    - `billingMonth` string, required — The billing month of the application in <code>YYYY-MM</code> format.
    - `isEstimatedBill` boolean, required — <code>true</code> when the entry was applied to an in-flight bill that has not yet been finalized.
  - `partialResults` boolean, 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.
  - `failedMonths` BillingMonth[] — Billing months in <code>YYYY-MM</code> format that failed to return data. Non-empty only when <code>partialResults</code> is <code>true</code>.
  - `nextToken` string — Pagination token. Present when more pages are available; <code>null</code> when there are no more results.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/billing.md) · [All operations](https://skmtc.net/aws/apis/billing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/billing/versions/41b2ba3c3d6f/schema)