> 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

### 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="/pages/8cKW9Gjj9b17637gGDDN">/pages/8cKW9Gjj9b17637gGDDN</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="/pages/j7tdBdc9BzSm9YtZl246">/pages/j7tdBdc9BzSm9YtZl246</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="/pages/eIBmYNYXYYJFGXxNKVix">/pages/eIBmYNYXYYJFGXxNKVix</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="/pages/UD2rbYowSM1JCNTimSkr">/pages/UD2rbYowSM1JCNTimSkr</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="/pages/0vfMH1sFElBSJcQyjNjP">/pages/0vfMH1sFElBSJcQyjNjP</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="/pages/73vcUam1BwWW8PHaX5qR">/pages/73vcUam1BwWW8PHaX5qR</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="/pages/0nRtG4bY4kHlrkqSNTWq">/pages/0nRtG4bY4kHlrkqSNTWq</a></td></tr></tbody></table>