# Retrieve a single invoice

Fetch detailed information about a specific sales invoice within the Property Management System (PMS) using its unique ID. Sales invoices are essential for tracking sales transactions, generating financial reports, and ensuring accurate billing. This endpoint is useful for retrieving invoice-specific data for reporting, auditing, and financial analysis. The response includes details about the sales invoice, including its date, associated organization, status, and line items. If the specified sales invoice ID does not exist, a  error will be returned. In case of an unexpected system error, a  will be triggered.

Endpoint: GET /api/v3/salesInvoices/{id}
Version: 3.0.4
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    ID of the sales invoice to retrieve
    Example: 123

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier of the sales invoice

  - `salesInvoiceNumber` (integer)
    Sales invoice number

  - `type` (string, required)
    Type of the sales invoice
    Enum: "SALES_INVOICE", "SALES_CREDIT"

  - `invoiceDate` (string, required)
    Date of the invoice

  - `net` (number)
    Net amount of the invoice

  - `tax` (number)
    Tax amount of the invoice

  - `gross` (number)
    Gross amount of the invoice

  - `baseNet` (number)
    Base net amount of the invoice

  - `baseTax` (number)
    Base tax amount of the invoice

  - `baseGross` (number)
    Base gross amount of the invoice

  - `reportingNet` (number)
    Reporting net amount of the invoice

  - `reportingTax` (number)
    Reporting tax amount of the invoice

  - `reportingGross` (number)
    Reporting gross amount of the invoice

  - `dueDate` (string, required)
    Due date of the invoice

  - `dateSent` (string)
    Date when the invoice was sent

  - `currency` (object, required)
    Base currency details of the invoice

  - `currency.id` (integer)
    Unique identifier of the currency
    Example: 1

  - `currency.name` (string)
    Name of the currency
    Example: "US Dollar"

  - `baseCurrency` (object)
    Base currency details of the invoice

  - `exchangeRate` (number)
    Exchange rate applied to the invoice

  - `baseExchangeRate` (number)
    Base exchange rate applied to the invoice

  - `customerName` (string)
    Customer name associated with the invoice

  - `companyName` (string)
    Company name associated with the invoice

  - `addressLine1` (string)
    Address line 1 of the customer

  - `addressLine2` (string)
    Address line 2 of the customer

  - `addressLine3` (string)
    Address line 3 of the customer

  - `city` (string)
    City of the customer

  - `postCode` (string)
    Post code of the customer

  - `country` (object)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `country.id` (integer)
    Unique identifier of the country

  - `country.name` (string, required)
    Name of the country

  - `country.sortOrder` (integer, required)
    Sort order of the country

  - `country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `country.countryCodeNumeric` (string, required)
    Numeric country code

  - `customerReference` (string)
    Customer reference

  - `financeAccount` (object, required)
    Finance account details

  - `financeAccount.id` (integer)
    Unique identifier of the finance account

  - `financeAccount.accountCode` (string)
    Account code of the finance account

  - `financeAccount.contact` (object)
    The primary correspondence contact of the company

  - `financeAccount.contact.id` (integer)
    Unique identifier of the contact

  - `financeAccount.contact.firstName` (string)
    First name of the contact

  - `financeAccount.contact.lastName` (string)
    Last name of the contact

  - `financeAccount.company` (object)
    Company summary associated with the finance account

  - `financeAccount.company.id` (integer)
    Unique identifier of the company

  - `financeAccount.company.companyName` (string)
    Name of the company

  - `financeAccount.externalId` (string)
    External identifier of the finance account

  - `financeAccount.exportedDate` (string)
    Date when the finance account was exported

  - `financeAccount.exportStatus` (string)
    Export status of the finance account
    Enum: "SKIPPED", "CREATED", "PENDING", "SENT", "EXPORTED", "FAILED", "IMPORTED"

  - `status` (string)
    Status of the invoice
    Enum: "DRAFT", "VOID", "POSTED"

  - `exportedDate` (string)
    Date when the invoice was exported

  - `externalId` (string)
    External ID of the invoice

  - `exportStatus` (string)
    Export status of the invoice
    Enum: "SKIPPED", "CREATED", "PENDING", "SENT", "EXPORTED", "FAILED", "IMPORTED"

  - `payableOnline` (boolean)
    Indicates if the invoice is payable online

  - `issueId` (integer)
    Issue ID associated with the invoice

  - `eventBookingId` (integer)
    Event booking ID associated with the invoice

  - `uuid` (string)
    UUID of the invoice

  - `payableOnlineReference` (integer)
    Reference for online payment

  - `organisationSettings` (object, required)
    Organisation settings

  - `organisationSettings.id` (integer)
    The unique identifier of the organisation settings
    Example: 1

  - `organisationSettings.name` (string)
    The name of the organisation
    Example: "Resharmonics"

  - `organisationSettings.currency` (object)
    The currency of the organisation

  - `organisationSettings.currency.description` (string)
    Description of the currency

  - `organisationSettings.currency.symbol` (string)
    Symbol of the currency

  - `organisationSettings.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `organisationSettings.currency.baseRate` (number)
    Base rate of the currency

  - `organisationSettings.currency.unit` (string)
    Unit of the currency

  - `organisationSettings.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `organisationSettings.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `organisationSettings.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `referenceNumber` (string)
    Reference number of the invoice

  - `outStanding` (number)
    Outstanding amount of the invoice

  - `outStandingNet` (number)
    Outstanding net amount of the invoice

  - `outStandingVat` (number)
    Outstanding VAT amount of the invoice

  - `externalIdentifier` (object)
    External identifier for Xero integration

  - `externalIdentifier.id` (integer, required)
    Identifier

  - `externalIdentifier.externalId` (string, required)
    External identifier

  - `externalIdentifier.exportedDate` (string)
    Exported date

  - `externalIdentifier.exportStatus` (string)
    Export status
    Enum: "CREATED", "EXPORTED", "FAILED", "IMPORTED", "PENDING", "SENT", "SKIPPED"