invoicing/aws.sdk.kotlin.services.invoicing/InvoicingClient/listInvoiceSummaries

listInvoiceSummaries

abstract suspend fun listInvoiceSummaries(input: ListInvoiceSummariesRequest): ListInvoiceSummariesResponse

Retrieves your invoice details programmatically, without line item details.

Samples

// ListInvoiceSummaries with InvoiceId as selector
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("INVOICE_ID")
        value = "1111111111"
    }
}

// ListInvoiceSummaries with AccountId as selector and billing period
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("ACCOUNT_ID")
        value = "111111111111"
    }
    filter = InvoiceSummariesFilter {
        billingPeriod = BillingPeriod {
            month = 1
            year = 2025
        }
    }
}

// ListInvoiceSummaries with AccountId as selector and time interval
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("ACCOUNT_ID")
        value = "111111111111"
    }
    filter = InvoiceSummariesFilter {
        timeInterval = DateInterval {
            startDate = Instant.fromEpochSeconds(1590997407, 0)
            endDate = Instant.fromEpochSeconds(1592639007, 0)
        }
    }
}

// ListInvoiceSummaries filtered by ReceiverRole
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("ACCOUNT_ID")
        value = "111111111111"
    }
    filter = InvoiceSummariesFilter {
        timeInterval = DateInterval {
            startDate = Instant.fromEpochSeconds(1748736000, 0)
            endDate = Instant.fromEpochSeconds(1751328000, 0)
        }
        receiverRole = ReceiverRole.fromValue("SELLER")
    }
}

// ListInvoiceSummaries with AccountId as selector and a billing period and max results
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("ACCOUNT_ID")
        value = "111111111111"
    }
    filter = InvoiceSummariesFilter {
        billingPeriod = BillingPeriod {
            month = 1
            year = 2025
        }
    }
    maxResults = 1
}

// ListInvoiceSummaries with AccountId as selector and a billing period and next token
val resp = invoicingClient.listInvoiceSummaries {
    selector = InvoiceSummariesSelector {
        resourceType = ListInvoiceSummariesResourceType.fromValue("ACCOUNT_ID")
        value = "111111111111"
    }
    filter = InvoiceSummariesFilter {
        billingPeriod = BillingPeriod {
            month = 1
            year = 2025
        }
    }
    nextToken = "abcde12345"
}