Preview Next Invoice PDF

GET /api/public/billing/invoices/draft/pdf

Preview Next Invoice PDF

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/public/billing/invoices/draft/pdf \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/billing/invoices/draft/pdf"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/public/billing/invoices/draft/pdf', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "401 Unauthorized": {}
}

Preview Next Invoice PDF

Returns a PDF preview of the customer’s upcoming invoice. This allows members to see what their next invoice will look like before it is officially generated, including estimated charges from active contracts and pending items.

Authentication

This endpoint requires a valid media JWT token obtained from GET /api/auth/media/customer.

Query Parameters

t · string · required

A short-lived media JWT obtained from GET /api/auth/media/customer. This token authorises temporary access to the binary file. Pass the jwt field from the response object directly as this query parameter value.

Response

Returns the raw PDF binary (application/pdf). The portal constructs the full URL and opens it in a new browser tab.

Code Examples

TypeScript

// 1. Fetch a media JWT (requires a valid Bearer token)
const { jwt } = await fetch('/api/auth/media/customer', {
  headers: { Authorization: `Bearer ${customerBearerToken}` },
}).then((r) => r.json())

// 2. Build the draft invoice PDF URL
const draftUrl = `https://${business.WebAddress}/en/api/public/billing/invoices/draft/pdf?t=${jwt}`

// 3. Open directly — no additional fetch needed
window.open(draftUrl, '_blank')

# First obtain a media JWT
MEDIA_JWT=$(curl -s -H "Authorization: Bearer $TOKEN" \
  "https://your-space.nexudus.com/en/api/auth/media/customer" | jq -r '.jwt')

# Then download the draft invoice PDF
curl -o draft-invoice.pdf \
  "https://your-space.nexudus.com/en/api/public/billing/invoices/draft/pdf?t=$MEDIA_JWT"

Usage in Portal

This endpoint is used in the My Invoices section to provide a “Preview next invoice” link at the bottom of the invoices table.

• File: src/views/user/activity/invoices/MyInvoicesSection.tsx

Related Endpoints

• GET /api/public/billing/invoices/my – List invoices
• GET /api/public/billing/invoices/{invoiceId}/pdf – Download a single invoice PDF
• GET /api/public/billing/invoices/statements/pdf – Download billing statement
• GET /api/auth/media/customer – Obtain a short-lived media JWT

Error Responses

401 Unauthorized · error

Missing or invalid media JWT token.