API

Create users/businesses and setup automated banking via the API

If you want to add this additional functinality to your app, we can expose private api methods to you so you can do more. Your users don’t even have to know they’re using LessAccounting. Contact us

API Forum

The LessAccounting API has a google group. Please use this group to ask questions and receive notifications about the API. Please search for your question before asking to see if your question has already been answered. New members are moderated so your question might not show up for a few hours. http://groups.google.com/group/less-accounting-api

Authentication

The LessAccounting API requires authentication for every request. HTTP Basic Authentication is the only supported authentication scheme.

API Keys

All uses of the LessAccounting API are required to have a valid API Key, which must be supplied as a parameter to each method in the API.

Abuse of the API will result in the api key being revoked. API calls made with a revoked API Key will receive the follow xml as the response with a status code 403:

<?xml version="1.0" encoding="UTF-8"?><errors><error>API Key is not valid</error></errors>

You must have a valid user account to create an API key.

Create/view your API Keys

HTTP Verbs

• The API makes use of the HTTP verbs GET, POST, PUT and DELETE.
• Many of the methods are made to the same url and the HTTP verb is used to distinguish what type of operation to perform (Create, Read, Update, Delete).
• Since web browsers only support GET and POST, the PUT and DELETE verbs must be supplied via a form variable called ‘_method’ with the value either ‘put’ or ‘delete.’

HTTP Status Codes

Here is a complete list of HTTP status codes . Here is an example of a few:

• 200 OK: everything went ok.
• 304 Not Modified: there was no new data to return.
• 400 Bad Request: your request is invalid, and we’ll return an error message that tells you why.
• 401 Not Authorized: either you need to provide authentication credentials, or the credentials provided aren’t valid.
• 403 Forbidden: we understand your request, but are refusing to fulfill it.  An accompanying error message should explain why.
• 404 Not Found: either you’re requesting an invalid URI or the resource in question doesn’t exist (ex: no such user). 
• 500 Internal Server Error: we did something wrong.  Please post to the group about it and the we will investigate.
• 502 Bad Gateway: returned if More Honey is down or being upgraded.
• 503 Service Unavailable: the More Honey servers are up, but are overloaded with requests.  Try again later.

Errors

Errors are sent with the proper HTTP status codes and the xml in the following format:

<?xml version="1.0" encoding="UTF-8"?> <errors> <error>API Key is not valid</error> </errors>

Method Parameters

Method parameters that pertain to a specific object should be supplied in the format: object_type[parameter]. E.G., bank_account[name] or expense[amount]. Please see the example for each method to see the usage.

Business Methods

get_businesses
HTTP Verb/URL:	GET https://www.lessaccounting.com/businesses/get_businesses.xml
Business sub-domain required in url:	false
Id parameter required in url:	false
API Key (api_key) parameter required:	true
No other parameters.
Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/get_businesses.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <businesses type="array"> <business> <address nil="true"/> <amount-due-string>Amount Due:</amount-due-string> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <currency-id type="integer">1</currency-id> <description-string>Description</description-string> <id type="integer">1</id> <invoice-date-string>Date:</invoice-date-string> <invoice-due-string>Due:</invoice-due-string> <invoice-total-string>i total</invoice-total-string> <level type="integer">2</level> <line-total-string>Line Total</line-total-string> <name>bus1</name> <next-reference-number type="integer">1</next-reference-number> <payment-received-email-subject-string>Payment Received - Thank you</payment-received-email-subject-string> <payment-string>Payment:</payment-string> <paypal-email-address nil="true"/> <proposal-total-string>p total</proposal-total-string> <quantity-string>Quantity</quantity-string> <reference-number-string>Reference #:</reference-number-string> <remaining-balance-string>Remaining Balance:</remaining-balance-string> <sales-tax-fields-default-on type="boolean">true</sales-tax-fields-default-on> <show-paypal type="boolean">false</show-paypal> <subdomain>bus1</subdomain> <title-string>Title</title-string> <total-paid-string>Total Paid:</total-paid-string> <unit-price-string>Unit Price</unit-price-string> <updated-at type="datetime">2008-05-15T07:00:00Z</updated-at> <vat nil="true"/> <vat-string>VAT Number:</vat-string> <email>bus1@example.com</email> </business> <business> <address nil="true"/> <amount-due-string>Amount Due:</amount-due-string> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <currency-id type="integer">1</currency-id> <description-string>Description</description-string> <id type="integer">17</id> <invoice-date-string>Date:</invoice-date-string> <invoice-due-string>Due:</invoice-due-string> <invoice-total-string>i total</invoice-total-string> <level type="integer">2</level> <line-total-string>Line Total</line-total-string> <name>bus17</name> <next-reference-number type="integer">1</next-reference-number> <payment-received-email-subject-string>Payment Received - Thank you</payment-received-email-subject-string> <payment-string>Payment:</payment-string> <paypal-email-address nil="true"/> <proposal-total-string>p total</proposal-total-string> <quantity-string>Quantity</quantity-string> <reference-number-string>Reference #:</reference-number-string> <remaining-balance-string>Remaining Balance:</remaining-balance-string> <sales-tax-fields-default-on type="boolean">true</sales-tax-fields-default-on> <show-paypal type="boolean">false</show-paypal> <subdomain>bus17</subdomain> <title-string>Title</title-string> <total-paid-string>Total Paid:</total-paid-string> <unit-price-string>Unit Price</unit-price-string> <updated-at type="datetime">2008-05-15T07:00:00Z</updated-at> <vat nil="true"/> <vat-string>VAT Number:</vat-string> <email>bus17@example.com</email> </business> </businesses> Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/get_businesses.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [ { "address": null, "amount_due_string": "Amount Due:", "created_at": "2008-05-15T07:00:00Z", "currency_id": 1, "description_string": "Description", "id": 1, "invoice_date_string": "Date:", "invoice_due_string": "Due:", "invoice_total_string": "i total", "level": 2, "line_total_string": "Line Total", "name": "bus1", "next_reference_number": 1, "payment_received_email_subject_string": "Payment Received - Thank you", "payment_string": "Payment:", "paypal_email_address": null, "proposal_total_string": "p total", "quantity_string": "Quantity", "reference_number_string": "Reference #:", "remaining_balance_string": "Remaining Balance:", "sales_tax_fields_default_on": true, "show_paypal": false, "subdomain": "bus1", "title_string": "Title", "total_paid_string": "Total Paid:", "unit_price_string": "Unit Price", "updated_at": "2008-05-15T07:00:00Z", "vat": null, "vat_string": "VAT Number:", "email": "bus1@example.com" }, { "address": null, "amount_due_string": "Amount Due:", "created_at": "2008-05-15T07:00:00Z", "currency_id": 1, "description_string": "Description", "id": 17, "invoice_date_string": "Date:", "invoice_due_string": "Due:", "invoice_total_string": "i total", "level": 2, "line_total_string": "Line Total", "name": "bus17", "next_reference_number": 1, "payment_received_email_subject_string": "Payment Received - Thank you", "payment_string": "Payment:", "paypal_email_address": null, "proposal_total_string": "p total", "quantity_string": "Quantity", "reference_number_string": "Reference #:", "remaining_balance_string": "Remaining Balance:", "sales_tax_fields_default_on": true, "show_paypal": false, "subdomain": "bus17", "title_string": "Title", "total_paid_string": "Total Paid:", "unit_price_string": "Unit Price", "updated_at": "2008-05-15T07:00:00Z", "vat": null, "vat_string": "VAT Number:", "email": "bus17@example.com" } ]
show
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/businesses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the business.
name	String	required	Both	The name of the business.
subdomain	String	required	Both	The subdomain at lessaccounting.com used to access this business.
email	String	required	Both	The email used to send invoices. If not supplied on create then the users email address will be used.
created_at	Datetime	N/A	Output
updated_at	Datetime	N/A	Output
sales_tax_fields_default_on	Boolean	optional	Both	Do line items show sales tax by default. NOTE: a boolean must be passed as either a 1 or a 0.
next_reference_number	Integer	optional	Both	the next number to use to create an invoice or proposal.
address	Text	optional	Both
vat	String	optional	Both	The string displayed for VAT.
paypal_email_address	String	optional	Both	The paypal account email address to use when showing the paypal button in invoices.
currency_id	Integer	optional	Both	The id for the currency type that this business uses. See the Currency object for details. This parameter will be moving to another object in the future.
show_paypal	Boolean	optional	Both	NOTE: a boolean must be passed as either a 1 or a 0.
level	Integer	optional	Both
proposal_total_string	String	optional	Both
invoice_total_string	String	optional	Both
vat_string	String	optional	Both
invoice_date_string	String	optional	Both
invoice_due_string	String	optional	Both
reference_number_string	String	optional	Both
payment_string	String	optional	Both
total_paid_string	String	optional	Both
remaining_balance_string	String	optional	Both
payment_received_email_subject_string	String	optional	Both
title_string	String	optional	Both
description_string	String	optional	Both
unit_price_string	String	optional	Both
quantity_string	String	optional	Both
line_total_string	String	optional	Both
amount_due_string	String	optional	Both
Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <business> <address nil="true"/> <amount-due-string>Amount Due:</amount-due-string> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <currency-id type="integer">1</currency-id> <description-string>Description</description-string> <id type="integer">1</id> <invoice-date-string>Date:</invoice-date-string> <invoice-due-string>Due:</invoice-due-string> <invoice-total-string>i total</invoice-total-string> <level type="integer">2</level> <line-total-string>Line Total</line-total-string> <name>bus1</name> <next-reference-number type="integer">1</next-reference-number> <payment-received-email-subject-string>Payment Received - Thank you</payment-received-email-subject-string> <payment-string>Payment:</payment-string> <paypal-email-address nil="true"/> <proposal-total-string>p total</proposal-total-string> <quantity-string>Quantity</quantity-string> <reference-number-string>Reference #:</reference-number-string> <remaining-balance-string>Remaining Balance:</remaining-balance-string> <sales-tax-fields-default-on type="boolean">true</sales-tax-fields-default-on> <show-paypal type="boolean">false</show-paypal> <subdomain>bus1</subdomain> <title-string>Title</title-string> <total-paid-string>Total Paid:</total-paid-string> <unit-price-string>Unit Price</unit-price-string> <updated-at type="datetime">2008-05-15T07:00:00Z</updated-at> <vat nil="true"/> <vat-string>VAT Number:</vat-string> <email>bus1@example.com</email> </business> Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: { "address": null, "amount_due_string": "Amount Due:", "created_at": "2008-05-15T07:00:00Z", "currency_id": 1, "description_string": "Description", "id": 1, "invoice_date_string": "Date:", "invoice_due_string": "Due:", "invoice_total_string": "i total", "level": 2, "line_total_string": "Line Total", "name": "bus1", "next_reference_number": 1, "payment_received_email_subject_string": "Payment Received - Thank you", "payment_string": "Payment:", "paypal_email_address": null, "proposal_total_string": "p total", "quantity_string": "Quantity", "reference_number_string": "Reference #:", "remaining_balance_string": "Remaining Balance:", "sales_tax_fields_default_on": true, "show_paypal": false, "subdomain": "bus1", "title_string": "Title", "total_paid_string": "Total Paid:", "unit_price_string": "Unit Price", "updated_at": "2008-05-15T07:00:00Z", "vat": null, "vat_string": "VAT Number:", "email": "bus1@example.com" }
update
HTTP Verb/URL:	PUT https://<business_name>.https://www.lessaccounting.com/businesses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘put’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the business.
name	String	required	Both	The name of the business.
subdomain	String	required	Both	The subdomain at lessaccounting.com used to access this business.
email	String	required	Both	The email used to send invoices. If not supplied on create then the users email address will be used.
created_at	Datetime	N/A	Output
updated_at	Datetime	N/A	Output
sales_tax_fields_default_on	Boolean	optional	Both	Do line items show sales tax by default. NOTE: a boolean must be passed as either a 1 or a 0.
next_reference_number	Integer	optional	Both	the next number to use to create an invoice or proposal.
address	Text	optional	Both
vat	String	optional	Both	The string displayed for VAT.
paypal_email_address	String	optional	Both	The paypal account email address to use when showing the paypal button in invoices.
currency_id	Integer	optional	Both	The id for the currency type that this business uses. See the Currency object for details. This parameter will be moving to another object in the future.
show_paypal	Boolean	optional	Both	NOTE: a boolean must be passed as either a 1 or a 0.
level	Integer	optional	Both
proposal_total_string	String	optional	Both
invoice_total_string	String	optional	Both
vat_string	String	optional	Both
invoice_date_string	String	optional	Both
invoice_due_string	String	optional	Both
reference_number_string	String	optional	Both
payment_string	String	optional	Both
total_paid_string	String	optional	Both
remaining_balance_string	String	optional	Both
payment_received_email_subject_string	String	optional	Both
title_string	String	optional	Both
description_string	String	optional	Both
unit_price_string	String	optional	Both
quantity_string	String	optional	Both
line_total_string	String	optional	Both
amount_due_string	String	optional	Both
Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.xml?business[name]=mynewbusiness&business[subdomain]=my_new_business&business[email]=myemail@mydomain.com&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.xml?business[name]=&business[subdomain]=&business[email]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Email can't be blank</error> <error>Name can't be blank</error> <error>Name is too short (minimum is 1 characters)</error> <error>Name should contain at least one alpha character (a-z).</error> <error>Subdomain is too short (minimum is 1 characters)</error> </errors> Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.json?business[name]=mynewbusiness&business[subdomain]=my_new_business&business[email]=myemail@mydomain.com&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.json?business[name]=&business[subdomain]=&business[email]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "email": [ "can't be blank" ], "name": [ "can't be blank", "is too short (minimum is 1 characters)", "should contain at least one alpha character (a-z)." ], "subdomain": [ "is too short (minimum is 1 characters)" ] } }
destroy
Notes:	Can only be called by the business owner.
HTTP Verb/URL:	DELETE https://<business_name>.https://www.lessaccounting.com/businesses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘delete’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the business.
name	String	N/A	Output	The name of the business.
subdomain	String	N/A	Output	The subdomain at lessaccounting.com used to access this business.
email	String	N/A	Output	The email used to send invoices. If not supplied on create then the users email address will be used.
created_at	Datetime	N/A	Output
updated_at	Datetime	N/A	Output
sales_tax_fields_default_on	Boolean	N/A	Output	Do line items show sales tax by default. NOTE: a boolean must be passed as either a 1 or a 0.
next_reference_number	Integer	N/A	Output	the next number to use to create an invoice or proposal.
address	Text	N/A	Output
vat	String	N/A	Output	The string displayed for VAT.
paypal_email_address	String	N/A	Output	The paypal account email address to use when showing the paypal button in invoices.
currency_id	Integer	N/A	Output	The id for the currency type that this business uses. See the Currency object for details. This parameter will be moving to another object in the future.
show_paypal	Boolean	N/A	Output	NOTE: a boolean must be passed as either a 1 or a 0.
level	Integer	N/A	Output
proposal_total_string	String	N/A	Output
invoice_total_string	String	N/A	Output
vat_string	String	N/A	Output
invoice_date_string	String	N/A	Output
invoice_due_string	String	N/A	Output
reference_number_string	String	N/A	Output
payment_string	String	N/A	Output
total_paid_string	String	N/A	Output
remaining_balance_string	String	N/A	Output
payment_received_email_subject_string	String	N/A	Output
title_string	String	N/A	Output
description_string	String	N/A	Output
unit_price_string	String	N/A	Output
quantity_string	String	N/A	Output
line_total_string	String	N/A	Output
amount_due_string	String	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/businesses/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [Empty Response]

Bank Account Methods

index
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/bank_accounts.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the bank account.
name	String	N/A	Output	The name of the business.
business_id	Integer	N/A	Output
created_at	Datetime	N/A	Output
starting_balance	Decimal	N/A	Output
last_imported_at	Datetime	N/A	Output
balance	Decimal	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [ { "business_id": 1, "created_at": "2008-05-15T07:00:00Z", "id": 1, "last_imported_at": null, "name": "checking", "starting_balance": 0.0, "balance": -993.18 }, { "business_id": 1, "created_at": "2008-05-15T07:00:00Z", "id": 101, "last_imported_at": null, "name": "other", "starting_balance": 0.0, "balance": 1000.0 } ] Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <bank-accounts type="array"> <bank-account> <business-id type="integer">1</business-id> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <id type="integer">1</id> <last-imported-at type="datetime" nil="true"/> <name>checking</name> <starting-balance type="decimal">0.0</starting-balance> <balance type="decimal">-993.18</balance> </bank-account> <bank-account> <business-id type="integer">1</business-id> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <id type="integer">101</id> <last-imported-at type="datetime" nil="true"/> <name>other</name> <starting-balance type="decimal">0.0</starting-balance> <balance type="decimal">1000.0</balance> </bank-account> </bank-accounts>
show
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/bank_accounts/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the bank account.
name	String	required	Both	The name of the business.
business_id	Integer	N/A	Output
created_at	Datetime	N/A	Output
starting_balance	Decimal	optional	Both
last_imported_at	Datetime	optional	Both
balance	Decimal	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: { "business_id": 1, "created_at": "2008-05-15T07:00:00Z", "id": 1, "last_imported_at": null, "name": "checking", "starting_balance": 0.0, "balance": -993.18 } Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <bank-account> <business-id type="integer">1</business-id> <created-at type="datetime">2008-05-15T07:00:00Z</created-at> <id type="integer">1</id> <last-imported-at type="datetime" nil="true"/> <name>checking</name> <starting-balance type="decimal">0.0</starting-balance> <balance type="decimal">-993.18</balance> </bank-account>
create
HTTP Verb/URL:	POST https://<business_name>.https://www.lessaccounting.com/bank_accounts.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the bank account.
name	String	required	Both	The name of the business.
business_id	Integer	N/A	Output
created_at	Datetime	N/A	Output
starting_balance	Decimal	optional	Both
last_imported_at	Datetime	optional	Both
balance	Decimal	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.xml?bank_account[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Name can't be blank</error> <error>Name must be within range</error> </errors> Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.xml?bank_account[name]=Checking&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: <?xml version="1.0" encoding="UTF-8"?> <bank-account> <business-id type="integer">1</business-id> <created-at type="datetime">2008-05-15T07:00:03Z</created-at> <id type="integer">138</id> <last-imported-at type="datetime" nil="true"/> <name>Checking</name> <starting-balance type="decimal">0.0</starting-balance> <balance type="decimal">0.0</balance> </bank-account> Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.json?bank_account[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "name": [ "can't be blank", "must be within range" ] } } Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts.json?bank_account[name]=Checking&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: { "business_id": 1, "created_at": "2008-05-15T07:00:02Z", "id": 137, "last_imported_at": null, "name": "Checking", "starting_balance": 0.0, "balance": 0.0 }
update
HTTP Verb/URL:	PUT https://<business_name>.https://www.lessaccounting.com/bank_accounts/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘put’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the bank account.
name	String	required	Both	The name of the business.
business_id	Integer	N/A	Output
created_at	Datetime	N/A	Output
starting_balance	Decimal	optional	Both
last_imported_at	Datetime	optional	Both
balance	Decimal	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.json?bank_account[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "name": [ "can't be blank", "must be within range" ] } } Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.xml?bank_account[name]=Checking&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.json?bank_account[name]=Checking&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.xml?bank_account[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Name can't be blank</error> <error>Name must be within range</error> </errors>
destroy
HTTP Verb/URL:	DELETE https://<business_name>.https://www.lessaccounting.com/bank_accounts/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘delete’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the bank account.
name	String	N/A	Output	The name of the business.
business_id	Integer	N/A	Output
created_at	Datetime	N/A	Output
starting_balance	Decimal	N/A	Output
last_imported_at	Datetime	N/A	Output
balance	Decimal	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/bank_accounts/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response]

Expense Category Methods

index
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/expense_categories.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense category.
name	String	N/A	Output	The name of the expense category.
business_id	String	N/A	Output	The id of the business that this expense category belongs to.
expenses_count	String	N/A	Output	The number of expenses that belongs to this expense category.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <expense-categories type="array"> <expense-category> <business-id type="integer">1</business-id> <expenses-count type="integer">0</expenses-count> <id type="integer">1</id> <name>first expense</name> </expense-category> </expense-categories> Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [ { "business_id": 1, "expenses_count": 0, "id": 1, "name": "first expense" } ]
show
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/expense_categories/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense category.
name	String	required	Both	The name of the expense category.
business_id	String	N/A	Output	The id of the business that this expense category belongs to.
expenses_count	String	N/A	Output	The number of expenses that belongs to this expense category.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <expense-category> <business-id type="integer">1</business-id> <expenses-count type="integer">0</expenses-count> <id type="integer">1</id> <name>first expense</name> </expense-category> Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: { "business_id": 1, "expenses_count": 0, "id": 1, "name": "first expense" }
create
HTTP Verb/URL:	POST https://<business_name>.https://www.lessaccounting.com/expense_categories.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense category.
name	String	required	Both	The name of the expense category.
business_id	String	N/A	Output	The id of the business that this expense category belongs to.
expenses_count	String	N/A	Output	The number of expenses that belongs to this expense category.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.xml?expense_category[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Name can't be blank</error> <error>Name is too short (minimum is 1 characters)</error> </errors> Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.xml?expense_category[name]=Wages&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: <?xml version="1.0" encoding="UTF-8"?> <expense-category> <business-id type="integer">1</business-id> <expenses-count type="integer">0</expenses-count> <id type="integer">2698</id> <name>Wages</name> </expense-category> Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.json?expense_category[name]=Wages&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: { "business_id": 1, "expenses_count": 0, "id": 2697, "name": "Wages" } Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories.json?expense_category[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "name": [ "can't be blank", "is too short (minimum is 1 characters)" ] } }
update
HTTP Verb/URL:	PUT https://<business_name>.https://www.lessaccounting.com/expense_categories/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘put’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense category.
name	String	required	Both	The name of the expense category.
business_id	String	N/A	Output	The id of the business that this expense category belongs to.
expenses_count	String	N/A	Output	The number of expenses that belongs to this expense category.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.xml?expense_category[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Name can't be blank</error> <error>Name is too short (minimum is 1 characters)</error> </errors> Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.json?expense_category[name]=Wages&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.json?expense_category[name]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "name": [ "can't be blank", "is too short (minimum is 1 characters)" ] } } Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.xml?expense_category[name]=Wages&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response]
destroy
HTTP Verb/URL:	DELETE https://<business_name>.https://www.lessaccounting.com/expense_categories/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘delete’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense category.
name	String	N/A	Output	The name of the expense category.
business_id	String	N/A	Output	The id of the business that this expense category belongs to.
expenses_count	String	N/A	Output	The number of expenses that belongs to this expense category.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/expense_categories/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response]

Expense Methods

index
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/expenses.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense.
since	Integer Or Date	optional	Input	Only return invoices that are newer than the expense id or date provided as the since value.
amount	Decimal	N/A	Output
bank_account_id	Integer	N/A	Output
title	String	N/A	Output
check_number	String	N/A	Output
created_at	Datetime	N/A	Output
creator_id	Integer	N/A	Output
updated_at	Datetime	N/A	Output
updater_id	Integer	N/A	Output
notes	Text	N/A	Output
business_id	Integer	N/A	Output
date	Date	N/A	Output	Returns the paid date if this expense is paid or the due date if it is not paid.
expense_category_id	Integer	N/A	Output
contractor_id	Integer	N/A	Output
employee_id	Integer	N/A	Output
paid_date	Date	N/A	Output	Either due date or paid date is required.
is_paid	Boolean	N/A	Output	NOTE: a boolean must be passed as either a 1 or a 0.
transfer_fund_id	Integer	N/A	Output	The Transfer Fund that this expense is associated with.
payee_id	Integer	N/A	Output
due_date	Date	N/A	Output	Either due date or paid date is required.
client_id	Integer	N/A	Output
receipt_url	Integer	N/A	Output
q	String	optional	Input	The query to use in search.
page	Integer	optional	Input	The page of the search results to return. Default is 1. The number of items per page is 25.
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [ { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 1, "is_paid": true, "notes": null, "paid_date": "2006-01-01", "payee_id": null, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 1, "id": 1, "is_paid": true, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": null, "business_id": 1, "check_number": null, "client_id": null, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 100, "is_paid": null, "notes": null, "paid_date": null, "payee_id": null, "title": "first expense", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 100, "id": 100, "is_paid": null, "notes": null, "payee_id": null, "repeated_template": false, "title": null, "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2007-01-01", "employee_id": null, "expense_category_id": 1, "id": 999, "is_paid": null, "notes": null, "paid_date": null, "payee_id": null, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 999, "id": 999, "is_paid": null, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": null, "due_date": null, "employee_id": null, "expense_category_id": 1, "id": 2001, "is_paid": null, "notes": null, "paid_date": null, "payee_id": null, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": null, "employee_id": null, "expense_category_id": 1, "expense_id": 2001, "id": 2001, "is_paid": null, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": null, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 2002, "is_paid": true, "notes": null, "paid_date": "2006-01-01", "payee_id": null, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 2002, "id": 2002, "is_paid": true, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 2013, "is_paid": true, "notes": null, "paid_date": "2006-01-01", "payee_id": null, "title": "Test 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 2013, "id": 2013, "is_paid": true, "notes": null, "payee_id": null, "repeated_template": false, "title": "Test 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] }, { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 2014, "is_paid": true, "notes": null, "paid_date": "2006-01-01", "payee_id": null, "title": "Check Card 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 2014, "id": 2014, "is_paid": true, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check Card 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] } ] Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <expenses type="array"> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">1</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <paid-date type="date">2006-01-01</paid-date> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">1</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer" nil="true"/> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">100</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <paid-date type="date" nil="true"/> <payee-id type="integer" nil="true"/> <title>first expense</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">100</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title nil="true"/> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2007-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">999</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <paid-date type="date" nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">999</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date" nil="true"/> <due-date type="date" nil="true"/> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2001</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <paid-date type="date" nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date" nil="true"/> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2001</id> <is-paid type="boolean" nil="true"/> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2002</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <paid-date type="date">2006-01-01</paid-date> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2002</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2013</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <paid-date type="date">2006-01-01</paid-date> <payee-id type="integer" nil="true"/> <title>Test 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2013</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Test 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2014</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <paid-date type="date">2006-01-01</paid-date> <payee-id type="integer" nil="true"/> <title>Check Card 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">2014</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check Card 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> </expenses>
index (since)
HTTP Verb/URL:	GET https://<business_name>.lessaccounting.com
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
Same as index	String	required	Output	Same as index
uncategorized
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/expenses/uncategorized.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
Same as index	String	required	Output	Same as index expect only shows expenses that are uncategorized
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/uncategorized.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <nil-classes type="array"/> Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/uncategorized.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: [ ]
show
HTTP Verb/URL:	GET https://<business_name>.https://www.lessaccounting.com/expenses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense.
since	Integer Or Date	optional	Input	Only return invoices that are newer than the expense id or date provided as the since value.
amount	Decimal	optional	Both
bank_account_id	Integer	optional	Both
title	String	optional	Both
check_number	String	optional	Both
created_at	Datetime	N/A	Output
creator_id	Integer	N/A	Output
updated_at	Datetime	N/A	Output
updater_id	Integer	N/A	Output
notes	Text	optional	Both
business_id	Integer	N/A	Output
date	Date	N/A	Output	Returns the paid date if this expense is paid or the due date if it is not paid.
expense_category_id	Integer	optional	Both
contractor_id	Integer	optional	Both
employee_id	Integer	optional	Both
paid_date	Date	required	Both	Either due date or paid date is required.
is_paid	Boolean	optional	Both	NOTE: a boolean must be passed as either a 1 or a 0.
transfer_fund_id	Integer	optional	Both	The Transfer Fund that this expense is associated with.
payee_id	Integer	optional	Both
due_date	Date	required	Both	Either due date or paid date is required.
client_id	Integer	optional	Both
receipt_url	Integer	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: { "amount": 1.06, "bank_account_id": 1, "business_id": 1, "check_number": null, "client_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "creator_id": 1, "date": "2006-01-01", "due_date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "id": 1, "is_paid": true, "notes": null, "paid_date": "2006-01-01", "payee_id": null, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 1.06, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2006-01-01T00:00:00Z", "date": "2006-01-01", "employee_id": null, "expense_category_id": 1, "expense_id": 1, "id": 1, "is_paid": true, "notes": null, "payee_id": null, "repeated_template": false, "title": "Check 111", "transfer_fund_id": null, "updated_at": "2006-01-01T00:00:00Z", "years_holding_value": 0 } ] } Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 200 Response: <?xml version="1.0" encoding="UTF-8"?> <expense> <amount type="decimal">1.06</amount> <bank-account-id type="integer">1</bank-account-id> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer">1</client-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2006-01-01</date> <due-date type="date">2006-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">1</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <paid-date type="date">2006-01-01</paid-date> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">1.06</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2006-01-01T00:00:00Z</created-at> <date type="date">2006-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer">1</expense-category-id> <id type="integer">1</id> <is-paid type="boolean">true</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Check 111</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2006-01-01T00:00:00Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense>
create
HTTP Verb/URL:	POST https://<business_name>.https://www.lessaccounting.com/expenses.xml
Business sub-domain required in url:	true
Id parameter required in url:	false
API Key (api_key) parameter required:	true
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense.
since	Integer Or Date	optional	Input	Only return invoices that are newer than the expense id or date provided as the since value.
amount	Decimal	optional	Both
bank_account_id	Integer	optional	Both
title	String	optional	Both
check_number	String	optional	Both
created_at	Datetime	N/A	Output
creator_id	Integer	N/A	Output
updated_at	Datetime	N/A	Output
updater_id	Integer	N/A	Output
notes	Text	optional	Both
business_id	Integer	N/A	Output
date	Date	N/A	Output	Returns the paid date if this expense is paid or the due date if it is not paid.
expense_category_id	Integer	optional	Both
contractor_id	Integer	optional	Both
employee_id	Integer	optional	Both
paid_date	Date	required	Both	Either due date or paid date is required.
is_paid	Boolean	optional	Both	NOTE: a boolean must be passed as either a 1 or a 0.
transfer_fund_id	Integer	optional	Both	The Transfer Fund that this expense is associated with.
payee_id	Integer	optional	Both
due_date	Date	required	Both	Either due date or paid date is required.
client_id	Integer	optional	Both
receipt_url	Integer	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.json?expense[title]=&expense[amount]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "expense_items.amount": [ "is not a number" ], "amount": [ "is not a number" ], "date": [ "either due date or paid date must be a valid date format." ] } } Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.json?expense[title]=Pizza&expense[amount]=15.87&expense[due_date]=2008-01-01&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: { "amount": 15.87, "bank_account_id": null, "business_id": 1, "check_number": null, "client_id": null, "contractor_id": null, "created_at": "2008-05-15T07:00:31Z", "creator_id": 1, "date": "2008-01-01", "due_date": "2008-01-01", "employee_id": null, "expense_category_id": null, "id": 2382, "is_paid": false, "notes": "", "paid_date": null, "payee_id": null, "title": "Pizza", "transfer_fund_id": null, "updated_at": "2008-05-15T07:00:31Z", "updater_id": 1, "receipt_url": "", "expense_items": [ { "amount": 15.87, "bank_account_id": null, "business_id": 1, "contractor_id": null, "created_at": "2008-05-15T07:00:31Z", "date": "2008-01-01", "employee_id": null, "expense_category_id": null, "expense_id": 2382, "id": 2380, "is_paid": false, "notes": null, "payee_id": null, "repeated_template": false, "title": "Pizza", "transfer_fund_id": null, "updated_at": "2008-05-15T07:00:31Z", "years_holding_value": 0 } ] } Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.xml?expense[title]=Pizza&expense[amount]=15.87&expense[due_date]=2008-01-01&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 201 Response: <?xml version="1.0" encoding="UTF-8"?> <expense> <amount type="decimal">15.87</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <check-number nil="true"/> <client-id type="integer" nil="true"/> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2008-05-15T07:00:32Z</created-at> <creator-id type="integer">1</creator-id> <date type="date">2008-01-01</date> <due-date type="date">2008-01-01</due-date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer" nil="true"/> <id type="integer">2383</id> <is-paid type="boolean">false</is-paid> <notes></notes> <paid-date type="date" nil="true"/> <payee-id type="integer" nil="true"/> <title>Pizza</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2008-05-15T07:00:32Z</updated-at> <updater-id type="integer">1</updater-id> <receipt-url></receipt-url> <expense-items type="array"> <expense-item> <amount type="decimal">15.87</amount> <bank-account-id type="integer" nil="true"/> <business-id type="integer">1</business-id> <contractor-id type="integer" nil="true"/> <created-at type="datetime">2008-05-15T07:00:32Z</created-at> <date type="date">2008-01-01</date> <employee-id type="integer" nil="true"/> <expense-category-id type="integer" nil="true"/> <id type="integer">2381</id> <is-paid type="boolean">false</is-paid> <notes nil="true"/> <payee-id type="integer" nil="true"/> <title>Pizza</title> <transfer-fund-id type="integer" nil="true"/> <updated-at type="datetime">2008-05-15T07:00:32Z</updated-at> <years-holding-value type="integer">0</years-holding-value> </expense-item> </expense-items> </expense> Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses.xml?expense[title]=&expense[amount]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Expense items amount is not a number</error> <error>Amount is not a number</error> <error>Date either due date or paid date must be a valid date format.</error> </errors>
update
HTTP Verb/URL:	PUT https://<business_name>.https://www.lessaccounting.com/expenses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘put’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense.
since	Integer Or Date	optional	Input	Only return invoices that are newer than the expense id or date provided as the since value.
amount	Decimal	optional	Both
bank_account_id	Integer	optional	Both
title	String	optional	Both
check_number	String	optional	Both
created_at	Datetime	N/A	Output
creator_id	Integer	N/A	Output
updated_at	Datetime	N/A	Output
updater_id	Integer	N/A	Output
notes	Text	optional	Both
business_id	Integer	N/A	Output
date	Date	N/A	Output	Returns the paid date if this expense is paid or the due date if it is not paid.
expense_category_id	Integer	optional	Both
contractor_id	Integer	optional	Both
employee_id	Integer	optional	Both
paid_date	Date	required	Both	Either due date or paid date is required.
is_paid	Boolean	optional	Both	NOTE: a boolean must be passed as either a 1 or a 0.
transfer_fund_id	Integer	optional	Both	The Transfer Fund that this expense is associated with.
payee_id	Integer	optional	Both
due_date	Date	required	Both	Either due date or paid date is required.
client_id	Integer	optional	Both
receipt_url	Integer	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.json?expense[title]=&expense[amount]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: { "errors": { "expense_items.amount": [ "is not a number" ], "amount": [ "is not a number" ] } } Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.xml?expense[title]=Pizza&expense[amount]=15.87&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.json?expense[title]=Pizza&expense[amount]=15.87&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.xml?expense[title]=&expense[amount]=&api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 422 Response: <?xml version="1.0" encoding="UTF-8"?> <errors> <error>Expense items amount is not a number</error> <error>Amount is not a number</error> </errors>
destroy
HTTP Verb/URL:	DELETE https://<business_name>.https://www.lessaccounting.com/expenses/1.xml
Business sub-domain required in url:	true
Id parameter required in url:	true
API Key (api_key) parameter required:	true
_method	Must be supplied as: ‘delete’
Parameter	Data Type	Required	Input/Output param	Description
id	Integer	N/A	Output	The unique identifier of the expense.
since	Integer Or Date	optional	Input	Only return invoices that are newer than the expense id or date provided as the since value.
amount	Decimal	N/A	Output
bank_account_id	Integer	N/A	Output
title	String	N/A	Output
check_number	String	N/A	Output
created_at	Datetime	N/A	Output
creator_id	Integer	N/A	Output
updated_at	Datetime	N/A	Output
updater_id	Integer	N/A	Output
notes	Text	N/A	Output
business_id	Integer	N/A	Output
date	Date	N/A	Output	Returns the paid date if this expense is paid or the due date if it is not paid.
expense_category_id	Integer	N/A	Output
contractor_id	Integer	N/A	Output
employee_id	Integer	N/A	Output
paid_date	Date	N/A	Output	Either due date or paid date is required.
is_paid	Boolean	N/A	Output	NOTE: a boolean must be passed as either a 1 or a 0.
transfer_fund_id	Integer	N/A	Output	The Transfer Fund that this expense is associated with.
payee_id	Integer	N/A	Output
due_date	Date	N/A	Output	Either due date or paid date is required.
client_id	Integer	N/A	Output
receipt_url	Integer	N/A	Output
Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.json?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response] Example: Request: https://{your_business}.https://www.lessaccounting.com/expenses/1.xml?api_key=89341988-6b36-4128-b3d5-deab427132a7 Response Status: 204 Response: [Empty Response]