List customer debit notes

GET

/invoices

Get a list of customer debit notes with helpful pagination, filtering, search, and sorting features. Perfect for viewing your debit note data in organized ways, whether you need to find specific debit notes or browse through your records.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/invoices?item_name=Desktop Units&item_id=982000000030049&item_description=&customer_name=Bowman %26 Co&email=&total=40.6&balance=40.6&custom_field=&date=2013-11-17&due_date=2013-12-03&created_date=2013-11-17&last_modified_time=2013-11-18T02:02:51-0800&status=draft&customer_id=982000000567001&filter_by=Type.DebitNote&search_text=&sort_column=created_time&page=1&per_page=200'

Response Example

{
    "code": 0,
    "message": "success",
    "debit_notes": [
        {
            "invoice_id": "982000000567114",
            "invoice_number": "DN-00001",
            "date": "2013-11-17",
            "status": "draft",
            "customer_id": "982000000567001",
            "customer_name": "Bowman & Co",
            "total": 40.6,
            "balance": 40.6,
            "created_time": "2013-11-17T17:09:00+0530",
            "last_modified_time": "2013-11-17T17:09:00+0530",
            "line_items": [
                {
                    "line_item_id": "982000000567115",
                    "item_id": "982000000030049",
                    "item_name": "Desktop Units",
                    "description": "Desktop Units",
                    "rate": 20,
                    "quantity": 2,
                    "unit": "Nos",
                    "item_total": 40
                }
            ],
            "reference_invoice": {
                "reference_invoice_number": "INV-000887",
                "reference_invoice_status": "draft",
                "reference_invoice_amount": 3.52,
                "reference_invoice_id": "982000000567005"
            }
        }
    ],
    "page_context": {
        "page": 1,
        "per_page": 200,
        "has_more_page": false
    }
}

Modified at 2025-10-12 16:28:37

Create a customer debit note

Update a customer debit note