Expenses - Bulk

Bulk expense operations allow creating or updating multiple expense records in a single request — useful for high-volume import workflows where individual API calls would be impractical.

Bulk operations follow the same validation rules as single-record endpoints.

Attributes

allocation_status string
Response Parameter `filter` Enum

Whether this expense has been allocated to a service, or is unallocated (when the expense-without-service feature is enabled).

Enum Values (2 values)

  • 1
  • 2
amount integer
Response Request Parameter `filter` Parameter `sort`

Unit cost of the expense in the expense currency.

amount_default object
Response

Unit cost of the expense in the organization default currency.

amount_normalized object
Response

Unit cost of the expense in the budget currency.

amount_with_tax object
Response Parameter `filter` Parameter `sort`

Unit amount including tax in the expense currency.

amount_with_tax_default object
Response

Unit amount including tax in the organization default currency.

amount_with_tax_normalized object
Response

Unit amount including tax in the budget currency.

approval_status integer
Parameter `filter` Enum

Overall approval status across all approvers.

Enum Values (4 values)

  • 1
  • 2
  • 3
  • 4
approval_statuses array of approval status
Response

Per-approver decisions on this expense.

approved object
Response

Whether this expense has been approved.

approved_at string
Response Parameter `filter`

Date when the expense was approved.

approver person
Response

The person who approved this expense.

approver_id integer
Parameter `filter`

ID of the person who approved this expense.

assigned_approver_id integer
Parameter `filter`

ID of the person assigned as approver for this expense.

attachment attachment
Response

Receipt or document attached to this expense.

attachment_id integer
Request

ID of the receipt or document attached to this expense.

awaiting_approval_from_approver_id integer
Parameter `filter`

ID of the approver this expense is currently awaiting approval from.

billable_amount integer
Response Request Parameter `filter` Parameter `sort`

Amount to be billed to the client in the expense currency.

billable_amount_default object
Response

Amount to be billed to the client in the organization default currency.

billable_amount_normalized object
Response

Amount to be billed to the client in the budget currency.

company_id integer
Parameter `filter`

ID of the client company associated with the budget of this expense.

company_reference_id integer
Response

Company reference ID in the external accounting system.

created_at string
Response Parameter `filter` Parameter `sort`

Date when the expense was created in the system.

creator person
Response

The person who created this expense record.

creator_id integer
Parameter `filter`

ID of the person who created this expense record.

currency string
Response Request Parameter `filter`

Currency code of the expense.

currency_default object
Response

Organization default currency code.

currency_normalized object
Response

Budget currency code.

custom_field_attachments array of attachment
Response

Files in file-type custom fields.

custom_field_people array of person
Response

People in person-type custom fields.

custom_fields object
Response Request Parameter `filter` Parameter `sort`

Custom field values.

date string
Response Request Parameter `filter` Parameter `sort`

Date when the expense was incurred.

date_after string
Parameter `filter`

Earliest date (exclusive) for querying expenses by date.

date_before string
Parameter `filter`

Latest date (exclusive) for querying expenses by date.

deal deal
Response

The budget or deal this expense is charged to.

deal_company_name object
Parameter `sort`

Name of the client company associated with the expense's budget.

deal_id integer
Parameter `filter`

ID of the budget or deal this expense is charged to.

deal_name object
Parameter `sort`

Name of the budget this expense is charged to.

deal_project_name object
Parameter `sort`

Name of the project associated with the expense's budget.

deleted_at string
Response

Soft-deletion timestamp.

designated_approver_id integer
Parameter `filter`

ID of the person designated as the approver for this expense's budget.

draft boolean
Response Parameter `filter` Parameter `sort`

Whether this expense is still in draft status on the purchase order.

exchange_date string
Response

Date used for exchange rate calculation.

exchange_rate number
Response

Exchange rate from expense currency to organization default currency.

exchange_rate_normalized number
Response

Exchange rate from expense currency to budget currency.

expense_line_items array of expense line item
Response

Individual line items if the expense has multiple items.

exported object
Response

Whether the expense has been exported to external accounting software.

exported_at string
Response

Timestamp when the expense was exported.

export_id string
Response

ID in the external accounting system.

export_integration_type_id integer
Response Enum

Type of accounting integration used for export.

Enum Values (11 values)

  • 1
    CPP
  • 2
    Quickbooks
  • 3
    Xero
  • 4
    Exact
  • 5
    Economic
  • 6
    Fortnox
  • 7
    Custom
  • 8
    Twinfield
  • 9
    Sage Accounting
  • 10
    Sage Intacct
  • 11
    Netsuite
export_status integer
Parameter `filter` Enum

Export status in the external accounting system.

Enum Values (2 values)

  • 1
  • 2
export_url string
Response

URL to view this expense in the external accounting system.

external_payment_id string
Response

Payment ID in external payment system.

full_query string
Parameter `filter`

Full-text search query matching across expense fields.

fuzzy_dates string
Parameter `filter`

Fuzzy date range filter for querying expenses.

fuzzy_people integer
Parameter `filter`

Fuzzy people filter for querying expenses.

id integer
Parameter `filter` Parameter `sort`

Unique identifier of the expense.

invoice_attribution invoice attribution
Response

The invoice attribution linking this expense to an invoice.

invoiced boolean
Response Parameter `filter`

Whether this expense has been invoiced to the client.

invoice_id integer
Parameter `filter`

ID of the invoice this expense is attributed to.

invoicing_status integer
Parameter `filter` Enum

Invoicing status of this expense.

Enum Values (3 values)

  • 1
  • 2
  • 3
jump_query string
Parameter `filter`

Jump/quick search query for this expense.

line_items_count integer
Response

Number of the expense line items on this expense.

markup number
Response Request

The markup percentage applied on top of the expense cost when billing to the client.

name string
Response Request Parameter `filter` Parameter `sort`

What the expense was for (travel, software, external costs, etc.).

organization organization
Response

The organization this expense belongs to.

paid_on string
Response Request Parameter `filter` Parameter `sort`

Date when the expense was actually paid.

paid_on_after string
Parameter `filter`

Earliest date (exclusive) for querying expenses by paid_on.

paid_on_before string
Parameter `filter`

Latest date (exclusive) for querying expenses by paid_on.

pay_on string
Response Request Parameter `filter` Parameter `sort`

Due date for payment.

pay_on_after string
Parameter `filter`

Earliest date (exclusive) for querying expenses by pay_on.

pay_on_before string
Parameter `filter`

Latest date (exclusive) for querying expenses by pay_on.

person person
Response

The person the expense was incurred for.

person_id integer
Request Parameter `filter`

ID of the person the expense was incurred for.

position integer
Response Request

Position of this expense.

profit object
Response Parameter `filter` Parameter `sort`

Difference between billable amount and total cost in the expense currency.

profit_default object
Response

Difference between billable amount and total cost in the organization default currency.

profit_normalized object
Response

Difference between billable amount and total cost in the budget currency.

project_id integer
Parameter `filter`

ID of the project associated with the expense's budget.

purchase_order purchase order
Response

The purchase order this expense belongs to, if any.

purchase_order_id integer
Request Parameter `filter`

ID of the purchase order this expense belongs to.

quantity number
Response Request Parameter `filter`

Number of units on the expense.

quantity_received number
Response

Number of units received (for purchase order expenses).

query string
Parameter `filter`

Text search query matching expense names and descriptions.

quote_type object
Parameter `filter`

Quote type identifier for this expense.

recognized_revenue object
Response Parameter `filter` Parameter `sort`

Expected revenue based on the service's billing type in the expense currency.

recognized_revenue_default object
Response

Expected revenue based on the service's billing type in the organization default currency.

recognized_revenue_normalized object
Response

Expected revenue based on the service's billing type in the budget currency.

reimbursable boolean
Response Request Parameter `filter`

Whether this expense is eligible for reimbursement to the person.

reimbursed_on string
Response Request Parameter `filter`

Date when the expense was reimbursed.

reimbursement integer
Parameter `filter` Enum

Reimbursement details for this expense.

Enum Values (3 values)

  • 1
  • 2
  • 3
rejected object
Response

Whether this expense was rejected during approval.

rejected_at string
Response

Timestamp when the expense was rejected.

rejected_reason string
Response Request

Reason why the expense was rejected.

rejecter person
Response

The person who rejected this expense.

responsible_id integer
Parameter `filter`

ID of the person responsible for this expense.

section_name string
Parameter `filter`

Name of the section within the budget where the expense's service is grouped.

service service
Response

The budget service this expense is allocated to.

service_id integer
Request Parameter `filter`

ID of the budget service this expense is allocated to.

service_name object
Parameter `sort`

Name of the budget service this expense is allocated to.

service_type service type
Response

The work category for this expense.

service_type_id integer
Parameter `filter`

ID of the work category for this expense.

service_type_name object
Parameter `sort`

Name of the work category for this expense.

stage_type integer
Parameter `filter` Enum

Stage type of the budget this expense belongs to.

Enum Values (2 values)

  • 1
  • 2
status integer
Parameter `filter` Enum

Approval status of this expense.

Enum Values (2 values)

  • 1
  • 2
tax_inclusion boolean
Response Request

Whether the amount includes tax or is tax-exclusive.

tax_rate tax rate
Response

The tax rate applied to this expense.

tax_rate_id integer
Request Parameter `filter` Parameter `sort`

ID of the tax rate applied to this expense.

total_amount object
Response

Total cost (quantity × unit amount) before tax in the expense currency.

total_amount_default object
Response

Total cost (quantity × unit amount) before tax in the organization default currency.

total_amount_normalized object
Response

Total cost (quantity × unit amount) before tax in the budget currency.

total_amount_with_tax object
Response

Total amount including tax in the expense currency.

total_amount_with_tax_default object
Response

Total amount including tax in the organization default currency.

total_amount_with_tax_normalized object
Response

Total amount including tax in the budget currency.

vendor company
Response

The vendor company this expense was paid to.

vendor_id integer
Request Parameter `filter`

ID of the vendor company this expense was paid to.

with_draft boolean
Parameter `filter`

Whether to include draft expenses in results.