Employee expense adjustments

Expense adjustments provide a way to correct the balance for an employee who is overpaid or underpaid for an expense.

List employee expense adjustments

get/objects/expenses/employee-expense-adjustment

Returns a collection with a key, ID, and link for each employee expense adjustment.

Permissions and other requirements
SubscriptionTime & Expenses
User typeBusiness
PermissionsList, View Expense Adjustments
SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "84",
      • "id": "EXP-00001",
      • "href": "/objects/expenses/employee-expense-adjustment/84"
      },
    • {
      • "key": "85",
      • "id": "EXP-00002",
      • "href": "/objects/expenses/employee-expense-adjustment/85"
      },
    • {
      • "key": "60",
      • "id": "EXP-00003",
      • "href": "/objects/expenses/employee-expense-adjustment/60"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 5,
    • "next": 0,
    • "previous": 0
    }
}
Create an employee expense adjustment
post/objects/expenses/employee-expense-adjustment
Creates a new employee expense adjustment.


You must specify a unique employee expense ID when creating an employee expense unless document sequencing is configured, in which case the ID is auto-generated.



Permissions and other requirements



SubscriptionTime & Expenses


User typeBusiness


PermissionsList, View, Add Expense Adjustments







SecurityOAuth2 
Request 
Request Body schema: application/json
required
Creates an employee expense adjustment


adjustmentType
string
 Default:  "debit"
Adjustment type. Options are credit (increases the amount due to the employee) or debit (decreases the amount due to the employee).


 Enum: "credit" "debit"  
 Example:  "debit"
object
The expense report to which the adjustment applies.


 
key
string
Unique key for the referenced employee expense.


 
 Example:  "2534"
id
string
Unique identifier for the referenced employee expense.


 
 Example:  "124"
description
string
Description of the employee expense adjustment.


 
 Example:  "Corrects underpayment of mileage for conference travel."
createdDate
string <date> 
Creation date of the employee expense adjustment.


 
 Example:  "2025-01-23"
object
Employee that incurred the expense adjustment.


 
key
string
Unique key for the employee.


 
 Example:  "482"
id
string
Unique identifier for the employee.


 
 Example:  "EMP-025"
state
string
 Default:  "submitted"
Status of the employee expense adjustment. Expense adjustments are posted to the general ledger when approved.


 Enum: "approved" "declined" "draft" "paid" "partiallyApproved" "partiallyDeclined" "partiallyPaid" "resubmitted" "selected" "submitted"  
 Example:  "draft"
object
Base payment details for the employee expense adjustment report.


 
baseCurrency
string
Base currency used for the employee expense adjustment report. The currency is determined by the company's default currency for reporting.


 
 Example:  "USD"
object
Reimbursement details for the employee expense adjustment.


 
reimbursementCurrency
string
For companies that use multiple transaction currencies, the currency used to pay for the reimbursement.


 
 Example:  "EUR"
expenseAdjustmentReportNumber
string
Adjustment report number associated with the employee expense adjustment. This field is auto-populated if Time & Expense is configured to auto-number credit and debit adjustments using Company Document sequences.


 
 Example:  "EXP-00001"
object
Expense summary that this expense is reported on.


 
key
string
Unique key for the employee expense summary.


 
 Example:  "334"
id
string
Unique identifier for the expense summary.


 
 Example:  "334"
postingDate
string <date> 
The general ledger posting date for the employee expense summary.


 
 Example:  "2025-01-23"
object
Non-reimbursable amount of the employee expense adjustment.


 
memo
string
Memo about the employee expense adjustment.


 
 Example:  "Paid by employee."
reclassificationNotes
string
Reason for the reclassification.


 
 Example:  "Classified as supplies, not travel expense adjustment"
object
An attachment for employee expense adjustment. Can include scanned or digital receipts.


 
key
string
Unique key for the attachment.


 
 Example:  "152"
id
string
Unique identifier of the attachment.


 
 Example:  "1"
Array of objects
Line items of the employee expense adjustment.


 
 Array 
entryDate
string <date> 
Date the adjustment item is filed.


 
 Example:  "2025-01-23"
txnCurrency
string
In multi-currency companies, the currency used for the transaction.


 
 Example:  "INR"
txnAmount
string or null <decimal-precision-2> 
Transaction amount.


 
 Example:  "123.45"
quantity
string <decimal-precision-2> 
Quantity for a rate-based expense adjustment, such as mileage.


 
 Example:  "5.75"
unitRate
string <decimal-precision-6> 
Monetary amount for a rate-based expense adjustment, such as mileage.


 
 Example:  "20.000000"
paidTo
string
Notes regarding to whom the amount was paid.


 
 Example:  "Hotel Westin"
object
General ledger account associated with the line item. Used when no expense adjustment type is assigned.


 
object
An expense type defined in the company.


 
object
Details of reimbursement currency to base currency conversion.


 
object
Details of the conversion to base currency.


 
isBillable
boolean
 Default:  false
Indicates whether a line item is billable.


 
 Example:  false
object
 
object
 
object
 
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "state": "submitted",
  • "expenseAdjustmentReportNumber": "EXP-00001",
  • "employee": {
    • "id": "10"
    },
  • "createdDate": "2025-03-11",
  • "expenseSummary": {
    • "postingDate": "2025-01-31",
    • "title": "Expenses - Q1 batch",
    • "state": "open",
    • "preventGLPosting": false
    },
  • "basePayment": {
    • "baseCurrency": "USD"
    },
  • "reimbursement": {
    • "reimbursementCurrency": "EUR"
    },
  • "description": "Travel expense",
  • "memo": "Paid by employee.",
  • "lines": [
    • {
      • "paidTo": "De Anza Hotel",
      • "paidFor": "Not used",
      • "isBillable": false,
      • "form1099": {
        },
      • "paymentType": {
        },
      • "quantity": "1",
      • "unitRate": "20",
      • "txnCurrency": "INR",
      • "txnAmount": "100",
      • "transactionToReimburseConversion": {
        },
      • "dimensions": {
        }
      }
    ]
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "124",
    • "id": "124",
    • "href": "/objects/expenses/employee-expense-adjustment/124"
    },
  • "ia::meta": {
    • "totalCount": 1
    }
}
Get an employee expense adjustment
get/objects/expenses/employee-expense-adjustment/{key}
Returns detailed information for a specified employee expense adjustment.



Permissions and other requirements



SubscriptionTime & Expenses


User typeBusiness


PermissionsList, View Expense Adjustments







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the employee-expense-adjustment.


 
 Example:  99
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "expenseAdjustmentReportNumber": "ER-0152",
    • "employee": {
      • "id": "10",
      • "key": "10",
      • "href": "/objects/company-config/employee/10"
      },
    • "employeeContact": {
      • "key": "977",
      • "id": "Thomas Glenn",
      • "firstName": "Thomas",
      • "lastName": "Glenn",
      • "href": "/objects/company-config/contact/977"
      },
    • "key": "124",
    • "id": "124",
    • "createdDate": "2025-03-11",
    • "expenseSummary": {
      • "postingDate": "2025-01-31",
      • "title": "Expenses - Q1 batch",
      • "key": "3",
      • "id": "3",
      • "href": "/objects/expenses/employee-expense-summary/3"
      },
    • "basePaymentInformation": {
      • "totalEntered": "1.38",
      • "totalPaid": "0",
      • "totalSelected": "0",
      • "totalDue": "1.38",
      • "baseCurrency": "USD"
      },
    • "state": "approved",
    • "reimbursementInformation": {
      • "totalEntered": "1.16",
      • "totalSelected": "0",
      • "totalPaid": "0",
      • "totalDue": "1.16",
      • "reimbursementCurrency": "EUR"
      },
    • "description": "Supplies for customer training",
    • "nonReimbursable": {
      • "baseTotalEntered": "0",
      • "reimbursementTotalEntered": "0"
      },
    • "lines": [
      • {
        }
      ],
    • "memo": "Covered by customer",
    • "entity": {
      • "key": "46",
      • "id": "Western Region",
      • "name": "Western Region",
      • "href": "/objects/company-config/entity/46"
      },
    • "adjustmentType": "debit",
    • "referenceEmployeeExpense": {
      • "id": "124",
      • "key": "124",
      • "href": "/objects/expenses/employee-expense/124"
      },
    • "href": "/objects/expenses/employee-expense-adjustment/124"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update an employee expense adjustment
patch/objects/expenses/employee-expense-adjustment/{key}
Updates an existing employee expense adjustment by setting field values. Any fields not provided remain unchanged.



Permissions and other requirements



SubscriptionTime & Expenses


User typeBusiness


PermissionsList, View, Edit Expense Adjustments







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the employee-expense-adjustment.


 
 Example:  99
Request Body schema: application/json
adjustmentType
string
 Default:  "debit"
Adjustment type. Options are credit (increases the amount due to the employee) or debit (decreases the amount due to the employee).


 Enum: "credit" "debit"  
 Example:  "debit"
object
The expense report to which the adjustment applies.


 
key
string
Unique key for the referenced employee expense.


 
 Example:  "2534"
id
string
Unique identifier for the referenced employee expense.


 
 Example:  "124"
description
string
Description of the employee expense adjustment.


 
 Example:  "Corrects underpayment of mileage for conference travel."
createdDate
string <date> 
Creation date of the employee expense adjustment.


 
 Example:  "2025-01-23"
object
Employee that incurred the expense adjustment.


 
key
string
Unique key for the employee.


 
 Example:  "482"
id
string
Unique identifier for the employee.


 
 Example:  "EMP-025"
state
string
 Default:  "submitted"
Status of the employee expense adjustment. Expense adjustments are posted to the general ledger when approved.


 Enum: "approved" "declined" "draft" "paid" "partiallyApproved" "partiallyDeclined" "partiallyPaid" "resubmitted" "selected" "submitted"  
 Example:  "draft"
object
Base payment details for the employee expense adjustment report.


 
baseCurrency
string
Base currency used for the employee expense adjustment report. The currency is determined by the company's default currency for reporting.


 
 Example:  "USD"
object
Reimbursement details for the employee expense adjustment.


 
reimbursementCurrency
string
For companies that use multiple transaction currencies, the currency used to pay for the reimbursement.


 
 Example:  "EUR"
expenseAdjustmentReportNumber
string
Adjustment report number associated with the employee expense adjustment. This field is auto-populated if Time & Expense is configured to auto-number credit and debit adjustments using Company Document sequences.


 
 Example:  "EXP-00001"
object
Expense summary that this expense is reported on.


 
key
string
Unique key for the employee expense summary.


 
 Example:  "334"
id
string
Unique identifier for the expense summary.


 
 Example:  "334"
postingDate
string <date> 
The general ledger posting date for the employee expense summary.


 
 Example:  "2025-01-23"
object
Non-reimbursable amount of the employee expense adjustment.


 
memo
string
Memo about the employee expense adjustment.


 
 Example:  "Paid by employee."
reclassificationNotes
string
Reason for the reclassification.


 
 Example:  "Classified as supplies, not travel expense adjustment"
object
An attachment for employee expense adjustment. Can include scanned or digital receipts.


 
key
string
Unique key for the attachment.


 
 Example:  "152"
id
string
Unique identifier of the attachment.


 
 Example:  "1"
Array of objects
Line items of the employee expense adjustment.


 
 Array 
entryDate
string <date> 
Date the adjustment item is filed.


 
 Example:  "2025-01-23"
txnCurrency
string
In multi-currency companies, the currency used for the transaction.


 
 Example:  "INR"
txnAmount
string or null <decimal-precision-2> 
Transaction amount.


 
 Example:  "123.45"
quantity
string <decimal-precision-2> 
Quantity for a rate-based expense adjustment, such as mileage.


 
 Example:  "5.75"
unitRate
string <decimal-precision-6> 
Monetary amount for a rate-based expense adjustment, such as mileage.


 
 Example:  "20.000000"
paidTo
string
Notes regarding to whom the amount was paid.


 
 Example:  "Hotel Westin"
object
General ledger account associated with the line item. Used when no expense adjustment type is assigned.


 
object
An expense type defined in the company.


 
object
Details of reimbursement currency to base currency conversion.


 
object
Details of the conversion to base currency.


 
isBillable
boolean
 Default:  false
Indicates whether a line item is billable.


 
 Example:  false
object
 
object
 
object
 
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "memo": "Covered by customer"
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "124",
    • "id": "124",
    • "href": "/objects/expenses/employee-expense-adjustment/124"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete an employee expense adjustment
delete/objects/expenses/employee-expense-adjustment/{key}
Deletes an employee expense adjustment.



Permissions and other requirements



SubscriptionTime & Expenses


User typeBusiness


PermissionsList, View, Delete Expense Adjustments







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the employee-expense-adjustment.


 
 Example:  99
Responses 
204
No Content


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}
Query employee expense adjustments
post/services/core/query
Use the query service to find employee expense adjustments that meet certain criteria and to specify the properties that are returned.


SecurityOAuth2 
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}