> For the complete documentation index, see [llms.txt](https://docs.keepup.store/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keepup.store/docs/api/sales.md).

# Sales

The Sales API lets you programmatically manage sales data in Keppup Store. Use it to retrieve, add, modify, or manage sales, seamlessly integrating sales management into your applications.

### API Endpoints:

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>List Sales <mark style="color:green;"><code>GET</code></mark></h4></td><td>Retrieves a list of all sales. You can apply filters to narrow down the results based on date, status, customer, and more.</td><td></td><td><a href="/docs/api/sales/list-sales.md">List Sales</a></td></tr><tr><td><h4>Fetch Sale <mark style="color:green;"><code>GET</code></mark></h4></td><td>Fetches details of a specific sale using the sale ID. This is useful for viewing complete sale details.</td><td></td><td><a href="/docs/api/sales/fetch-sale.md">Fetch Sale</a></td></tr><tr><td><h4>Add Sale <mark style="color:purple;"><code>POST</code></mark></h4></td><td>Allows you to add a new sale record. Such as receipts, invoices, quotes</td><td></td><td><a href="/docs/api/sales/add-sale.md">Add Sale</a></td></tr><tr><td><h4>Edit Sale <mark style="color:yellow;"><code>PUT</code></mark></h4></td><td>Edit details of an existing sale. This endpoint can be used to modify quantities, products, or prices in a sale that has not been finalized.</td><td></td><td><a href="/docs/api/sales/edit-sale.md">Edit Sale</a></td></tr><tr><td><h4><strong>Update Sale Balance </strong><mark style="color:yellow;"><strong><code>PUT</code></strong></mark></h4></td><td>Updates the balance of a specific sale. This endpoint is typically used to apply payments made for a sale.</td><td></td><td><a href="/docs/api/sales/update-balance.md">Update Balance</a></td></tr><tr><td><h4>Cancel Sale <mark style="color:yellow;"><code>PUT</code></mark></h4></td><td>Cancels a specific sale. This is irreversible and should be used with caution to ensure data integrity.</td><td></td><td><a href="/docs/api/sales/cancle-sale.md">Cancel Sale</a></td></tr><tr><td><h4>Refund Sale <mark style="color:yellow;"><code>PUT</code></mark></h4></td><td>Sets a specific sale status to refunded. This is irreversible and should be used with caution to ensure data integrity.</td><td></td><td><a href="/docs/api/sales/refund-sale.md">Refund Sale</a></td></tr></tbody></table>