> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get one Invoice
> Retrieve a single Invoice record by its Id.
An **Invoice** represents a bill issued by Nexudus to the operator (the business running the coworking space). Invoices are generated automatically by the billing engine or can be created manually via the API.
Each invoice captures a snapshot of the billing details at issuance time — bill-to address, currency, tax amounts, and line items. Once issued, the invoice record is immutable with respect to these captured values; changes to the underlying financial accounts, products or customer details do not retroactively update existing invoices.
Invoices support `list`, `get`, and `create` operations. They cannot be updated or deleted through the API.
## Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
The authenticated user must be a full unrestricted administrator or have the **`Invoice-Read`** role.
## Path Parameters
The Id of the Invoice record to retrieve.
## Code Examples
```bash cURL theme={null}
curl -X GET \
"https://spaces.nexudus.com/api/billing/invoices/87654321" \
-H "Authorization: Bearer YOUR_TOKEN"
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://spaces.nexudus.com/api/billing/invoices/87654321',
{
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
}
);
const record = await response.json();
```
```python Python theme={null}
import requests
response = requests.get(
'https://spaces.nexudus.com/api/billing/invoices/87654321',
headers={
'Authorization': 'Bearer YOUR_TOKEN'
}
)
record = response.json()
```
## Response
### 200
Business Id.
Unique sequential invoice number assigned at issuance (e.g. INV-00042).
Name of the person or organisation being billed, captured at invoice time.
Billing street address, captured at invoice time.
Billing city, captured at invoice time.
Tax identification number (VAT/GST/EIN) of the billed party, captured at invoice time.
Billing postal/ZIP code, captured at invoice time.
Billing phone number, captured at invoice time.
Billing fax number, captured at invoice time.
Bill To Country Id.
Display name of the billing country (read-only, resolved from BillToCountryId).
Free-text description or notes for this invoice.
Total discount applied to the invoice, in the invoice currency.
Date by which payment is expected.
Start date of the billing period covered by this invoice.
End date of the billing period covered by this invoice.
Portion of the total that corresponds to recurring subscription charges.
Portion of the total attributed to the reseller (partner) channel.
Grand total of the invoice including all line items, taxes, and discounts.
Currency Id.
ISO 4217 currency code (e.g. USD, EUR), resolved from CurrencyId.
Total tax amount calculated for the invoice.
Whether the invoice has been fully paid.
Date and time when full payment was recorded.
Arbitrary JSON or text blob for storing integration-specific metadata.
Number of automatic payment collection attempts made for this invoice.
Unique record identifier.
UUID of the record.
Date and time the record was created (ISO 8601).
Date and time the record was last updated (ISO 8601).
Email of the user who last updated this record.
Whether the record was recently created.
External system identifier.
```json Example Response theme={null}
{
"BusinessId": 0,
"InvoiceNumber": "",
"BillToName": "",
"BillToAddress": "",
"BillToCity": "",
"BillToTaxIDNumber": null,
"BillToPostCode": "",
"BillToPhone": null,
"BillToFax": null,
"BillToCountryId": 0,
"BillToCountryName": null,
"Description": null,
"DiscountAmount": 0,
"DueDate": null,
"InvoiceFromDate": null,
"InvoiceToDate": null,
"SubscriptionAmount": 0,
"ResellerAmount": 0,
"TotalAmount": 0,
"CurrencyId": 0,
"CurrencyCode": null,
"TaxAmount": 0,
"Paid": false,
"PaidOn": null,
"CustomData": null,
"PaymentAttemptsCount": 0,
"Id": 87654321,
"UpdatedOn": "2025-01-15T10:30:00Z",
"CreatedOn": "2025-01-10T08:00:00Z",
"UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"UpdatedBy": "admin@example.com",
"IsNew": false,
"SystemId": null,
"ToStringText": "Invoice Example",
"LocalizationDetails": null,
"CustomFields": null
}
```