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
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
| Resource | Endpoints | Status |
|---|---|---|
| Customers | List, Get, Create, Update | Live |
| Products | List, Get, Create, Update | Live |
| Tax Groups | List | Live |
| Invoices | List, Get, Create, Update | Live |
| Payments | List, Record | Live |
| Payment Modes | List | Live |
| Estimates | List, Get | Live |
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:
Authorization: Bearer l365_your_token_here
Example Request
curl -X GET "https://api.ledger365.com/api/v1/customers" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Token Security
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.
| Scope | Description |
|---|---|
| customers.read | List and view customers |
| customers.write | Create and update customers |
| products.read | List and view products, services and tax groups |
| products.write | Create and update products |
| invoices.read | List and view invoices with lines and taxes |
| invoices.write | Create draft invoices and update invoice details |
| payments.read | List payments and payment modes |
| payments.write | Record payments against invoices |
| estimates.read | List and view estimates |
Errors
The API uses standard HTTP status codes and returns errors in a consistent JSON format.
Error Response Format
{
"error": {
"code": "INVALID_TOKEN",
"message": "The provided token is not valid."
}
}HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created — the resource was created |
| 400 | Bad request — invalid or missing fields |
| 401 | Unauthorized — missing, invalid, expired or revoked token |
| 403 | Forbidden — the token lacks the required scope, or the IP address is not allowed |
| 404 | Not found — the resource does not exist in your company |
| 429 | Too many requests — rate limit exceeded |
| 500 | Server error — try again later |
Error Codes
| Code | Description |
|---|---|
| MISSING_TOKEN | No Authorization header with a Bearer token was sent |
| INVALID_TOKEN | The token format is wrong or the token was not found |
| TOKEN_EXPIRED | The token has passed its expiry date |
| TOKEN_REVOKED | The token has been revoked |
| CLIENT_INACTIVE | The API client of the token is inactive or deleted |
| IP_NOT_ALLOWED | The request came from an IP address the client does not allow |
| INSUFFICIENT_SCOPE | The token does not have the scope this endpoint requires |
| RATE_LIMITED | Too many requests in the last minute |
| NOT_FOUND | The requested resource was not found |
| VALIDATION_ERROR | One or more fields are missing or invalid |
| DUPLICATE | A record with the same name or code already exists |
| NO_TEMPLATE | The company has no active invoice template |
| INVALID_STATUS | The requested status change is not allowed |
| INVOICE_VOID | The invoice is void and cannot be changed |
| OVERPAYMENT | The payment is larger than the balance due |
| INTERNAL_ERROR | An 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
| Parameter | Type | Default | Description |
|---|---|---|---|
| page | integer | 1 | Page number (default 1). |
| pageSize | integer | 25 | Items per page (default 25, max 100). |
Response Format
{
"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.
{
"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.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | Optional | Filter by name, display name, email or code (partial match). |
| page | integer | Optional | Page number (default 1). |
| pageSize | integer | Optional | Items per page (default 25, max 100). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/customers?search=acme&page=1&pageSize=25" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The customer id (a GUID returned by the API). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/customers/86f0d2c8-6190-4c84-8877-73c48b46fe1c" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Required to create | Customer name, unique in your company (max 200). Required when creating. |
| displayName | string | Optional | Name shown on documents, if different. |
| code | string | Optional | Your own customer code, unique in your company. |
| string | Optional | Email address; invoices and reminders are sent here. | |
| phone | string | Optional | Phone number. |
| mobile | string | Optional | Mobile number. |
| website | string | Optional | Website address. |
| taxNumber | string | Optional | Tax registration number, e.g. GSTIN in India. |
| currencyCode | string | Optional | ISO currency code. Defaults to your company currency. |
| paymentTermDays | integer | Optional | Days until payment is due (0-365). Used for new invoices. |
| creditLimit | number | Optional | Credit limit. |
| notes | string | Optional | Internal notes. |
| isActive | boolean | Optional | Update only: set false to deactivate the customer. |
| billingAddress | object | Optional | line1, line2, city, state, stateCode, postalCode, countryCode. In India, stateCode is the GST state code used for place of supply. |
Sample Request
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
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The customer id (a GUID returned by the API). |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Required to create | Customer name, unique in your company (max 200). Required when creating. |
| displayName | string | Optional | Name shown on documents, if different. |
| code | string | Optional | Your own customer code, unique in your company. |
| string | Optional | Email address; invoices and reminders are sent here. | |
| phone | string | Optional | Phone number. |
| mobile | string | Optional | Mobile number. |
| website | string | Optional | Website address. |
| taxNumber | string | Optional | Tax registration number, e.g. GSTIN in India. |
| currencyCode | string | Optional | ISO currency code. Defaults to your company currency. |
| paymentTermDays | integer | Optional | Days until payment is due (0-365). Used for new invoices. |
| creditLimit | number | Optional | Credit limit. |
| notes | string | Optional | Internal notes. |
| isActive | boolean | Optional | Update only: set false to deactivate the customer. |
| billingAddress | object | Optional | line1, line2, city, state, stateCode, postalCode, countryCode. In India, stateCode is the GST state code used for place of supply. |
Sample Request
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
{
"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.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | Optional | Filter by name, SKU or HSN/SAC code (partial match). |
| type | string | Optional | Goods or Service. |
| active | boolean | Optional | true for active products only, false for inactive only. |
| page | integer | Optional | Page number (default 1). |
| pageSize | integer | Optional | Items per page (default 25, max 100). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/products?type=Service&active=true" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The product id (a GUID returned by the API). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/products/f9c5679d-b54d-4af7-a8f3-10f0745514f9" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Required to create | Product or service name (max 200). Required when creating. |
| unitPrice | number | Required to create | Price per unit, before tax. Required when creating. |
| type | string | Optional | Goods (default) or Service. |
| sku | string | Optional | Stock keeping unit / item code. |
| description | string | Optional | Short description shown on invoice lines. |
| unit | string | Optional | Unit of measure code, e.g. PCS, HRS, KG (default PCS). |
| hsnCode | string | Optional | HSN code (goods) or SAC code (services). |
| currencyCode | string | Optional | ISO currency code. Defaults to your company currency. |
| taxGroupId | string | Optional | Default tax group id (see List Tax Groups). Send an empty string to remove it. |
| isActive | boolean | Optional | Set false to hide the product from new invoices. |
Sample Request
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
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The product id (a GUID returned by the API). |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Required to create | Product or service name (max 200). Required when creating. |
| unitPrice | number | Required to create | Price per unit, before tax. Required when creating. |
| type | string | Optional | Goods (default) or Service. |
| sku | string | Optional | Stock keeping unit / item code. |
| description | string | Optional | Short description shown on invoice lines. |
| unit | string | Optional | Unit of measure code, e.g. PCS, HRS, KG (default PCS). |
| hsnCode | string | Optional | HSN code (goods) or SAC code (services). |
| currencyCode | string | Optional | ISO currency code. Defaults to your company currency. |
| taxGroupId | string | Optional | Default tax group id (see List Tax Groups). Send an empty string to remove it. |
| isActive | boolean | Optional | Set false to hide the product from new invoices. |
Sample Request
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
{
"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.
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/tax-groups" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | Optional | Draft, Sent, Partial, Paid, Overdue or Void. |
| customerId | string | Optional | Only invoices for this customer. |
| dateFrom | date | Optional | Invoice date on or after (yyyy-MM-dd). |
| dateTo | date | Optional | Invoice date on or before (yyyy-MM-dd). |
| search | string | Optional | Filter by invoice number, reference or customer name. |
| page | integer | Optional | Page number (default 1). |
| pageSize | integer | Optional | Items per page (default 25, max 100). |
Sample Request
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
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The invoice id (a GUID returned by the API). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/invoices/b50e60ed-2e5a-4fc7-8685-f08c3535d144" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| customerId | string | Required | Customer id. |
| lines | array | Required | One 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. |
| invoiceDate | date | Optional | Invoice date (yyyy-MM-dd). Defaults to today in your company’s time zone. |
| dueDate | date | Optional | Due date. Defaults to the invoice date plus the customer’s (or template’s) payment term. |
| templateId | string | Optional | Invoice template id. Defaults to your default template. |
| currencyCode | string | Optional | ISO currency code. Defaults to the customer’s currency. |
| referenceNumber | string | Optional | Your reference, e.g. a purchase order number. |
| notes | string | Optional | Notes printed on the invoice. |
| termsAndConditions | string | Optional | Terms printed on the invoice. |
Sample Request
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
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The invoice id (a GUID returned by the API). |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | Optional | Sent (only from Draft) or Void (only when the invoice has no payments). |
| dueDate | date | Optional | New due date; an empty string removes it. |
| referenceNumber | string | Optional | Your reference. |
| notes | string | Optional | Notes printed on the invoice. |
| termsAndConditions | string | Optional | Terms printed on the invoice. |
Sample Request
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
{
"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.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| invoiceId | string | Optional | Only payments for this invoice. |
| dateFrom | date | Optional | Payment date on or after (yyyy-MM-dd). |
| dateTo | date | Optional | Payment date on or before (yyyy-MM-dd). |
| page | integer | Optional | Page number (default 1). |
| pageSize | integer | Optional | Items per page (default 25, max 100). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/payments?invoiceId=b50e60ed-2e5a-4fc7-8685-f08c3535d144" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| invoiceId | string | Required | Invoice id. |
| amount | number | Required | Amount received (greater than 0, not more than the balance due). |
| paymentModeId | integer | Required | Payment mode id (see List Payment Modes). |
| paymentDate | date | Optional | Date received (yyyy-MM-dd). Defaults to today. |
| referenceNumber | string | Optional | Transaction or cheque reference. |
| notes | string | Optional | Internal notes. |
Sample Request
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
{
"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.
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/payment-modes" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | Optional | Draft, Sent, Accepted, Rejected or Expired. |
| customerId | string | Optional | Only estimates for this customer. |
| dateFrom | date | Optional | Estimate date on or after (yyyy-MM-dd). |
| dateTo | date | Optional | Estimate date on or before (yyyy-MM-dd). |
| page | integer | Optional | Page number (default 1). |
| pageSize | integer | Optional | Items per page (default 25, max 100). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/estimates?status=Sent" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The estimate id (a GUID returned by the API). |
Sample Request
curl -X GET "https://api.ledger365.com/api/v1/estimates/5b0ff1d5-532a-4d46-8b79-8a86b70c50e0" \ -H "Authorization: Bearer l365_a1b2c3d4e5f6..."
Response 200 OK
{
"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
}
}