﻿# Line Items

Line items are the catalog entries used to build invoices, one per billable product or service.
Each line item has a name, description, SKU, unit price, unit type, and tax rate.
A line item can optionally be assigned to a category to organize the catalog.
Unit types describe how each item is measured, such as by hour, unit, or pound.
Line items may be grouped into categories.
This allows for convenient organization to locate anad select line items.
For more information about categories, see [Categories](#categories-overview).
The Line Items endpoints support creating, listing, updating, and deleting entries.
The list endpoint accepts a search string and can filter by category or by items with no category.
A separate endpoint retrieves the available unit types a line item can reference.
Deleting a line item removes it from the catalog for future invoices.
The following endpoints are available:
| Endpoint | Explanation |
|  --- | --- |
| `GET /pay-int-api/line-items` | Lists line items, filtered by search string, category, or items with no category. |
| `POST /pay-int-api/line-items` | Creates a new line item. |
| `PUT /pay-int-api/line-items/{lineItemId}` | Updates a specified line item. |
| `DELETE /pay-int-api/line-items/{lineItemId}` | Deletes a line item. |
| `GET /pay-int-api/line-items/unit-types` | Retrieves the available unit types for line items. |

 - [GET /pay-int-api/line-items](https://developer.flute.com/api-reference/line-items/flute-v1-get-pay-int-api-line-items.md): GET {{baseURL}}/pay-int-api/line-items This endpoint retrieves a paginated list of line items from the merchant's catalog. Results can be filtered by search string, by a specific category, or limited
 - [POST /pay-int-api/line-items](https://developer.flute.com/api-reference/line-items/flute-v1-post-pay-int-api-line-items.md): POST {{baseURL}}/pay-int-api/line-items This endpoint creates a new line item in the merchant's catalog. The catalog is the collective set of line items assigned to a merchant. A line item represents
 - [PUT /pay-int-api/line-items/{lineItemId}](https://developer.flute.com/api-reference/line-items/flute-v1-put-pay-int-api-line-items-lineitemid.md): PUT {{baseURL}}/pay-int-api/line-items/{{lineItemId}} This endpoint updates the specified line item. The following is an example request. ```http PUT {{baseURL}}/pay-int-api/line-items/{{lineItemId}}
 - [DELETE /pay-int-api/line-items/{lineItemId}](https://developer.flute.com/api-reference/line-items/flute-v1-delete-pay-int-api-line-items-lineitemid.md): DELETE {{baseURL}}/pay-int-api/line-items/{{lineItemId}} This endpoint deletes a specified line item from the merchant's catalog. Once deleted, the item is permanently removed and can no longer be ref
 - [GET /pay-int-api/line-items/unit-types](https://developer.flute.com/api-reference/line-items/flute-v1-get-pay-int-api-line-items-unit-types.md): GET {{baseURL}}/pay-int-api/line-items/unit-types This endpoint retrieves the full list of unit types available for line items. This is a read only endpoint, so no request body is needed. Each unit 