---
title: "Add an expense to the service order"
method: POST
path: "/service-orders/{serviceOrderId}/expenses"
tags: ["service-orders"]
---

# Add an expense to the service order

`POST /service-orders/{serviceOrderId}/expenses`

## Path parameters

- `serviceOrderId` string, uuid, required

## Headers

- `Content-Type` string, required
- `X-Extend-Access-Token` string, required
- `Accept` string, required

## Request body

- union
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required — expense status
    - `createdBy` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `metaData` object, required
      - `productName` string, required
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `type` 'replacement' | 'refurbished_replacement', required
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required
    - `createdBy` string
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `metaData` object, required
      - `partNumber` string, required
    - `type` 'parts', required
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `createdBy` string
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `type` 'store_credit' | 'labor' | 'shipping' | 'taxes' | 'diagnosis_fee' | 'battery', required

## Response `200`

Returns the created expense

- union
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required — expense status
    - `createdBy` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `metaData` object, required
      - `productName` string, required
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `type` 'replacement' | 'refurbished_replacement', required
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required
    - `createdBy` string
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `metaData` object, required
      - `partNumber` string, required
    - `type` 'parts', required
  - object
    - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `quantity` number
    - `description` string, required
    - `status` 'created' | 'approved' | 'void', required
    - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
    - `createdBy` string
    - `goodwillMetaData` object
      - `type` 'lol_service_overage' | 'customer_gesture', required
      - `description` string, required
      - `amount` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
    - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
    - `type` 'store_credit' | 'labor' | 'shipping' | 'taxes' | 'diagnosis_fee' | 'battery', required

## Other responses

- `403` — Forbidden
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.dev/extend/apis/leads-api.md) · [All operations](https://skmtc.dev/extend/apis/leads-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/extend/leads-api/revisions/76403e33d7d6/schema)