# Manage line items with the API

> Learn how to add and manage line items for products and services via the API

<AudienceInfo audiences={['developers']} />

Use Payabli's line item functions to create and manage products or services for invoices and bills. This guide covers the key operations for managing line items through the API.

## Considerations

Keep these considerations in mind when working with line items:

* Line items can be designated for invoices, bills, or both.
* Items are always associated with an organization or a paypoint.
* The `itemMode` parameter determines where items can be used (0=invoices, 1=bills, 2=both).

## Create a line item

Send a POST request to `/api/LineItem/{entryId}` to create a new line item in an entrypoint's catalog. See the [API reference](/developers/api-reference/lineitem/add-item-to-entrypoint-catalog) for full documentation.

This example creates a consultation service line item in the paypoint with ID `47cae3d74`. The item is set for use with invoices only (`itemMode: 0`).

<EndpointRequestSnippet endpoint="POST /LineItem/{entry}" example="AddItem" />

## Get line item details

Send a GET request to `/api/LineItem/{lineItemId}` to retrieve information about a specific line item. See the [API reference](/developers/api-reference/lineitem/get-item-in-entrypoint) for full documentation.

This example retrieves details for the line item with ID `700`.

<EndpointRequestSnippet endpoint="GET /LineItem/{lineItemId}" example="GetItem" />

A successful request sends a 200 response with a JSON body that contains the line item details.

<EndpointResponseSnippet endpoint="GET /LineItem/{lineItemId}" example="GetItem" />

## Get list of line items

Send a GET request to `/api/Query/lineitems/{entry}` to retrieve all line items for an entrypoint. See the [API reference](/developers/api-reference/lineitem/get-list-of-items-for-entrypoint) for full documentation.

This example retrieves all line items for the paypoint with ID `47cae3d74`.

<EndpointRequestSnippet endpoint="GET /Query/lineitems/{entry}" example="ListItems" />

A successful request sends a 200 response with a JSON body that contains the list of line items.

<EndpointResponseSnippet endpoint="GET /Query/lineitems/{entry}" example="ListItems" />

## Update a line item

Send a PUT request to `/api/LineItem/{lineItemId}` to modify an existing line item's details. See the [API reference](/developers/api-reference/lineitem/update-item-in-entrypoint) for full documentation.

This example updates the line item with ID `700` to be a materials deposit item with new pricing and measurement details.

<EndpointRequestSnippet endpoint="PUT /LineItem/{lineItemId}" example="UpdateItem" />

A successful request sends a 200 response with a JSON body that contains the updated line item details. The response is the same as the create line item response.

<EndpointResponseSnippet endpoint="PUT /LineItem/{lineItemId}" example="UpdateItem" />

## Delete a line item

Send a DELETE request to `/api/LineItem/{lineItemId}` to remove an existing line item. See the [API reference](/developers/api-reference/lineitem/delete-item-in-entrypoint) for full documentation.

This example deletes the line item with ID `700`.

<EndpointRequestSnippet endpoint="DELETE /LineItem/{lineItemId}" example="DeleteItem" />

A successful request sends a 200 response with a JSON body that contains the deleted line item's ID.

<EndpointResponseSnippet endpoint="DELETE /LineItem/{lineItemId}" example="DeleteItem" />

## Related resources

See these related resources to help you get the most out of Payabli.

<AccordionGroup>
  <Accordion title="Related topics">
    * **[Manage invoices](/guides/pay-in-developer-invoices-manage)** - Learn how to create, update, delete, and send invoices with the Payabli API
    * **[Manage bills with the API](/guides/pay-out-developer-bills-manage)** - Learn how to add and manage bills for vendors via the API
  </Accordion>
</AccordionGroup>