---
updatedAt: 2025-11-13T15:38:54.000Z
agentTools:
  projectIndex: https://developers.bluesnap.com/v8976-Tools/llms.txt
---

# lines (JSON object)

Contains the line item details of the purchase

`lines` is an array of one or more objects representing the line item details of the purchase. Each object contains the following properties.

### Request

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Property Name
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Required
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        `quantity`
      </td>

      <td style={{ textAlign: "left" }}>
        integer
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Item quantity being purchased.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `taxCode`
      </td>

      <td style={{ textAlign: "left" }}>
        string
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Tax code for the item being purchased.\
        If not provided, the value defaults to the code for tangible personal property (tpp).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `description`
      </td>

      <td style={{ textAlign: "left" }}>
        string
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Line item description.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `amount`
      </td>

      <td style={{ textAlign: "left" }}>
        decimal
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        The total cost of the line items being purchased.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `itemCode`
      </td>

      <td style={{ textAlign: "left" }}>
        string
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Unique ID for the line item.
      </td>
    </tr>
  </tbody>
</Table>

### Response

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Property Name
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `quantity`
      </td>

      <td>
        integer
      </td>

      <td>
        Item quantity being purchased.
      </td>
    </tr>

    <tr>
      <td>
        `taxCode`
      </td>

      <td>
        string
      </td>

      <td>
        Tax code for the item being purchased.\
        If not provided, the value defaults to the code for tangible personal property (tpp).
      </td>
    </tr>

    <tr>
      <td>
        `description`
      </td>

      <td>
        string
      </td>

      <td>
        Line item description.
      </td>
    </tr>

    <tr>
      <td>
        `amount`
      </td>

      <td>
        decimal
      </td>

      <td>
        The cost of the line item.
      </td>
    </tr>

    <tr>
      <td>
        `itemCode`
      </td>

      <td>
        string
      </td>

      <td>
        Unique ID for the line item.
      </td>
    </tr>

    <tr>
      <td>
        `tax`
      </td>

      <td>
        decimal
      </td>

      <td>
        Tax for the line item.
      </td>
    </tr>
  </tbody>
</Table>