Expenses

Create a logged expense

Creates a new logged expense against a job.

post/logged_expenses

Request

Base URL: https://api.streamtime.net/v2
URL: https://api.streamtime.net/v2/logged_expenses
Auth: HTTP bearer

Request body

Example request

{
  "loggedExpense": {
    "id": 12345,
    "userId": 789,
    "jobPhaseId": 789,
    "purchaseOrderId": 456,
    "type": "Expense",
    "loggedExpenseStatus": "Approved",
    "loggedExpenseStatusId": 2,
    "date": "2025-08-15",
    "requiredDate": "2025-09-01",
    "purchaseOrderNumber": "PO-001234",
    "jobId": 1010,
    "itemPricingMethodId": 3,
    "supplierCompanyId": 555,
    "supplierContactId": 987,
    "itemName": "Concrete mix M20",
    "description": "Urgent delivery before noon",
    "reference": "REF-ABC-123",
    "costRate": 120.5,
    "sellRate": 150,
    "quantity": 2,
    "currencyCode": "USD",
    "currencySymbol": "$",
    "exchangeRate": 1,
    "loggedExpenseCurrencyTotalCost": 241,
    "loggedExpenseCurrencyAmountPaidIncTax": 200,
    "loggedExpenseCurrencyBalance": 41,
    "markup": 24.5,
    "margin": 14.2,
    "jobCurrencyTotalCost": 230,
    "jobCurrencyTotalExTax": 200,
    "jobCurrencyTotalAmountInvoicedExTax": 180,
    "jobCurrencyTotalDraftInvoicesExTax": 120,
    "jobCurrencyTotalAwaitingPaymentInvoicesExTax": 180,
    "jobCurrencyTotalPaidInvoicesExTax": 200,
    "jobCurrencyTotalIssuedInvoicesExTax": 380,
    "externalId": "ext-9f3a2b"
  }
}

Response

Logged expense created.

idinteger

userIdinteger

jobPhaseIdinteger

purchaseOrderIdinteger nullable

type'Purchase Order' | 'Expense'

loggedExpenseStatusstring

loggedExpenseStatusIdinteger

datestring date

requiredDatestring date nullable

purchaseOrderNumberstring nullable

jobIdinteger

itemPricingMethodIdinteger

supplierCompanyIdinteger nullable

supplierContactIdinteger nullable

itemNamestring

descriptionstring nullable

referencestring nullable

costRatenumber float nullable

sellRatenumber float nullable

quantitynumber float nullable

currencyCodestring nullable

currencySymbolstring

exchangeRatenumber float

loggedExpenseCurrencyTotalCostnumber float nullable

loggedExpenseCurrencyAmountPaidIncTaxnumber float nullable

loggedExpenseCurrencyBalancenumber float nullable

markupnumber float nullable

Markup percentage (0-100)

marginnumber float nullable

Margin percentage (0-100)

jobCurrencyTotalCostnumber float nullable

jobCurrencyTotalExTaxnumber float nullable

jobCurrencyTotalAmountInvoicedExTaxnumber float nullable

jobCurrencyTotalDraftInvoicesExTaxnumber float nullable

Total invoiced on draft invoices ex tax (job currency)

jobCurrencyTotalAwaitingPaymentInvoicesExTaxnumber float nullable

Total invoiced on invoices awaiting payment ex tax (job currency)

jobCurrencyTotalPaidInvoicesExTaxnumber float nullable

Total invoiced on paid invoices ex tax (job currency)

jobCurrencyTotalIssuedInvoicesExTaxnumber float nullable

Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)

externalIdstring nullable

externalCopyDatetimestring date-time nullable

Example response

{
  "id": 12345,
  "userId": 789,
  "jobPhaseId": 789,
  "purchaseOrderId": 456,
  "type": "Expense",
  "loggedExpenseStatus": "Approved",
  "loggedExpenseStatusId": 2,
  "date": "2025-08-15",
  "requiredDate": "2025-09-01",
  "purchaseOrderNumber": "PO-001234",
  "jobId": 1010,
  "itemPricingMethodId": 3,
  "supplierCompanyId": 555,
  "supplierContactId": 987,
  "itemName": "Concrete mix M20",
  "description": "Urgent delivery before noon",
  "reference": "REF-ABC-123",
  "costRate": 120.5,
  "sellRate": 150,
  "quantity": 2,
  "currencyCode": "USD",
  "currencySymbol": "$",
  "exchangeRate": 1,
  "loggedExpenseCurrencyTotalCost": 241,
  "loggedExpenseCurrencyAmountPaidIncTax": 200,
  "loggedExpenseCurrencyBalance": 41,
  "markup": 24.5,
  "margin": 14.2,
  "jobCurrencyTotalCost": 230,
  "jobCurrencyTotalExTax": 200,
  "jobCurrencyTotalAmountInvoicedExTax": 180,
  "jobCurrencyTotalDraftInvoicesExTax": 120,
  "jobCurrencyTotalAwaitingPaymentInvoicesExTax": 180,
  "jobCurrencyTotalPaidInvoicesExTax": 200,
  "jobCurrencyTotalIssuedInvoicesExTax": 380,
  "externalId": "ext-9f3a2b"
}

Changes

No recorded changes to this operation across all 1 revision of this API.