GET

api

public

billing

invoices

statements

pdf

Download Statement PDF

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

import requests

url = "https://spaces.nexudus.com/api/public/billing/invoices/statements/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/statements/pdf', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "401 Unauthorized": {}
}

Download Statement PDF

Returns a PDF statement summarising all invoices for the currently authenticated customer. The statement provides a consolidated overview of billing history in a single downloadable document.

Authentication

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

Query Parameters

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

// 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 statement PDF URL
const statementUrl = `https://${business.WebAddress}/en/api/public/billing/invoices/statements/pdf?t=${jwt}`

// 3. Open directly — no additional fetch needed
window.open(statementUrl, '_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 statement PDF
curl -o statement.pdf \
  "https://your-space.nexudus.com/en/api/public/billing/invoices/statements/pdf?t=$MEDIA_JWT"

Usage in Portal

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

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

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/draft/pdf – Preview upcoming invoice
GET /api/auth/media/customer – Obtain a short-lived media JWT

Error Responses

401 Unauthorized

error

Missing or invalid media JWT token.

Preview Next Invoice PDF

Download Statement PDF

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

import requests

url = "https://spaces.nexudus.com/api/public/billing/invoices/statements/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/statements/pdf', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "401 Unauthorized": {}
}

​Download Statement PDF

​Authentication

​Query Parameters

​Response

​Code Examples

​Usage in Portal

​Related Endpoints

​Error Responses

Download Statement PDF

Authentication

Query Parameters

Response

Code Examples

Usage in Portal

Related Endpoints

Error Responses