API documentation

Invoice

Download, view or list the details of your invoices.

Available methods

Details
Download
List

Details

GET

https://api.cdn77.com/v2.0/invoice/details

View the details of your invoices.

Response object: invoice

Parameters

Parameter	Example	Description
login string*	info@domain.com	Your login (email) to CDN77 control panel
passwd string*	8vL4BpXbRqgPTKA0h	Your API password.
id int*		Invoice Id. Retrieve list of invoices including their ids with the list method.

* Parameter required.

Return Values

Return Value	Description
id	> Invoice Id. Retrieve list of invoices including their ids with the list method.
invoice_date	> Invoice Date (yyyy-mm-dd)
number	> Invoice number. e.g. "CDN77-00xxxxxx".
description	> Invoice Description.
amount	> Amount.
currency	> Currency is in a three letter format. e.g. "EUR".

Examples

                                
                                                                            # GET request
                                        curl "https://api.cdn77.com/v2.0/invoice/details?id=xxx&login=name@domain.com&passwd=your_api_password"

# response
{"status": "ok", "description": "Request was successful.", "invoice": {"id": xxx, "invoice_date": "2014-03-13", "number": "CDN77-xxxxxx", "description": "CDN77.com - xxx", "amount": "0.86", "currency": "EUR"}}

Download

GET

https://api.cdn77.com/v2.0/invoice/download

If successful a PDF file will return (with application/pdf content type header). If not, a standard response with status and description objects will be returned.

Parameters

Parameter	Example	Description
login string*	info@domain.com	Your login (email) to CDN77 control panel
passwd string*	8vL4BpXbRqgPTKA0h	Your API password.
id int*		Invoice Id. Retrieve list of invoices including their ids with the list method.

* Parameter required.

Return Values

Return Value	Description
pdf_file	> PDF file.

Examples

                                
                                                                            # GET request
                                        curl "https://api.cdn77.com/v2.0/invoice/download?id=xxx&login=name@domain.com&passwd=your_api_passwd"

# response content type: application/pdf
pdf file

List

GET

https://api.cdn77.com/v2.0/invoice/list

List your past invoices.

Response object: invoices / array of objects described below.

Parameters

Parameter	Example	Description
login string*	info@domain.com	Your login (email) to CDN77 control panel
passwd string*	8vL4BpXbRqgPTKA0h	Your API password.

* Parameter required.

Return Values

Return Value	Description
id	> Invoice Id. Retrieve list of invoices including their ids with the list method.
invoice_date	> Invoice Date (yyyy-mm-dd)
number	> Invoice number. e.g. "CDN77-00xxxxxx".
description	> Invoice Description.
amount	> Amount.
currency	> Currency is in a three letter format. e.g. "EUR".

Examples

                                
                                                                            # GET request
                                        curl "https://api.cdn77.com/v2.0/invoice/list?login=name@domain.com&passwd=your_api_password"

# response
{"status": "ok", "description": "Request was successful.", "invoices": [{"id": xxx, "invoice_date": "2014-03-13", "number": "CDN77-xxxxxx", "description": "CDN77.com - xxx", "amount": "0.86", "currency": "EUR"}, {"id": xxx, "invoice_date": "2014-03-13", "number": "CDN77-xxxxxx", "description": "CDN77.com - xxx ", "amount": "0.86", "currency": "EUR"}]}