---
title: "Create a logged expense"
method: POST
path: "/logged_expenses"
tags: ["Expenses"]
---

# Create a logged expense

`POST /logged_expenses`

## Request

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

Creates a new logged expense against a job.

## Request body

- object
  - `loggedExpense` LoggedExpense: Represents a logged expense or purchase order entry
    - `id` integer
    - `userId` integer
    - `jobPhaseId` integer
    - `purchaseOrderId` integer, nullable
    - `type` 'Purchase Order' | 'Expense'
    - `loggedExpenseStatus` string
    - `loggedExpenseStatusId` integer
    - `date` string, date
    - `requiredDate` string, date, nullable
    - `purchaseOrderNumber` string, nullable
    - `jobId` integer
    - `itemPricingMethodId` integer
    - `supplierCompanyId` integer, nullable
    - `supplierContactId` integer, nullable
    - `itemName` string
    - `description` string, nullable
    - `reference` string, nullable
    - `costRate` number, float, nullable
    - `sellRate` number, float, nullable
    - `quantity` number, float, nullable
    - `currencyCode` string, nullable
    - `currencySymbol` string
    - `exchangeRate` number, float
    - `loggedExpenseCurrencyTotalCost` number, float, nullable
    - `loggedExpenseCurrencyAmountPaidIncTax` number, float, nullable
    - `loggedExpenseCurrencyBalance` number, float, nullable
    - `markup` number, float, nullable: Markup percentage (0-100)
    - `margin` number, float, nullable: Margin percentage (0-100)
    - `jobCurrencyTotalCost` number, float, nullable
    - `jobCurrencyTotalExTax` number, float, nullable
    - `jobCurrencyTotalAmountInvoicedExTax` number, float, nullable
    - `jobCurrencyTotalDraftInvoicesExTax` number, float, nullable: Total invoiced on draft invoices ex tax (job currency)
    - `jobCurrencyTotalAwaitingPaymentInvoicesExTax` number, float, nullable: Total invoiced on invoices awaiting payment ex tax (job currency)
    - `jobCurrencyTotalPaidInvoicesExTax` number, float, nullable: Total invoiced on paid invoices ex tax (job currency)
    - `jobCurrencyTotalIssuedInvoicesExTax` number, float, nullable: Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)
    - `externalId` string, nullable
    - `externalCopyDatetime` string, date-time, nullable

## Response `200`

Logged expense created.

- LoggedExpense: Represents a logged expense or purchase order entry
  - `id` integer
  - `userId` integer
  - `jobPhaseId` integer
  - `purchaseOrderId` integer, nullable
  - `type` 'Purchase Order' | 'Expense'
  - `loggedExpenseStatus` string
  - `loggedExpenseStatusId` integer
  - `date` string, date
  - `requiredDate` string, date, nullable
  - `purchaseOrderNumber` string, nullable
  - `jobId` integer
  - `itemPricingMethodId` integer
  - `supplierCompanyId` integer, nullable
  - `supplierContactId` integer, nullable
  - `itemName` string
  - `description` string, nullable
  - `reference` string, nullable
  - `costRate` number, float, nullable
  - `sellRate` number, float, nullable
  - `quantity` number, float, nullable
  - `currencyCode` string, nullable
  - `currencySymbol` string
  - `exchangeRate` number, float
  - `loggedExpenseCurrencyTotalCost` number, float, nullable
  - `loggedExpenseCurrencyAmountPaidIncTax` number, float, nullable
  - `loggedExpenseCurrencyBalance` number, float, nullable
  - `markup` number, float, nullable: Markup percentage (0-100)
  - `margin` number, float, nullable: Margin percentage (0-100)
  - `jobCurrencyTotalCost` number, float, nullable
  - `jobCurrencyTotalExTax` number, float, nullable
  - `jobCurrencyTotalAmountInvoicedExTax` number, float, nullable
  - `jobCurrencyTotalDraftInvoicesExTax` number, float, nullable: Total invoiced on draft invoices ex tax (job currency)
  - `jobCurrencyTotalAwaitingPaymentInvoicesExTax` number, float, nullable: Total invoiced on invoices awaiting payment ex tax (job currency)
  - `jobCurrencyTotalPaidInvoicesExTax` number, float, nullable: Total invoiced on paid invoices ex tax (job currency)
  - `jobCurrencyTotalIssuedInvoicesExTax` number, float, nullable: Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)
  - `externalId` string, nullable
  - `externalCopyDatetime` string, date-time, nullable

---

[API](https://skmtc.dev/streamtime/apis/public-api.md) · [All operations](https://skmtc.dev/streamtime/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamtime/apis/public-api/revisions/cda8d1405534?raw)