Returns a list of invoices. The transactions are returned in sorted order, with the most recent transactions appearing first. Parameters can be used to create a date range to only list invoices that were created within the range.
Parameters
StartDate
optional
StartDate
optionalDate and time in ISO 8416 format that filters the list to only show invoices that were created on or after the specified date.
EndDate
optional
EndDate
optionalDate and time in ISO 8416 format that filters the list to only show invoices that were created on or before the specified date.
Returns
Returns an array of invoice objects up to a limit dictated by @pagesize
. Each entry in the array is a separate invoice. If no invoices meet the criteria, the resulting array will be empty. This request should never return an error.
Example request
curl 'https://api.impact.com/Advertisers/<AccountSID>/Invoices' \
-G \
-u '<AccountSID>:<AuthToken>' \
-H 'Accept: application/json' \
-d 'StartDate=2021-01-01T00:00:00Z' \
-d 'EndDate=2021-01-31T00:00:00Z'
Example response
{
"@page": "1",
...,
"Invoices": [
{
"Id": "1299679-33",
"CreatedDate": "2018-11-02T11:43:30-04:00",
"MediaId": "1299679",
"MediaName": "RoadRunner",
"Currency": "USD",
"TotalAmount": "65.00",
"TotalVatAmount": "0.00",
"LineItems": [
{
"CampaignId": "1000",
"CampaignName": "Acme Online",
"Description": "MEDIA_PAYOUT",
"EventMonthYear": "92018",
"Actions": "13",
"NetItemAmount": "65.00",
"VatItemAmount": "0.00",
"TotalItemAmount": "65.00",
"Status": "PAID",
"DueDate": "2018-10-16T00:00:00-04:00",
"PaidDate": "2018-10-16T00:35:47-04:00"
}
],
"PDF": "/Advertisers/<AccountSID>/Invoices/1299679-3/Download",
"Uri": "/Advertisers/<AccountSID>/Invoices/1299679-3"
},
...,
],
}