List invoices

GET https://api.ecurring.com/invoices

This endpoint allows you to retrieve all of the invoices in your account.

Parameters

page[number]
integer
Optional - The number of the page (default is 1)
page[size]
integer
Optional - The number of objects to return (default is 10)
include
string
Optional - A comma seperated list of relationships to include in the response. Possible values: subscriptions

Response

meta
object
An object containing some meta information about the response.
total
integer
The total number of objects in the response
links
object
Links to help navigate through the lists of objects, based on the given page number and page size.
self string The current page
first string Optional - The first page of the set
last string Optional - The last page of the set
prev string Optional - The previous page in the set
next string Optional - The next page in the set
data
object
A list of invoice objects as described in Get invoice

Example

Response

{
    "meta": {
        "total": 3
    },
    "links": {
        "self": "https://api.ecurring.com/invoices?page[number]=1&page[size]=10",
        "first": "https://api.ecurring.com/invoices?page[number]=1&page[size]=10",
        "last": "https://api.ecurring.com/invoices?page[number]=1&page[size]=10",
        "prev": null,
        "next": null
    },
    "data": [
        {
            "type": "invoice",
            "id": "707805321",
            "links": {
                "self": "https://api.ecurring.com/invoices/707805321"
            },
            "attributes": {
                "status": "open",
                "reference": "DN'S BDRJF-1",
                "amount_excl": "0.83",
                "amount_incl": "1.00",
                "tax_amount": "0.17",
                "invoice_date": "2019-07-10T00:00:00+02:00",
                "transaction_date": "2019-10-10T00:00:00+02:00",
                "created_at": "2019-07-10T10:15:07+02:00",
                "updated_at": "2019-10-02T15:39:53+02:00"
            },
            "relationships": {
                "subscription": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/707805321/subscription"
                    },
                    "data": {
                        "type": "subscription",
                        "id": "1180394926"
                    }
                },
                "customer": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/707805321/customer"
                    },
                    "data": {
                        "type": "customer",
                        "id": "1116541653"
                    }
                },
                "invoice-lines": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/707805321/lines"
                    },
                    "data": [
                        {
                            "type": "invoice-line",
                            "id": "902823330"
                        }
                    ]
                },
                "transaction": {
                    "data": {
                        "type": "transaction",
                        "id": "b41c3re1-1331-476e-aed1-344ca19d229d"
                    }
                }
            }
        },
        {
            "type": "invoice",
            "id": "1325564912",
            "links": {
                "self": "https://api.ecurring.com/invoices/1325564912"
            },
            "attributes": {
                "status": "draft",
                "reference": "DRAFT",
                "amount_excl": "0.00",
                "amount_incl": "0.00",
                "tax_amount": "0.00",
                "invoice_date": "2019-10-10T00:00:00+02:00",
                "transaction_date": "2019-10-10T00:00:00+02:00",
                "created_at": "2019-10-03T11:26:49+02:00",
                "updated_at": "2019-10-03T11:26:49+02:00"
            },
            "relationships": {
                "subscription": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/1325564912/subscription"
                    },
                    "data": {
                        "type": "subscription",
                        "id": "739578262"
                    }
                },
                "customer": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/1325564912/customer"
                    },
                    "data": {
                        "type": "customer",
                        "id": "149526343"
                    }
                },
                "invoice-lines": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/1325564912/lines"
                    },
                    "data": []
                },
                "transaction": {
                    "data": null
                }
            }
        },
        {
            "type": "invoice",
            "id": "637377985",
            "links": {
                "self": "https://api.ecurring.com/invoices/637377985"
            },
            "attributes": {
                "status": "draft",
                "reference": "DRAFT",
                "amount_excl": "0.00",
                "amount_incl": "0.00",
                "tax_amount": "0.00",
                "invoice_date": "2019-10-10T00:00:00+02:00",
                "transaction_date": "2019-10-10T00:00:00+02:00",
                "created_at": "2019-10-03T11:33:17+02:00",
                "updated_at": "2019-10-04T09:57:41+02:00"
            },
            "relationships": {
                "subscription": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/637377985/subscription"
                    },
                    "data": {
                        "type": "subscription",
                        "id": "739578262"
                    }
                },
                "customer": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/637377985/customer"
                    },
                    "data": {
                        "type": "customer",
                        "id": "149526343"
                    }
                },
                "invoice-lines": {
                    "links": {
                        "related": "https://api.ecurring.com/invoices/637377985/lines"
                    },
                    "data": []
                },
                "transaction": {
                    "data": null
                }
            }
        }
    ]
}