/ Developer API

Ledger365 Developer API

Use the Ledger365 Developer API to connect your website, online store, CRM or internal tools to your books: create customers and invoices, record payments and read your data.

Base URL

URL
https://api.ledger365.com/api/v1

Current Version

The API is at v1. All endpoints are prefixed with /api/v1/. Requests and responses use JSON, dates use yyyy-MM-dd, and timestamps are UTC.

Available Resources

ResourceEndpointsStatus
CustomersList, Get, Create, UpdateLive
ProductsList, Get, Create, UpdateLive
Tax GroupsListLive
InvoicesList, Get, Create, UpdateLive
PaymentsList, RecordLive
Payment ModesListLive
EstimatesList, GetLive

Authentication

The API uses bearer tokens. The company Owner or an Admin creates them in Ledger365 under Settings > Developer API: create an API client for your integration, then a token with the permissions it needs.

Using Your Token

Send the token in the Authorization header of every request:

HTTP Header
Authorization: Bearer l365_your_token_here

Example Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/customers" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Token Security

Important: a token is shown only once, when it is created. Store it securely and never put it in a web page or mobile app. If it is lost or exposed, revoke it in Ledger365 and create a new one.

Each token belongs to one company and can only read and change that company’s data. A client can also be limited to a list of IP addresses.

Scopes

Each token has permission scopes that control what it can do. A request without the required scope is refused with 403.

ScopeDescription
customers.readList and view customers
customers.writeCreate and update customers
products.readList and view products, services and tax groups
products.writeCreate and update products
invoices.readList and view invoices with lines and taxes
invoices.writeCreate draft invoices and update invoice details
payments.readList payments and payment modes
payments.writeRecord payments against invoices
estimates.readList and view estimates

Errors

The API uses standard HTTP status codes and returns errors in a consistent JSON format.

Error Response Format

JSON
{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The provided token is not valid."
  }
}

HTTP Status Codes

CodeMeaning
200Success
201Created — the resource was created
400Bad request — invalid or missing fields
401Unauthorized — missing, invalid, expired or revoked token
403Forbidden — the token lacks the required scope, or the IP address is not allowed
404Not found — the resource does not exist in your company
429Too many requests — rate limit exceeded
500Server error — try again later

Error Codes

CodeDescription
MISSING_TOKENNo Authorization header with a Bearer token was sent
INVALID_TOKENThe token format is wrong or the token was not found
TOKEN_EXPIREDThe token has passed its expiry date
TOKEN_REVOKEDThe token has been revoked
CLIENT_INACTIVEThe API client of the token is inactive or deleted
IP_NOT_ALLOWEDThe request came from an IP address the client does not allow
INSUFFICIENT_SCOPEThe token does not have the scope this endpoint requires
RATE_LIMITEDToo many requests in the last minute
NOT_FOUNDThe requested resource was not found
VALIDATION_ERROROne or more fields are missing or invalid
DUPLICATEA record with the same name or code already exists
NO_TEMPLATEThe company has no active invoice template
INVALID_STATUSThe requested status change is not allowed
INVOICE_VOIDThe invoice is void and cannot be changed
OVERPAYMENTThe payment is larger than the balance due
INTERNAL_ERRORAn unexpected error occurred

Pagination

List endpoints return results a page at a time. Use the page and pageSize query parameters to move through them.

Parameters

ParameterTypeDefaultDescription
pageinteger1Page number (default 1).
pageSizeinteger25Items per page (default 25, max 100).

Response Format

JSON
{
  "data": [
    "..."
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 42,
    "totalPages": 2
  }
}

Rate Limits

Each token can make up to 60 requests per minute. Every response includes an X-RateLimit-Limit header. When the limit is exceeded the API returns 429 with a Retry-After header giving the number of seconds to wait.

JSON
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit of 60 requests per minute exceeded. Retry in 42 seconds."
  }
}

List Customers

Returns a paginated list of your customers, sorted by name.

GET/api/v1/customers customers.read

Query Parameters

ParameterTypeRequiredDescription
searchstringOptionalFilter by name, display name, email or code (partial match).
pageintegerOptionalPage number (default 1).
pageSizeintegerOptionalItems per page (default 25, max 100).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/customers?search=acme&page=1&pageSize=25" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
      "name": "Acme Traders",
      "displayName": "Acme",
      "code": "ACME",
      "email": "accounts@acme.example",
      "phone": "+91 98300 00000",
      "mobile": null,
      "website": null,
      "taxNumber": "19ABCDE1234F1Z5",
      "currencyCode": "INR",
      "paymentTermDays": 15,
      "creditLimit": null,
      "notes": null,
      "isActive": true,
      "billingAddress": {
        "line1": "12 Park Street",
        "line2": null,
        "city": "Kolkata",
        "state": "West Bengal",
        "stateCode": "19",
        "postalCode": "700016",
        "countryCode": "IN"
      },
      "createdOn": "2026-11-21T09:30:04Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

Get Customer

Returns one customer by id.

GET/api/v1/customers/{id} customers.read

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe customer id (a GUID returned by the API).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/customers/86f0d2c8-6190-4c84-8877-73c48b46fe1c" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": {
    "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
    "name": "Acme Traders",
    "displayName": "Acme",
    "code": "ACME",
    "email": "accounts@acme.example",
    "phone": "+91 98300 00000",
    "mobile": null,
    "website": null,
    "taxNumber": "19ABCDE1234F1Z5",
    "currencyCode": "INR",
    "paymentTermDays": 15,
    "creditLimit": null,
    "notes": null,
    "isActive": true,
    "billingAddress": {
      "line1": "12 Park Street",
      "line2": null,
      "city": "Kolkata",
      "state": "West Bengal",
      "stateCode": "19",
      "postalCode": "700016",
      "countryCode": "IN"
    },
    "createdOn": "2026-11-21T09:30:04Z"
  }
}

Create Customer

Creates a customer. Only name is required.

POST/api/v1/customers customers.write

Request Body

ParameterTypeRequiredDescription
namestringRequired to createCustomer name, unique in your company (max 200). Required when creating.
displayNamestringOptionalName shown on documents, if different.
codestringOptionalYour own customer code, unique in your company.
emailstringOptionalEmail address; invoices and reminders are sent here.
phonestringOptionalPhone number.
mobilestringOptionalMobile number.
websitestringOptionalWebsite address.
taxNumberstringOptionalTax registration number, e.g. GSTIN in India.
currencyCodestringOptionalISO currency code. Defaults to your company currency.
paymentTermDaysintegerOptionalDays until payment is due (0-365). Used for new invoices.
creditLimitnumberOptionalCredit limit.
notesstringOptionalInternal notes.
isActivebooleanOptionalUpdate only: set false to deactivate the customer.
billingAddressobjectOptionalline1, line2, city, state, stateCode, postalCode, countryCode. In India, stateCode is the GST state code used for place of supply.

Sample Request

cURL
curl -X POST "https://api.ledger365.com/api/v1/customers" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "name": "Acme Traders",
         "email": "accounts@acme.example",
         "taxNumber": "19ABCDE1234F1Z5",
         "paymentTermDays": 15,
         "billingAddress": {
           "line1": "12 Park Street",
           "city": "Kolkata",
           "stateCode": "19",
           "postalCode": "700016",
           "countryCode": "IN"
         }
       }'

Response 201 Created

JSON
{
  "data": {
    "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
    "name": "Acme Traders",
    "displayName": "Acme",
    "code": "ACME",
    "email": "accounts@acme.example",
    "phone": "+91 98300 00000",
    "mobile": null,
    "website": null,
    "taxNumber": "19ABCDE1234F1Z5",
    "currencyCode": "INR",
    "paymentTermDays": 15,
    "creditLimit": null,
    "notes": null,
    "isActive": true,
    "billingAddress": {
      "line1": "12 Park Street",
      "line2": null,
      "city": "Kolkata",
      "state": "West Bengal",
      "stateCode": "19",
      "postalCode": "700016",
      "countryCode": "IN"
    },
    "createdOn": "2026-11-21T09:30:04Z"
  }
}

Update Customer

Updates a customer. Only the fields you send are changed.

PUT/api/v1/customers/{id} customers.write

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe customer id (a GUID returned by the API).

Request Body

ParameterTypeRequiredDescription
namestringRequired to createCustomer name, unique in your company (max 200). Required when creating.
displayNamestringOptionalName shown on documents, if different.
codestringOptionalYour own customer code, unique in your company.
emailstringOptionalEmail address; invoices and reminders are sent here.
phonestringOptionalPhone number.
mobilestringOptionalMobile number.
websitestringOptionalWebsite address.
taxNumberstringOptionalTax registration number, e.g. GSTIN in India.
currencyCodestringOptionalISO currency code. Defaults to your company currency.
paymentTermDaysintegerOptionalDays until payment is due (0-365). Used for new invoices.
creditLimitnumberOptionalCredit limit.
notesstringOptionalInternal notes.
isActivebooleanOptionalUpdate only: set false to deactivate the customer.
billingAddressobjectOptionalline1, line2, city, state, stateCode, postalCode, countryCode. In India, stateCode is the GST state code used for place of supply.

Sample Request

cURL
curl -X PUT "https://api.ledger365.com/api/v1/customers/86f0d2c8-6190-4c84-8877-73c48b46fe1c" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "phone": "+91 98300 00000",
         "paymentTermDays": 30
       }'

Response 200 OK

JSON
{
  "data": {
    "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
    "name": "Acme Traders",
    "displayName": "Acme",
    "code": "ACME",
    "email": "accounts@acme.example",
    "phone": "+91 98300 00000",
    "mobile": null,
    "website": null,
    "taxNumber": "19ABCDE1234F1Z5",
    "currencyCode": "INR",
    "paymentTermDays": 15,
    "creditLimit": null,
    "notes": null,
    "isActive": true,
    "billingAddress": {
      "line1": "12 Park Street",
      "line2": null,
      "city": "Kolkata",
      "state": "West Bengal",
      "stateCode": "19",
      "postalCode": "700016",
      "countryCode": "IN"
    },
    "createdOn": "2026-11-21T09:30:04Z"
  }
}

List Products

Returns a paginated list of products and services, sorted by name.

GET/api/v1/products products.read

Query Parameters

ParameterTypeRequiredDescription
searchstringOptionalFilter by name, SKU or HSN/SAC code (partial match).
typestringOptionalGoods or Service.
activebooleanOptionaltrue for active products only, false for inactive only.
pageintegerOptionalPage number (default 1).
pageSizeintegerOptionalItems per page (default 25, max 100).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/products?type=Service&active=true" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
      "name": "Consulting (hourly)",
      "sku": "CONS-HR",
      "type": "Service",
      "description": "Senior consultant, per hour",
      "unitPrice": 1200,
      "currencyCode": "INR",
      "unit": "HRS",
      "hsnCode": "998314",
      "taxGroup": {
        "id": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda",
        "name": "GST 18%"
      },
      "isTaxInclusive": false,
      "isActive": true,
      "createdOn": "2026-11-21T09:31:10Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

Get Product

Returns one product by id.

GET/api/v1/products/{id} products.read

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe product id (a GUID returned by the API).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/products/f9c5679d-b54d-4af7-a8f3-10f0745514f9" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": {
    "id": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
    "name": "Consulting (hourly)",
    "sku": "CONS-HR",
    "type": "Service",
    "description": "Senior consultant, per hour",
    "unitPrice": 1200,
    "currencyCode": "INR",
    "unit": "HRS",
    "hsnCode": "998314",
    "taxGroup": {
      "id": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda",
      "name": "GST 18%"
    },
    "isTaxInclusive": false,
    "isActive": true,
    "createdOn": "2026-11-21T09:31:10Z"
  }
}

Create Product

Creates a product or service.

POST/api/v1/products products.write

Request Body

ParameterTypeRequiredDescription
namestringRequired to createProduct or service name (max 200). Required when creating.
unitPricenumberRequired to createPrice per unit, before tax. Required when creating.
typestringOptionalGoods (default) or Service.
skustringOptionalStock keeping unit / item code.
descriptionstringOptionalShort description shown on invoice lines.
unitstringOptionalUnit of measure code, e.g. PCS, HRS, KG (default PCS).
hsnCodestringOptionalHSN code (goods) or SAC code (services).
currencyCodestringOptionalISO currency code. Defaults to your company currency.
taxGroupIdstringOptionalDefault tax group id (see List Tax Groups). Send an empty string to remove it.
isActivebooleanOptionalSet false to hide the product from new invoices.

Sample Request

cURL
curl -X POST "https://api.ledger365.com/api/v1/products" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "name": "Consulting (hourly)",
         "type": "Service",
         "unitPrice": 1200,
         "unit": "HRS",
         "hsnCode": "998314",
         "taxGroupId": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda"
       }'

Response 201 Created

JSON
{
  "data": {
    "id": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
    "name": "Consulting (hourly)",
    "sku": "CONS-HR",
    "type": "Service",
    "description": "Senior consultant, per hour",
    "unitPrice": 1200,
    "currencyCode": "INR",
    "unit": "HRS",
    "hsnCode": "998314",
    "taxGroup": {
      "id": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda",
      "name": "GST 18%"
    },
    "isTaxInclusive": false,
    "isActive": true,
    "createdOn": "2026-11-21T09:31:10Z"
  }
}

Update Product

Updates a product. Only the fields you send are changed.

PUT/api/v1/products/{id} products.write

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe product id (a GUID returned by the API).

Request Body

ParameterTypeRequiredDescription
namestringRequired to createProduct or service name (max 200). Required when creating.
unitPricenumberRequired to createPrice per unit, before tax. Required when creating.
typestringOptionalGoods (default) or Service.
skustringOptionalStock keeping unit / item code.
descriptionstringOptionalShort description shown on invoice lines.
unitstringOptionalUnit of measure code, e.g. PCS, HRS, KG (default PCS).
hsnCodestringOptionalHSN code (goods) or SAC code (services).
currencyCodestringOptionalISO currency code. Defaults to your company currency.
taxGroupIdstringOptionalDefault tax group id (see List Tax Groups). Send an empty string to remove it.
isActivebooleanOptionalSet false to hide the product from new invoices.

Sample Request

cURL
curl -X PUT "https://api.ledger365.com/api/v1/products/f9c5679d-b54d-4af7-a8f3-10f0745514f9" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "unitPrice": 1500
       }'

Response 200 OK

JSON
{
  "data": {
    "id": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
    "name": "Consulting (hourly)",
    "sku": "CONS-HR",
    "type": "Service",
    "description": "Senior consultant, per hour",
    "unitPrice": 1200,
    "currencyCode": "INR",
    "unit": "HRS",
    "hsnCode": "998314",
    "taxGroup": {
      "id": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda",
      "name": "GST 18%"
    },
    "isTaxInclusive": false,
    "isActive": true,
    "createdOn": "2026-11-21T09:31:10Z"
  }
}

List Tax Groups

Returns your active tax groups and their rates. Use these ids for products and invoice lines.

GET/api/v1/tax-groups products.read

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/tax-groups" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "555a3ba5-b9f7-4cc0-ad7e-e8228e86dfda",
      "name": "GST 18%",
      "code": "GST18",
      "totalRate": 18,
      "rates": [
        {
          "name": "CGST",
          "rate": 9
        },
        {
          "name": "SGST",
          "rate": 9
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

List Invoices

Returns a paginated list of invoices, newest first.

GET/api/v1/invoices invoices.read

Query Parameters

ParameterTypeRequiredDescription
statusstringOptionalDraft, Sent, Partial, Paid, Overdue or Void.
customerIdstringOptionalOnly invoices for this customer.
dateFromdateOptionalInvoice date on or after (yyyy-MM-dd).
dateTodateOptionalInvoice date on or before (yyyy-MM-dd).
searchstringOptionalFilter by invoice number, reference or customer name.
pageintegerOptionalPage number (default 1).
pageSizeintegerOptionalItems per page (default 25, max 100).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/invoices?status=Sent&dateFrom=2026-11-01&dateTo=2026-11-30" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
      "number": "INV-0105",
      "referenceNumber": "PO-77",
      "invoiceDate": "2026-11-20",
      "dueDate": "2026-12-05",
      "status": "Partial",
      "customer": {
        "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
        "name": "Acme Traders"
      },
      "currencyCode": "INR",
      "subTotal": 2100,
      "taxTotal": 360,
      "total": 2460,
      "amountPaid": 500,
      "balanceDue": 1960,
      "createdOn": "2026-11-21T09:35:05Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

Get Invoice

Returns one invoice with its lines, taxes, amount paid and balance due. Companies in India also get the GST details recorded on the invoice.

GET/api/v1/invoices/{id} invoices.read

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe invoice id (a GUID returned by the API).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/invoices/b50e60ed-2e5a-4fc7-8685-f08c3535d144" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": {
    "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
    "number": "INV-0105",
    "referenceNumber": "PO-77",
    "invoiceDate": "2026-11-20",
    "dueDate": "2026-12-05",
    "status": "Partial",
    "customer": {
      "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
      "name": "Acme Traders"
    },
    "currencyCode": "INR",
    "subTotal": 2100,
    "taxTotal": 360,
    "total": 2460,
    "amountPaid": 500,
    "balanceDue": 1960,
    "createdOn": "2026-11-21T09:35:05Z",
    "customerEmail": "accounts@acme.example",
    "notes": null,
    "termsAndConditions": null,
    "lines": [
      {
        "productId": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
        "name": "Consulting (hourly)",
        "description": "Senior consultant, per hour",
        "hsnCode": "998314",
        "unit": "HRS",
        "quantity": 2,
        "unitPrice": 1200,
        "discountAmount": 400,
        "taxableAmount": 2000,
        "taxAmount": 360,
        "total": 2360,
        "taxes": [
          {
            "name": "CGST",
            "rate": 9,
            "amount": 180
          },
          {
            "name": "SGST",
            "rate": 9,
            "amount": 180
          }
        ]
      },
      {
        "productId": null,
        "name": "Courier charges",
        "description": null,
        "hsnCode": null,
        "unit": null,
        "quantity": 1,
        "unitPrice": 100,
        "discountAmount": null,
        "taxableAmount": 100,
        "taxAmount": 0,
        "total": 100,
        "taxes": []
      }
    ],
    "invoiceTaxes": [],
    "gst": {
      "supplierGstin": "19AAACD1234F1Z5",
      "customerGstin": "19ABCDE1234F1Z5",
      "placeOfSupply": "19-West Bengal",
      "isInterState": false,
      "isReverseCharge": false
    }
  }
}

Create Invoice

Creates a Draft invoice. The invoice number comes from the invoice template, and taxes are calculated from each line’s tax group, the same way as in the app.

POST/api/v1/invoices invoices.write

Request Body

ParameterTypeRequiredDescription
customerIdstringRequiredCustomer id.
linesarrayRequiredOne or more lines (max 200). Each line: productId, name, description, hsnCode, unit, quantity (default 1), unitPrice, discountAmount, taxGroupId. With a productId, missing values come from the product; without one, name and unitPrice are required. Taxes are calculated on quantity × unitPrice − discountAmount; send taxGroupId as an empty string for no tax.
invoiceDatedateOptionalInvoice date (yyyy-MM-dd). Defaults to today in your company’s time zone.
dueDatedateOptionalDue date. Defaults to the invoice date plus the customer’s (or template’s) payment term.
templateIdstringOptionalInvoice template id. Defaults to your default template.
currencyCodestringOptionalISO currency code. Defaults to the customer’s currency.
referenceNumberstringOptionalYour reference, e.g. a purchase order number.
notesstringOptionalNotes printed on the invoice.
termsAndConditionsstringOptionalTerms printed on the invoice.

Sample Request

cURL
curl -X POST "https://api.ledger365.com/api/v1/invoices" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "customerId": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
         "referenceNumber": "PO-77",
         "lines": [
           {
             "productId": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
             "quantity": 2,
             "discountAmount": 400
           },
           {
             "name": "Courier charges",
             "unitPrice": 100,
             "taxGroupId": ""
           }
         ]
       }'

Response 201 Created

JSON
{
  "data": {
    "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
    "number": "INV-0105",
    "referenceNumber": "PO-77",
    "invoiceDate": "2026-11-20",
    "dueDate": "2026-12-05",
    "status": "Draft",
    "customer": {
      "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
      "name": "Acme Traders"
    },
    "currencyCode": "INR",
    "subTotal": 2100,
    "taxTotal": 360,
    "total": 2460,
    "amountPaid": 0,
    "balanceDue": 2460,
    "createdOn": "2026-11-21T09:35:05Z",
    "customerEmail": "accounts@acme.example",
    "notes": null,
    "termsAndConditions": null,
    "lines": [
      {
        "productId": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
        "name": "Consulting (hourly)",
        "description": "Senior consultant, per hour",
        "hsnCode": "998314",
        "unit": "HRS",
        "quantity": 2,
        "unitPrice": 1200,
        "discountAmount": 400,
        "taxableAmount": 2000,
        "taxAmount": 360,
        "total": 2360,
        "taxes": [
          {
            "name": "CGST",
            "rate": 9,
            "amount": 180
          },
          {
            "name": "SGST",
            "rate": 9,
            "amount": 180
          }
        ]
      },
      {
        "productId": null,
        "name": "Courier charges",
        "description": null,
        "hsnCode": null,
        "unit": null,
        "quantity": 1,
        "unitPrice": 100,
        "discountAmount": null,
        "taxableAmount": 100,
        "taxAmount": 0,
        "total": 100,
        "taxes": []
      }
    ],
    "invoiceTaxes": [],
    "gst": {
      "supplierGstin": "19AAACD1234F1Z5",
      "customerGstin": "19ABCDE1234F1Z5",
      "placeOfSupply": "19-West Bengal",
      "isInterState": false,
      "isReverseCharge": false
    }
  }
}

Update Invoice

Updates invoice details and status. Lines and amounts are changed in Ledger365. Paid and Partial are set automatically when payments are recorded.

PUT/api/v1/invoices/{id} invoices.write

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe invoice id (a GUID returned by the API).

Request Body

ParameterTypeRequiredDescription
statusstringOptionalSent (only from Draft) or Void (only when the invoice has no payments).
dueDatedateOptionalNew due date; an empty string removes it.
referenceNumberstringOptionalYour reference.
notesstringOptionalNotes printed on the invoice.
termsAndConditionsstringOptionalTerms printed on the invoice.

Sample Request

cURL
curl -X PUT "https://api.ledger365.com/api/v1/invoices/b50e60ed-2e5a-4fc7-8685-f08c3535d144" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "status": "Sent",
         "dueDate": "2026-12-10"
       }'

Response 200 OK

JSON
{
  "data": {
    "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
    "number": "INV-0105",
    "referenceNumber": "PO-77",
    "invoiceDate": "2026-11-20",
    "dueDate": "2026-12-10",
    "status": "Sent",
    "customer": {
      "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
      "name": "Acme Traders"
    },
    "currencyCode": "INR",
    "subTotal": 2100,
    "taxTotal": 360,
    "total": 2460,
    "amountPaid": 0,
    "balanceDue": 2460,
    "createdOn": "2026-11-21T09:35:05Z",
    "customerEmail": "accounts@acme.example",
    "notes": null,
    "termsAndConditions": null,
    "lines": [
      {
        "productId": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
        "name": "Consulting (hourly)",
        "description": "Senior consultant, per hour",
        "hsnCode": "998314",
        "unit": "HRS",
        "quantity": 2,
        "unitPrice": 1200,
        "discountAmount": 400,
        "taxableAmount": 2000,
        "taxAmount": 360,
        "total": 2360,
        "taxes": [
          {
            "name": "CGST",
            "rate": 9,
            "amount": 180
          },
          {
            "name": "SGST",
            "rate": 9,
            "amount": 180
          }
        ]
      },
      {
        "productId": null,
        "name": "Courier charges",
        "description": null,
        "hsnCode": null,
        "unit": null,
        "quantity": 1,
        "unitPrice": 100,
        "discountAmount": null,
        "taxableAmount": 100,
        "taxAmount": 0,
        "total": 100,
        "taxes": []
      }
    ],
    "invoiceTaxes": [],
    "gst": {
      "supplierGstin": "19AAACD1234F1Z5",
      "customerGstin": "19ABCDE1234F1Z5",
      "placeOfSupply": "19-West Bengal",
      "isInterState": false,
      "isReverseCharge": false
    }
  }
}

List Payments

Returns a paginated list of payments received, newest first.

GET/api/v1/payments payments.read

Query Parameters

ParameterTypeRequiredDescription
invoiceIdstringOptionalOnly payments for this invoice.
dateFromdateOptionalPayment date on or after (yyyy-MM-dd).
dateTodateOptionalPayment date on or before (yyyy-MM-dd).
pageintegerOptionalPage number (default 1).
pageSizeintegerOptionalItems per page (default 25, max 100).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/payments?invoiceId=b50e60ed-2e5a-4fc7-8685-f08c3535d144" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "b95f3712-b41b-41d1-88d1-9b4658da4aa7",
      "invoice": {
        "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
        "name": "INV-0105"
      },
      "paymentDate": "2026-11-21",
      "amount": 500,
      "currencyCode": "INR",
      "paymentMode": {
        "id": 2,
        "name": "Bank Transfer"
      },
      "referenceNumber": "UTR123456",
      "notes": null,
      "createdOn": "2026-11-21T10:02:41Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

Record Payment

Records a payment against an invoice. The invoice becomes Partial or Paid automatically. Payments larger than the balance due are refused.

POST/api/v1/payments payments.write

Request Body

ParameterTypeRequiredDescription
invoiceIdstringRequiredInvoice id.
amountnumberRequiredAmount received (greater than 0, not more than the balance due).
paymentModeIdintegerRequiredPayment mode id (see List Payment Modes).
paymentDatedateOptionalDate received (yyyy-MM-dd). Defaults to today.
referenceNumberstringOptionalTransaction or cheque reference.
notesstringOptionalInternal notes.

Sample Request

cURL
curl -X POST "https://api.ledger365.com/api/v1/payments" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..." \
     -H "Content-Type: application/json" \
     -d '{
         "invoiceId": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
         "amount": 500,
         "paymentModeId": 2,
         "paymentDate": "2026-11-21",
         "referenceNumber": "UTR123456"
       }'

Response 201 Created

JSON
{
  "data": {
    "id": "b95f3712-b41b-41d1-88d1-9b4658da4aa7",
    "invoice": {
      "id": "b50e60ed-2e5a-4fc7-8685-f08c3535d144",
      "name": "INV-0105"
    },
    "paymentDate": "2026-11-21",
    "amount": 500,
    "currencyCode": "INR",
    "paymentMode": {
      "id": 2,
      "name": "Bank Transfer"
    },
    "referenceNumber": "UTR123456",
    "notes": null,
    "createdOn": "2026-11-21T10:02:41Z"
  }
}

List Payment Modes

Returns the payment modes you can use when recording payments.

GET/api/v1/payment-modes payments.read

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/payment-modes" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": 1,
      "name": "Cash"
    },
    {
      "id": 2,
      "name": "Bank Transfer"
    },
    {
      "id": 3,
      "name": "Check"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 3,
    "totalItems": 3,
    "totalPages": 1
  }
}

List Estimates

Returns a paginated list of estimates (quotations), newest first.

GET/api/v1/estimates estimates.read

Query Parameters

ParameterTypeRequiredDescription
statusstringOptionalDraft, Sent, Accepted, Rejected or Expired.
customerIdstringOptionalOnly estimates for this customer.
dateFromdateOptionalEstimate date on or after (yyyy-MM-dd).
dateTodateOptionalEstimate date on or before (yyyy-MM-dd).
pageintegerOptionalPage number (default 1).
pageSizeintegerOptionalItems per page (default 25, max 100).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/estimates?status=Sent" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": [
    {
      "id": "5b0ff1d5-532a-4d46-8b79-8a86b70c50e0",
      "number": "EST-0002",
      "referenceNumber": null,
      "estimateDate": "2026-11-12",
      "expiryDate": "2026-12-12",
      "status": "Sent",
      "customer": {
        "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
        "name": "Acme Traders"
      },
      "currencyCode": "INR",
      "subTotal": 1600,
      "taxTotal": 288,
      "total": 1888,
      "createdOn": "2026-11-12T16:55:43Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalItems": 1,
    "totalPages": 1
  }
}

Get Estimate

Returns one estimate with its lines and taxes. convertedInvoiceId is set once the estimate has been turned into an invoice.

GET/api/v1/estimates/{id} estimates.read

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe estimate id (a GUID returned by the API).

Sample Request

cURL
curl -X GET "https://api.ledger365.com/api/v1/estimates/5b0ff1d5-532a-4d46-8b79-8a86b70c50e0" \
     -H "Authorization: Bearer l365_a1b2c3d4e5f6..."

Response 200 OK

JSON
{
  "data": {
    "id": "5b0ff1d5-532a-4d46-8b79-8a86b70c50e0",
    "number": "EST-0002",
    "referenceNumber": null,
    "estimateDate": "2026-11-12",
    "expiryDate": "2026-12-12",
    "status": "Sent",
    "customer": {
      "id": "86f0d2c8-6190-4c84-8877-73c48b46fe1c",
      "name": "Acme Traders"
    },
    "currencyCode": "INR",
    "subTotal": 1600,
    "taxTotal": 288,
    "total": 1888,
    "createdOn": "2026-11-12T16:55:43Z",
    "notes": null,
    "termsAndConditions": "Valid for 30 days.",
    "lines": [
      {
        "productId": "f9c5679d-b54d-4af7-a8f3-10f0745514f9",
        "name": "Consulting (hourly)",
        "description": null,
        "hsnCode": "998314",
        "unit": "HRS",
        "quantity": 1,
        "unitPrice": 1600,
        "discountAmount": null,
        "taxableAmount": 1600,
        "taxAmount": 288,
        "total": 1888,
        "taxes": [
          {
            "name": "CGST",
            "rate": 9,
            "amount": 144
          },
          {
            "name": "SGST",
            "rate": 9,
            "amount": 144
          }
        ]
      }
    ],
    "estimateTaxes": [],
    "convertedInvoiceId": null
  }
}