ListInvoiceSummaries
Retrieves your invoice details programmatically, without line item details.
Request Syntax
{
"Filter": {
"BillingPeriod": {
"Month": number,
"Year": number
},
"InvoicingEntity": "string",
"TimeInterval": {
"EndDate": number,
"StartDate": number
}
},
"MaxResults": number,
"NextToken": "string",
"Selector": {
"ResourceType": "string",
"Value": "string"
}
}Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- Filter
-
Filters you can use to customize your invoice summary.
Type: InvoiceSummariesFilter object
Required: No
- MaxResults
-
The maximum number of invoice summaries a paginated response can contain.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 100.
Required: No
- NextToken
-
The token to retrieve the next set of results. Amazon provides the token when the response from a previous call has more results than the maximum page size.
Type: String
Length Constraints: Minimum length of 1.
Pattern:
[\S\s]*Required: No
- Selector
-
The option to retrieve details for a specific invoice by providing its unique ID. Alternatively, access information for all invoices linked to the account by providing an account ID.
Type: InvoiceSummariesSelector object
Required: Yes
Response Syntax
{
"InvoiceSummaries": [
{
"AccountId": "string",
"BaseCurrencyAmount": {
"AmountBreakdown": {
"Discounts": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"Fees": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"SubTotalAmount": "string",
"Taxes": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
}
},
"CurrencyCode": "string",
"CurrencyExchangeDetails": {
"Rate": "string",
"SourceCurrencyCode": "string",
"TargetCurrencyCode": "string"
},
"TotalAmount": "string",
"TotalAmountBeforeTax": "string"
},
"BillingPeriod": {
"Month": number,
"Year": number
},
"DueDate": number,
"Entity": {
"InvoicingEntity": "string"
},
"InvoiceId": "string",
"InvoiceType": "string",
"IssuedDate": number,
"OriginalInvoiceId": "string",
"PaymentCurrencyAmount": {
"AmountBreakdown": {
"Discounts": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"Fees": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"SubTotalAmount": "string",
"Taxes": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
}
},
"CurrencyCode": "string",
"CurrencyExchangeDetails": {
"Rate": "string",
"SourceCurrencyCode": "string",
"TargetCurrencyCode": "string"
},
"TotalAmount": "string",
"TotalAmountBeforeTax": "string"
},
"PurchaseOrderNumber": "string",
"TaxCurrencyAmount": {
"AmountBreakdown": {
"Discounts": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"Fees": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
},
"SubTotalAmount": "string",
"Taxes": {
"Breakdown": [
{
"Amount": "string",
"Description": "string",
"Rate": "string"
}
],
"TotalAmount": "string"
}
},
"CurrencyCode": "string",
"CurrencyExchangeDetails": {
"Rate": "string",
"SourceCurrencyCode": "string",
"TargetCurrencyCode": "string"
},
"TotalAmount": "string",
"TotalAmountBeforeTax": "string"
}
}
],
"NextToken": "string"
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- InvoiceSummaries
-
List of key (summary level) invoice details without line item details.
Type: Array of InvoiceSummary objects
- NextToken
-
The token to retrieve the next set of results. Amazon provides the token when the response from a previous call has more results than the maximum page size.
Type: String
Length Constraints: Minimum length of 1.
Pattern:
[\S\s]*
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You don't have sufficient access to perform this action.
- resourceName
-
You don't have sufficient access to perform this action.
HTTP Status Code: 400
- InternalServerException
-
The processing request failed because of an unknown error, exception, or failure.
- retryAfterSeconds
-
The processing request failed because of an unknown error, exception, or failure.
HTTP Status Code: 500
- ResourceNotFoundException
-
The resource could not be found.
- resourceName
-
The resource could not be found.
HTTP Status Code: 400
- ThrottlingException
-
The request was denied due to request throttling.
HTTP Status Code: 400
- ValidationException
-
The input fails to satisfy the constraints specified by an Amazon Web Services service.
- fieldList
-
The input fails to satisfy the constraints specified by an Amazon Web Services service.
- reason
-
You don't have sufficient access to perform this action.
- resourceName
-
You don't have sufficient access to perform this action.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: