Expense
Expenses are the costs incurred on your company's operating activities and overheads. Expense object allows you to perform the following operations:
- Retrieve a specific or a list of expenses
- Create an expense
- Update an expense
- Delete an expense
- cURL
- NODE.JS
- PHP
- C#
- PYTHON
- JAVA
The Expense Object
asterisk denotes requiredName | Description | Format | Attributes |
---|---|---|---|
code | Represents an expense item code | string | MaxLength = 100 Filterable |
description | Represents the description of an expense | string | MaxLength = 100 Filterable, Sortable |
billable | Indicates whether an expense is billable or not. If true, the expense is billable | boolean | Filterable, Sortable |
class | Name of the class | string | Filterable, Sortable |
classId | Identifier of the class | uuid | Filterable |
costRate | The per unit cost of an expense item | double | |
createdById | Identifier of the user who created this object | uuid | Filterable |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time | Filterable, Sortable |
customFields []Array: Parent object can have multiple instances of this nested object under it. | Represents a list of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. | |
defaultGroup | Name of the default group to which an expense item belongs | string | |
defaultGroupId | Identifier of the default group to which an expense item belongs | uuid | |
expenseAccount | Name of an expense account associated with an expense | string | |
expenseAccountId | Identifier of an expense account used to track the expenditure associated with expenses incurred | uuid | |
id | Object identifier | uuid | Filterable |
incomeAccount | Name of an income account associated with an expense | string | |
incomeAccountId | Identifier of an income account used to track the income associated with expenses incurred | uuid | |
isActive | Indicates the status of an expense item. If true, status is active | boolean | Filterable, Sortable |
isProduct | Determines whether this is a product or not | boolean | Filterable, Sortable |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time | Filterable, Sortable |
lastUpdatedById | Identifier of the user who last updated this object | uuid | Filterable |
markup | Percentage increase in the cost rate to determine the cost amount | double | |
memo | Records any extra information or details about an expense | string | |
name | Name of the expense | string | Filterable, Sortable MaxLength = 31 |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectState Enumerated type: Click to see possible values and their descriptions. | |
purchaseTaxRate | Tax paid by a company on an expense subtracted from the expense amount to avoid double-taxation for the client | double | |
reimbursable | Indicates whether an expense is reimbursable or not. If true, expense is reimbursable | boolean | Filterable, Sortable |
sub | Represents an expense item sub-code | string | MaxLength = 15 |
tax1 | In addition to the main expense tax, Tax1 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double | |
tax2 | In addition to the main expense tax, Tax2 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double | |
tax3 | In addition to the main expense tax, Tax3 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double | |
token | Represents the token for update operations | int32 | |
type | Represents the expense types, e.g inventory, non-inventory, etc. | ExpenseType Enumerated type: Click to see possible values and their descriptions. | Filterable, Sortable |
version | Implements concurrency on this object | byte |
Expense List
Use this method to retrieve a list of expenses. Optionally pass where, orderBy and page as the query parameters to filter the result. Use the fields parameter to request a subset of the model. By default, a complete model is returned. The expand parameter is used to request nested properties in the model.
Request URL
Method Overview
HTTP Method:
GET
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
read:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
fields | Query | Specifies the model properties you want in the response body | string |
where | Query | Specifies only those records that match an expression in the query | string |
orderBy | Query | Specifies the order of the records | string |
page | Query | Specifies the page number and number of records on each page | string |
expand | Query | Specifies the nested model properties you want in the response body | string |
Response Body
Name | Description | Format |
---|---|---|
code | Represents an expense item code | string |
description | Represents the description of an expense | string |
billable | Indicates whether an expense is billable or not. If true, the expense is billable | boolean |
class | Name of the class | string |
classId | Identifier of the class | uuid |
costRate | The per unit cost of an expense item | double |
createdById | Identifier of the user who created this object | uuid |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
customFields []Array: Parent object can have multiple instances of this nested object under it. | Represents a list of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
defaultGroup | Name of the default group to which an expense item belongs | string |
defaultGroupId | Identifier of the default group to which an expense item belongs | uuid |
expenseAccount | Name of an expense account associated with an expense | string |
expenseAccountId | Identifier of an expense account used to track the expenditure associated with expenses incurred | uuid |
id | Object identifier | uuid |
incomeAccount | Name of an income account associated with an expense | string |
incomeAccountId | Identifier of an income account used to track the income associated with expenses incurred | uuid |
isActive | Indicates the status of an expense item. If true, status is active | boolean |
isProduct | Determines whether this is a product or not | boolean |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
lastUpdatedById | Identifier of the user who last updated this object | uuid |
markup | Percentage increase in the cost rate to determine the cost amount | double |
memo | Records any extra information or details about an expense | string |
name | Name of the expense | string |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
purchaseTaxRate | Tax paid by a company on an expense subtracted from the expense amount to avoid double-taxation for the client | double |
reimbursable | Indicates whether an expense is reimbursable or not. If true, expense is reimbursable | boolean |
sub | Represents an expense item sub-code | string |
tax1 | In addition to the main expense tax, Tax1 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax2 | In addition to the main expense tax, Tax2 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax3 | In addition to the main expense tax, Tax3 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
token | Represents the token for update operations | int32 |
type | Represents the expense types, e.g inventory, non-inventory, etc. | ExpenseTypeEnumerated type: Click to see possible values and their descriptions. |
version | Implements concurrency on this object | byte |
[
{
"code": "6011",
"description": "Expense Description",
"billable": true,
"class": "class",
"classId": "35b45b18-0f4b-4eb2-a890-c8e9a5030190",
"costRate": 1,
"createdById": "67f5a9a9-69c8-4405-b566-010de0c33435",
"createdOn": "2025-09-04T05:19:43Z",
"customFields": [
{
"definitionId": "676bd6c0-b71e-4101-a2c0-42d938df2d22",
"createdById": "820cf422-5bca-4f75-95ab-6341986c2549",
"createdOn": "2025-09-04T05:19:43Z",
"description": "CustomFieldData Description",
"id": "e05f13f5-9d70-4d56-8cc9-2c0e15631704",
"label": "label",
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "2e30166b-62a8-449a-9377-3999525f4a0a",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"defaultGroup": "defaultGroup",
"defaultGroupId": "29cf3e23-9c54-4d1a-849a-9bd518dd4ff2",
"expenseAccount": "expenseAccount",
"expenseAccountId": "b54fc9cf-68b2-4551-934f-638b1d8bdcac",
"id": "1a4eeb70-53b1-4f54-9477-dbcaf42d3233",
"incomeAccount": "incomeAccount",
"incomeAccountId": "8676b6fd-91fb-4de3-95ac-60dd08bca98b",
"isActive": true,
"isProduct": true,
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "d19835d7-3d3f-428a-a850-197e137d2c58",
"markup": 1,
"memo": "memo",
"name": "Expense",
"objectState": null,
"purchaseTaxRate": 1,
"reimbursable": true,
"sub": "sub",
"tax1": 1,
"tax2": 1,
"tax3": 1,
"token": 0,
"type": null,
"version": "U3dhZ2dlciByb2Nrcw=="
}
]
Retrieve an Expense
Use this method to retrieve a specific expense. Pass id as the parameter.
Request URL
Method Overview
HTTP Method:
GET
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
read:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
id | Path | Expense identifier | string |
Response Body
Name | Description | Format |
---|---|---|
code | Represents an expense item code | string |
description | Represents the description of an expense | string |
billable | Indicates whether an expense is billable or not. If true, the expense is billable | boolean |
class | Name of the class | string |
classId | Identifier of the class | uuid |
costRate | The per unit cost of an expense item | double |
createdById | Identifier of the user who created this object | uuid |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
customFields []Array: Parent object can have multiple instances of this nested object under it. | Represents a list of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
defaultGroup | Name of the default group to which an expense item belongs | string |
defaultGroupId | Identifier of the default group to which an expense item belongs | uuid |
expenseAccount | Name of an expense account associated with an expense | string |
expenseAccountId | Identifier of an expense account used to track the expenditure associated with expenses incurred | uuid |
id | Object identifier | uuid |
incomeAccount | Name of an income account associated with an expense | string |
incomeAccountId | Identifier of an income account used to track the income associated with expenses incurred | uuid |
isActive | Indicates the status of an expense item. If true, status is active | boolean |
isProduct | Determines whether this is a product or not | boolean |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
lastUpdatedById | Identifier of the user who last updated this object | uuid |
markup | Percentage increase in the cost rate to determine the cost amount | double |
memo | Records any extra information or details about an expense | string |
name | Name of the expense | string |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
purchaseTaxRate | Tax paid by a company on an expense subtracted from the expense amount to avoid double-taxation for the client | double |
reimbursable | Indicates whether an expense is reimbursable or not. If true, expense is reimbursable | boolean |
sub | Represents an expense item sub-code | string |
tax1 | In addition to the main expense tax, Tax1 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax2 | In addition to the main expense tax, Tax2 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax3 | In addition to the main expense tax, Tax3 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
token | Represents the token for update operations | int32 |
type | Represents the expense types, e.g inventory, non-inventory, etc. | ExpenseTypeEnumerated type: Click to see possible values and their descriptions. |
version | Implements concurrency on this object | byte |
{
"code": "6011",
"description": "Expense Description",
"billable": true,
"class": "class",
"classId": "56e21f6b-de67-4186-9bfc-9fae3fcc249b",
"costRate": 1,
"createdById": "420830ea-334d-4b75-9a7e-8210f4d5e359",
"createdOn": "2025-09-04T05:19:43Z",
"customFields": [
{
"definitionId": "cf847105-3e95-4906-9a73-f93c87765126",
"createdById": "03dc479a-a873-4558-a554-8db484c119db",
"createdOn": "2025-09-04T05:19:43Z",
"description": "CustomFieldData Description",
"id": "921b3f8e-ca83-4210-802c-9a80e6413481",
"label": "label",
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "1e6efa5d-2685-404d-bf0d-69c7865540d9",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"defaultGroup": "defaultGroup",
"defaultGroupId": "2a0e8f74-4581-4ab8-903f-c99949c7f877",
"expenseAccount": "expenseAccount",
"expenseAccountId": "9b046165-112e-4b50-b6bc-4b06d239a9d4",
"id": "bf0a810d-70c1-476c-83f8-486606a99c8c",
"incomeAccount": "incomeAccount",
"incomeAccountId": "6463c3f1-fb05-4a9d-9e93-056ac1014ea8",
"isActive": true,
"isProduct": true,
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "194de5d4-d7ab-41d5-a5e5-e14e68296a97",
"markup": 1,
"memo": "memo",
"name": "Expense",
"objectState": null,
"purchaseTaxRate": 1,
"reimbursable": true,
"sub": "sub",
"tax1": 1,
"tax2": 1,
"tax3": 1,
"token": 0,
"type": null,
"version": "U3dhZ2dlciByb2Nrcw=="
}
Create an Expense
Use this method to save an expense. Pass expense as the parameter.
Request URL
Method Overview
HTTP Method:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
body | Body | Expense object | Expense |
Response Body
Name | Description | Format |
---|---|---|
code | Represents an expense item code | string |
description | Represents the description of an expense | string |
billable | Indicates whether an expense is billable or not. If true, the expense is billable | boolean |
class | Name of the class | string |
classId | Identifier of the class | uuid |
costRate | The per unit cost of an expense item | double |
createdById | Identifier of the user who created this object | uuid |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
customFields []Array: Parent object can have multiple instances of this nested object under it. | Represents a list of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
defaultGroup | Name of the default group to which an expense item belongs | string |
defaultGroupId | Identifier of the default group to which an expense item belongs | uuid |
expenseAccount | Name of an expense account associated with an expense | string |
expenseAccountId | Identifier of an expense account used to track the expenditure associated with expenses incurred | uuid |
id | Object identifier | uuid |
incomeAccount | Name of an income account associated with an expense | string |
incomeAccountId | Identifier of an income account used to track the income associated with expenses incurred | uuid |
isActive | Indicates the status of an expense item. If true, status is active | boolean |
isProduct | Determines whether this is a product or not | boolean |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
lastUpdatedById | Identifier of the user who last updated this object | uuid |
markup | Percentage increase in the cost rate to determine the cost amount | double |
memo | Records any extra information or details about an expense | string |
name | Name of the expense | string |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
purchaseTaxRate | Tax paid by a company on an expense subtracted from the expense amount to avoid double-taxation for the client | double |
reimbursable | Indicates whether an expense is reimbursable or not. If true, expense is reimbursable | boolean |
sub | Represents an expense item sub-code | string |
tax1 | In addition to the main expense tax, Tax1 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax2 | In addition to the main expense tax, Tax2 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax3 | In addition to the main expense tax, Tax3 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
token | Represents the token for update operations | int32 |
type | Represents the expense types, e.g inventory, non-inventory, etc. | ExpenseTypeEnumerated type: Click to see possible values and their descriptions. |
version | Implements concurrency on this object | byte |
{
"code": "6011",
"description": "Expense Description",
"billable": true,
"class": "class",
"classId": "be7a4a04-50ec-4f96-9f81-c53c15ee8596",
"costRate": 1,
"createdById": "3d550300-0e9b-494a-a7d2-f57b9fb6037f",
"createdOn": "2025-09-04T05:19:43Z",
"customFields": [
{
"definitionId": "db2b3018-6cf4-4ce9-b7a2-23371d256d26",
"createdById": "d85afd32-675f-4fd1-91ae-07d84ddf06f0",
"createdOn": "2025-09-04T05:19:43Z",
"description": "CustomFieldData Description",
"id": "3510eb15-4ce5-42fa-8d0a-f77efd31356e",
"label": "label",
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "aed29460-1876-4828-a289-e4ea34626a8e",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"defaultGroup": "defaultGroup",
"defaultGroupId": "7c24e1cc-443d-4dbe-af12-aa445af12baf",
"expenseAccount": "expenseAccount",
"expenseAccountId": "7c16f094-efa7-4700-978d-0650fc532cd3",
"id": "5e3e1072-e848-49f3-8dd0-2029857183a1",
"incomeAccount": "incomeAccount",
"incomeAccountId": "e22ef49f-59af-4997-839a-04c82dfaa4de",
"isActive": true,
"isProduct": true,
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "771ec112-1eab-4f74-983f-440dbeaa0a5c",
"markup": 1,
"memo": "memo",
"name": "Expense",
"objectState": null,
"purchaseTaxRate": 1,
"reimbursable": true,
"sub": "sub",
"tax1": 1,
"tax2": 1,
"tax3": 1,
"token": 0,
"type": null,
"version": "U3dhZ2dlciByb2Nrcw=="
}
Create an Expense List
Use this method to save multiple expense. Pass model as the parameter.
As saving multiple records in a batch takes time, this endpoint returns a Job object that shows the progress of the batch operation. To check the status of the operation at any time, use the job endpoint.
Request URL
Method Overview
HTTP Method:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
body | Body | Expense object | ExpenseBatchRequest |
Response Body
Name | Description | Format |
---|---|---|
batchSize | Represents the number of entities in a batch | int64 |
createdById | Identifier of the user who created this object | uuid |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
id | Object identifier | uuid |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
lastUpdatedById | Identifier of the user who last updated this object | uuid |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
progress | Represents the total number of entities processed | int64 |
status | Represents the status of a job e.g., ready, running, completed, or terminated | string |
token | Represents the token for update operations | int32 |
type | Represents the type of a job e.g., create, update, or delete | string |
version | Implements concurrency on this object | byte |
{
"batchSize": 0,
"createdById": "d0f49200-f46d-427f-9ddf-30be636a2706",
"createdOn": "2025-09-04T05:19:43Z",
"id": "6ab70923-3b9b-4ce2-bb22-970b53e3a7a1",
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "6b24021d-57eb-4306-b337-3778110f211b",
"objectState": null,
"progress": 0,
"status": "status",
"token": 0,
"type": "type",
"version": "U3dhZ2dlciByb2Nrcw=="
}
Update an Expense
Use this method to update an expense. Pass id and expense as the parameters.
Request URL
Method Overview
HTTP Method:
PUT
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
id | Path | Expense identifier | string |
body | Body | Expense object | Expense |
Response Body
Name | Description | Format |
---|---|---|
code | Represents an expense item code | string |
description | Represents the description of an expense | string |
billable | Indicates whether an expense is billable or not. If true, the expense is billable | boolean |
class | Name of the class | string |
classId | Identifier of the class | uuid |
costRate | The per unit cost of an expense item | double |
createdById | Identifier of the user who created this object | uuid |
createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
customFields []Array: Parent object can have multiple instances of this nested object under it. | Represents a list of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
defaultGroup | Name of the default group to which an expense item belongs | string |
defaultGroupId | Identifier of the default group to which an expense item belongs | uuid |
expenseAccount | Name of an expense account associated with an expense | string |
expenseAccountId | Identifier of an expense account used to track the expenditure associated with expenses incurred | uuid |
id | Object identifier | uuid |
incomeAccount | Name of an income account associated with an expense | string |
incomeAccountId | Identifier of an income account used to track the income associated with expenses incurred | uuid |
isActive | Indicates the status of an expense item. If true, status is active | boolean |
isProduct | Determines whether this is a product or not | boolean |
lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
lastUpdatedById | Identifier of the user who last updated this object | uuid |
markup | Percentage increase in the cost rate to determine the cost amount | double |
memo | Records any extra information or details about an expense | string |
name | Name of the expense | string |
objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
purchaseTaxRate | Tax paid by a company on an expense subtracted from the expense amount to avoid double-taxation for the client | double |
reimbursable | Indicates whether an expense is reimbursable or not. If true, expense is reimbursable | boolean |
sub | Represents an expense item sub-code | string |
tax1 | In addition to the main expense tax, Tax1 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax2 | In addition to the main expense tax, Tax2 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
tax3 | In addition to the main expense tax, Tax3 rate is applied to an invoice. These taxes (Tax1,Tax2,Tax3) are combined to calculate the charge amount | double |
token | Represents the token for update operations | int32 |
type | Represents the expense types, e.g inventory, non-inventory, etc. | ExpenseTypeEnumerated type: Click to see possible values and their descriptions. |
version | Implements concurrency on this object | byte |
{
"code": "6011",
"description": "Expense Description",
"billable": true,
"class": "class",
"classId": "4e2493a2-ce4b-4d63-8a86-4107362d9776",
"costRate": 1,
"createdById": "9256c50c-9e5c-490e-9c6d-77e423752800",
"createdOn": "2025-09-04T05:19:43Z",
"customFields": [
{
"definitionId": "f4beec0e-bd63-4ced-a2de-d446fc049dce",
"createdById": "96405856-2638-4fd9-a19b-f5cc0127868e",
"createdOn": "2025-09-04T05:19:43Z",
"description": "CustomFieldData Description",
"id": "f6ab79f4-bc32-4fd9-a190-ba13cb68d771",
"label": "label",
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "6a325c19-cbad-4680-9374-5d8e9b5c61e6",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"defaultGroup": "defaultGroup",
"defaultGroupId": "51575fdb-779d-4801-bfa1-c5c80dc88726",
"expenseAccount": "expenseAccount",
"expenseAccountId": "2cfc1cd3-ced6-4f3e-8520-af1ed1f28ba5",
"id": "d6182b59-5cd6-4dd0-885b-14e358c6de58",
"incomeAccount": "incomeAccount",
"incomeAccountId": "fc549cc7-eac2-426e-84a0-572d2b33744d",
"isActive": true,
"isProduct": true,
"lastUpdated": "2025-09-04T05:19:43Z",
"lastUpdatedById": "813d40f8-bef7-4a12-b8c8-0e34a4e970e3",
"markup": 1,
"memo": "memo",
"name": "Expense",
"objectState": null,
"purchaseTaxRate": 1,
"reimbursable": true,
"sub": "sub",
"tax1": 1,
"tax2": 1,
"tax3": 1,
"token": 0,
"type": null,
"version": "U3dhZ2dlciByb2Nrcw=="
}
Delete an Expense
Use this method to delete an expense. Pass id as the parameter.
Request URL
Method Overview
HTTP Method:
DELETE
Content Type:
application/json
Response Format:
N/A
Requires Authentication?
Yes
Headers:
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
id | Path | Expense identifier | string |
Patch an Expense
Use this method to perform partial modifications to an expense. Pass id and patch document as parameters.
Request URL
Method Overview
HTTP Method:
PATCH
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Expense
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
Name | Parameter Type | Description | Format |
---|---|---|---|
id | Path | Expense identifier | string |
body | Body | A document containing an array of objects with each object representing a single operation | ExpensePatchDocument |
Response Body
Name | Description | Format |
---|