Retrieve your invoice information.
Retrieve Invoice Numbers
Return an array of invoice numbers to your account.
URI Parameter |
Required |
Requirements |
Description |
start_date |
No |
Must be in YYYY-mm-dd format. This is the start date to begin your invoice search from. |
|
end_date |
No |
Must be in YYYY-mm-dd format and also include a start_date in the API call. This is the end date you wish to end your invoice search from. |
|
status |
No |
Must be either paid, unpaid, refunded, deferred, canceled. This is used to specify what kind of invoice you would like returned. |
|
|
|
Data |
|
Response Status |
|
Response Body |
|
Call
POST |
https://api.sendgrid.com/api/billing.list.json
|
POST Data |
api_user=your_sendgrid_username&api_key=your_sendgrid_password&status=pai
|
Response
1
2
3
4
5
6
7
8
| [
{
"number": "2010010001"
},
{
"number": "2010010002"
}
]
|
Call
POST |
https://api.sendgrid.com/api/billing.list.xml
|
POST Data |
api_user=your_sendgrid_username&api_key=your_sendgrid_password&status=pai
|
Response
1
2
3
4
5
6
7
8
| <invoices>
<invoice>
<number>2010010001</number>
</invoice>
<invoice>
<number>2010010002</number>
</invoice>
</invoices>
|
Retrieve Invoices
Return an array of invoices.
URI Parameter |
Required |
Requirements |
Description |
start_date |
No |
Must be in YYYY-mm-dd format. This is the start date to begin your invoice search from. |
|
end_date |
No |
Must be in YYYY-mm-dd format and also include a start_date in the API call. This is the end date you wish to end your invoice search from. |
|
status |
No |
Must be either paid, unpaid, refunded, deferred, canceled. This is used to specify what kind of invoice you would like returned. |
|
|
|
Data |
|
Response Status |
|
Response Body |
|
Call
POST |
https://api.sendgrid.com/api/billing.get.json
|
POST Data |
api_user=your_sendgrid_username&api_key=your_sendgrid_password&status=pai
|
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| {
"number": "2010010001",
"package": "Basic Package",
"credits": 10000000,
"date_invoiced": "2010-01-01 00:00:00",
"status": "Paid",
"amount": 100,
"additional_charges": 0,
"overage": 10,
"type": "Recurring Bill",
"prorated": 0,
"start_date": "2009-12-01",
"end_date": "2009-12-31",
"final_amount": 110
}
|
Call
POST |
https://api.sendgrid.com/api/billing.get.xml
|
POST Data |
api_user=your_sendgrid_username&api_key=your_sendgrid_password&status=pai
|
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| <invoices>
<invoice>
<number>2010010001</number>
<package>Basic Package</package>
<credits>10000000</credits>
<date_invoiced>2010-01-01 00:00:00</date_invoiced>
<status>Paid</status>
<amount>100</amount>
<additional_charges>0</additional_charges>
<overage>10</overage>
<type>Recurring Bill</type>
<prorated>0</prorated>
<start_date>2009-12-01</start_date>
<end_date>2009-12-31</end_date>
<final_amount>110</final_amount>
</invoice>
</invoices>
|