v1

latestOpenAPI 3.1.02026-08-045901.5 MB

List Purchase Invoice

get/purchase-invoice

Query parameters

sizeinteger required

Number of records to retrieve

start_frominteger required

Starting index for pagination

from_datestring date

Start date for filtering

to_datestring

End date for filtering

searchstring

Keyword or text to search

order_by'asc' | 'desc'

Sorting order

order_column'purchase_number' | 'seller_name' | 'pur_inv_date' | 'total_amount' | 'bill_number'

Column name to sort by

payment_status'Part Paid' | 'Fully Paid' | 'Unpaid'

Payment status of purchase invoice

statusstring

Used to filter deleted records

Headers

api-tokenstring

Generate token from authentication api

x-api-keystring

This will shared while register

Response

200

statusinteger

Example response

{
  "status": 200,
  "data": {
    "total_count": 1612,
    "data": [
      {
        "id": 3313,
        "purchase_number": "1082832",
        "pur_inv_date": "2025-04-08",
        "due_date": "2025-04-08",
        "tax_id1_type": "2",
        "business_info": {
          "id": 414,
          "pos": "DAMAN AND DIU",
          "city": "MOTI",
          "name": "STOCK HOLDING CORPORATION OF INDIA LIMITED",
          "addr1": "ESTAMPING OFFICE, PWD, DIVISION -1",
          "addr2": "NEAR FATIMA CONVENT SCHOOL",
          "email": "test@gmail.com",
          "state": "DAMAN AND DIU",
          "tax_no": "25AABCS1429B1ZY",
          "country": "INDIA",
          "pincode": "396220"
        },
        "contact_id": 4867,
        "business_branch_id": 414,
        "seller_branch_id": 2,
        "seller_tax_id": "21NQFPS0204E1Z8",
        "seller_name": "NANDKISHORCHANDURKAR",
        "seller_info": {
          "supplier_id": 4867,
          "supplier_city": "Billing City",
          "supplier_name": "NANDKISHORCHANDURKAR",
          "supplier_addr1": "Billing Address Line 2",
          "supplier_addr2": "Billing Address Line 3",
          "supplier_gstin": "21NQFPS0204E1Z8",
          "supplier_state": "TAMIL NADU",
          "business_country": "india",
          "supplier_country": "India",
          "supplier_business_name": "M/S LILI SANGRAM SINGH"
        },
        "billing_details": {
          "bill_city": "MOTI",
          "bill_addr1": "ESTAMPING OFFICE, PWD, DIVISION -1",
          "bill_addr2": "NEAR FATIMA CONVENT SCHOOL",
          "bill_state": "DAMAN AND DIU",
          "bill_company": "Billing Company",
          "bill_country": "INDIA",
          "bill_pincode": "396220"
        },
        "shipping_details": {
          "ship_city": "MOTI",
          "ship_addr1": "ESTAMPING OFFICE, PWD, DIVISION -1",
          "ship_addr2": "NEAR FATIMA CONVENT SCHOOL",
          "ship_state": "DAMAN AND DIU",
          "ship_company": "Shipping Company",
          "ship_country": "INDIA",
          "ship_pincode": "396220"
        },
        "export_details": {
          "export_type": "Not Applicable"
        },
        "items": [
          {
            "pid": 3009,
            "sku": "50465",
            "vid": 1,
            "rate": 953.2857142857143,
            "units": "UNT-UNITS",
            "status": 1,
            "gst_amt": 46.714285714285715,
            "added_by": 1,
            "added_on": "2025-04-21 09:03:06",
            "gst_rate": "5",
            "igst_amt": "47.66",
            "quantity": 1,
            "cess_type": "flat_value",
            "igst_rate": 5,
            "item_code": "1092833",
            "item_name": "test new hello1",
            "item_type": 1,
            "expense_id": 381,
            "updated_by": 1,
            "taxable_amt": "953.29",
            "expense_type": "purchase of traded goods",
            "discount_type": "flat_value",
            "item_total_amt": "1019.95",
            "non_taxable_amt": 19,
            "converted_amount": 1000
          }
        ],
        "pur_inv_others": "null",
        "currency": "INR",
        "taxable_amount": "953.29",
        "non_taxable_amount": "19",
        "gst_amount": "47.66",
        "adjust_amount": "0",
        "addvalue_amount": "0",
        "cess_amount": "0",
        "total_amount": "1019.95",
        "payable_amount": "953.28571428571",
        "reverse_charge": 1,
        "basic_custom_duty": "0",
        "counter_duty": "0",
        "counter_duty_add": "0",
        "gst_tax_credit": "0",
        "added_on": "2025-04-21 14:33:06",
        "added_by": 1307959575,
        "tax_status": 1,
        "invoice_status": 1,
        "status": 1,
        "data_source": 1,
        "ip_address": "172.31.1.164",
        "req_by": "[[]]",
        "apr_by": "[[]]",
        "rec_by": "[[]]",
        "auto_mode": 1,
        "type": 1,
        "purchase_order_id": 1133,
        "currency_info": "{\"to\": \"INR\", \"from\": \"INR\", \"currency_rate\": 1, \"converted_amount\": 1000, \"currency_default_rate\": 1}",
        "bill_number": "2025-143",
        "tds": "[]",
        "payment_status": "Unpaid"
      }
    ]
  }
}