---
title: Preview Invoices
slug: preview-invoices
docTags: 
createdAt: 2026-02-13T04:24:47.548Z
---

# Overview

This document explains how to use the Invoice Preview API to simulate and review an invoice before final creation. The preview API allows you to estimate invoice calculations—such as product charges, discounts, taxes, and totals—without generating a real invoice. This helps users validate billing logic, pricing, and configurations prior to activation, supporting accurate billing and streamlined review cycles.

# Preview Invoices

You can preview invoices for a list of order products of a given customer through the Nue API ( [Preview Billing Information](https://api-docs.nue.io/preview-billing-information) ), and the invoices will be returned in the API response.

For example, you can preview the invoice for the specific order products for a customer.

```curl
curl -X POST "https://api.nue.io/orders/invoices:preview" \
  -H "nue-api-key: {yourApiKey}" \
  -H "content-type: application/json" \
  -H "accept: application/json" \
  -d '{
    "customerId": "001KS00000DVz1aYAD",
    "targetDate": "2026-12-31",
    "orderProducts": [
      {
        "totalPrice": 118.8,
        "tax": 0,
        "startDate": "2025-10-06",
        "quantity": 1,
        "productName": "Nue Platform",
        "productId": "01t8G000002Rf6gQAC",
        "priceModel": "Recurring",
        "netSalesPrice": 9.9,
        "lineType": "LineItem",
        "id": "8028G000001KXtcQAG",
        "endDate": "2026-10-05"
      }
    ]
  }'
```

By default, the invoices will be previewed based on the billing settings configured for the customer. If there are no specific billing settings configured, the organization's billing settings will be used instead. 

You have the option to preview invoices with various billing settings. For example, you may choose to view invoices on a monthly basis, using a billing cycle date set for the middle of the month.

```curl
curl -X POST "https://api.nue.io/orders/invoices:preview" \
  -H "nue-api-key: {yourApiKey}" \
  -H "content-type: application/json" \
  -H "accept: application/json" \
  -d '{
    "customerId": "001KS00000DVz1aYAD",
    "billingPeriod": "Monthly",
    "billCycleDay": "15th of Month",
    "targetDate": "2026-12-31",
    "orderProducts": [
      {
        "totalPrice": 118.8,
        "tax": 0,
        "startDate": "2025-10-06",
        "quantity": 1,
        "productName": "Nue Platform",
        "productId": "01t8G000002Rf6gQAC",
        "priceModel": "Recurring",
        "netSalesPrice": 9.9,
        "lineType": "LineItem",
        "id": "8028G000001KXtcQAG",
        "endDate": "2026-10-05"
      }
    ]
  }'
```