> ## 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`**. |
| metadata | object | Custom object you can attach to the payment item. Useful for storing additional information in a custom, structured format. Zeal does not use this object. Do not store sensitive information. Posting `metadata` replaces the whole object. See [Metadata](/reference/introduction/metadata). |

```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.0,
  "bill_rate": 65.0,
  "metadata": {
    "jobID": "19834673",
    "description": "Piecework pay"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.