Get one Invoice

GET

api

billing

invoices

{id}

Get one Invoice

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

import requests

url = "https://spaces.nexudus.com/api/billing/invoices/{id}"

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/billing/invoices/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "InvoiceNumber": "<string>",
  "BillToName": "<string>",
  "BillToAddress": "<string>",
  "BillToCity": "<string>",
  "BillToTaxIDNumber": "<string>",
  "BillToPostCode": "<string>",
  "BillToPhone": "<string>",
  "BillToFax": "<string>",
  "BillToCountryId": 123,
  "BillToCountryName": "<string>",
  "Description": "<string>",
  "DiscountAmount": 123,
  "DueDate": "<string>",
  "InvoiceFromDate": "<string>",
  "InvoiceToDate": "<string>",
  "SubscriptionAmount": 123,
  "ResellerAmount": 123,
  "TotalAmount": 123,
  "CurrencyId": 123,
  "CurrencyCode": "<string>",
  "TaxAmount": 123,
  "Paid": true,
  "PaidOn": "<string>",
  "CustomData": "<string>",
  "PaymentAttemptsCount": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

An Invoice is the PLATFORM bill Nexudus issues to the operator (the business running the coworking space) for their own Nexudus subscription and usage. It is NOT the invoice a location issues to its customers — those are CoworkerInvoice records, served by the coworker_invoice_* tools, and are what an operator means by ‘invoice’ unless they explicitly say otherwise. Select the invoice_* tools only when the request explicitly names the Nexudus subscription or platform bill (for example ‘my Nexudus invoice’, ‘our subscription invoice’, ‘what Nexudus charges us’). A customer name, team name or bare invoice number is not such a signal, and the two entities share no records and no numbering sequence. Each platform invoice captures a snapshot of the billing details at issuance time — bill-to address, currency, tax amounts, and line items — and is immutable with respect to those values; later changes to financial accounts, products or operator details do not update existing invoices. Platform 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

integer

required

The Id of the Invoice record to retrieve.

Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/billing/invoices/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/invoices/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/billing/invoices/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

integer

ID of the business linked to this record.

string

Unique sequential invoice number assigned at issuance (e.g. INV-00042).

string

Name of the person or organisation being billed, captured at invoice time.

string

Billing street address, captured at invoice time.

string

Billing city, captured at invoice time.

string

Tax identification number (VAT/GST/EIN) of the billed party, captured at invoice time.

string

Billing postal/ZIP code, captured at invoice time.

string

Billing phone number, captured at invoice time.

string

Billing fax number, captured at invoice time.

integer

ID of the bill to country linked to this record.

string

Display value for BillToCountry.Name..

string

Free-text description or notes for this invoice.

number

Total discount applied to the invoice, in the invoice currency.

string

Date by which payment is expected.

string

Start date of the billing period covered by this invoice.

string

End date of the billing period covered by this invoice.

number

Portion of the total that corresponds to recurring subscription charges.

number

Portion of the total attributed to the reseller (partner) channel.

number

Grand total of the invoice including all line items, taxes, and discounts.

integer

ID of the currency linked to this record.

string

Display value for Currency.Code..

number

Total tax amount calculated for the invoice.

boolean

Whether the invoice has been fully paid.

string

Date and time when full payment was recorded.

string

Arbitrary JSON or text blob for storing integration-specific metadata.

integer

Number of automatic payment collection attempts made for this invoice.

integer

Unique record identifier.

string

UUID of the record.

string

Date and time the record was created (ISO 8601).

string

Date and time the record was last updated (ISO 8601).

string

Email of the user who last updated this record.

boolean

Whether the record was recently created.

string

External system identifier.

Example Response

{
  "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
}

Get one Invoice

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

import requests

url = "https://spaces.nexudus.com/api/billing/invoices/{id}"

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/billing/invoices/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "InvoiceNumber": "<string>",
  "BillToName": "<string>",
  "BillToAddress": "<string>",
  "BillToCity": "<string>",
  "BillToTaxIDNumber": "<string>",
  "BillToPostCode": "<string>",
  "BillToPhone": "<string>",
  "BillToFax": "<string>",
  "BillToCountryId": 123,
  "BillToCountryName": "<string>",
  "Description": "<string>",
  "DiscountAmount": 123,
  "DueDate": "<string>",
  "InvoiceFromDate": "<string>",
  "InvoiceToDate": "<string>",
  "SubscriptionAmount": 123,
  "ResellerAmount": 123,
  "TotalAmount": 123,
  "CurrencyId": 123,
  "CurrencyCode": "<string>",
  "TaxAmount": 123,
  "Paid": true,
  "PaidOn": "<string>",
  "CustomData": "<string>",
  "PaymentAttemptsCount": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Path Parameters

Code Examples

Response

200

​Authentication

​Path Parameters

​Code Examples

​Response

​200

Authentication

Path Parameters

Code Examples

Response

200