> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Item Object

> Individual line items within a contractor payment, referencing a service type or standalone.

Payment items represent individual line items within a contractor payment. They can reference a service type or be standalone. Payment items can only be added to contractor payment with the status pending.

| attribute           | type   | description                                                                                                                        |
| ------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| paymentItemID       | string | Unique identifier representing this payment item.                                                                                  |
| companyID           | string | Company ID that this customer account is under.                                                                                    |
| contractorID        | string | ID of contractor.                                                                                                                  |
| contractorPaymentID | string | ID contractor payment that this payment item is associated with.                                                                   |
| work\_info          | object | Contains: `work_description`: Custom description of payment item (string); `service_date`: Datetime of service completed (string). |
| earning\_type       | string | Can be one of the following: `hourly`, `per_unit`, `flat_fee`, `expense_reimbursement`, `bonus`.                                   |
| rate                | float  | **Only required if `earning_type` is `hourly` or `per_unit`**.                                                                     |
| rate\_unit          | float  | **Only required if `earning_type` is `hourly` or `per_unit`**. Can be one of the following: `hour`, `project`, `piece`.            |
| quantity            | float  | **Only required if `earning_type` is `hourly` or `per_unit`**.                                                                     |
| bill\_rate          | float  | **Only applicable if `earning_type` is `hourly` or `per_unit`**.                                                                   |
| gross\_amount       | float  | **Only required if `earning_type` is `flat_fee`, `expense_reimbursement`, or `bonus`**.                                            |
| bill\_amount        | float  | **Only applicable if `earning_type` is `flat_fee`, `expense_reimbursement`, or `bonus`**.                                          |

```json JSON theme={null}
{
  "paymentItemID": "a3f9c2d1e6b74a8f9c3d2b1e7f8a9c01",
  "companyID": "fc235f012bae46aa8a082f357715bcfa",
  "contractorID": "669fe6216d9eff8ca4c9f0de",
  "contractorPaymentID": "68ffb95239326ca8713eadb1",
  "work_info": {
    "work_description": "Bartending service",
    "service_date": "2026-03-20"
  },
  "earning_type": "hourly",
  "quantity": 8,
  "rate": 30.00,
  "bill_rate": 65.00
}
```