Expenses

Providers can request reimbursement for materials, travel, and other costs incurred during work. You must review and approve these expenses before the work order can be paid.

List Expenses

GET /workorders/{id}/expenses

Response

{
  "results": [
    {
      "id": 501,
      "category": { "id": 1, "name": "Materials" },
      "amount": 45.00,
      "description": "Cat6 cable - 100ft",
      "receipt_url": "https://cdn.fieldnation.com/receipts/abc.webp",
      "status": "pending",
      "created": { "utc": "2024-01-15 15:00:00" }
    }
  ],
  "totals": {
    "pending": 45.00,
    "approved": 0.00,
    "rejected": 0.00
  }
}

Create Expense

POST /workorders/{id}/expenses

{
  "category": { "id": 1 },
  "amount": 45.00,
  "description": "Cat6 cable - 100ft",
  "quantity": 1
}

Update Expense

PUT /workorders/{id}/expenses/{expense_id}

{
  "status": "approved"
}

{
  "status": "rejected",
  "rejection_reason": "Receipt not legible"
}

{
  "amount": 40.00,
  "status": "approved"
}

Expense Categories

Get available expense categories for your company:

GET /company/{company_id}/expenses

{
  "results": [
    { "id": 1, "name": "Materials", "requires_receipt": true },
    { "id": 2, "name": "Mileage", "requires_receipt": false },
    { "id": 3, "name": "Parking", "requires_receipt": true }
  ]
}

Expenses requiring receipts cannot be approved unless a receipt image is attached.

Expense Status Flow

Pending → Approved → Included in Payment
       ↘ Rejected (with reason)

Pay - Base pay structure
Company - Expense categories

Expenses

Expenses

List Expenses

Response

Create Expense

Update Expense

Expense Categories

Expense Status Flow

On this page

Expenses

Expenses

List Expenses

Response

Create Expense

Update Expense

Expense Categories

Expense Status Flow

On this page