---
title: "FinancialInvoiceByNumber (Fortnox)"
description: "Financial Invoice by Number"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/fortnox/Fortnox.FinanceInvoices.FinancialInvoiceByNumber
original: https://documentation.invantive.eu/en/datamodels/fortnox/Fortnox.FinanceInvoices.FinancialInvoiceByNumber
updated: 2026-11-01T16:13:15Z
license: https://documentation.invantive.eu/en/
---

# FinancialInvoiceByNumber: Fortnox Financial Invoice by Number

`read only` `REST`

- Catalog: `Fortnox`
- Schema: `FinanceInvoices`
- Label: Financial Invoice by Number

Retrieve a single invoice payment

 Retrieves the status and balance of an invoice sent to Fortnox Finans.
 You need to supply the invoice number in Fortox to retrieve the invoice.
 
 Note that invoices sent with the old &quot;Noxbox&quot; platform will not have the &quot;ServiceName&quot;
 property in the response. This new property is added to the response if the invoice is
 sent with the new finance service.
 
 Response explanation for Service and ServiceName
 
 Service:
 
     LEDGERBASE: if the invoice is sent by using the old &quot;Noxbox&quot; platform, or the new finance service with the subtypes &quot;Service Full&quot; or &quot;Service Light&quot;. These services are explained above in the &quot;Fortnox Finans services&quot; section
     REMINDER: If the invoice is sent by the new finance service, with the service Reminder Service
 
 
 ServiceName (only provided for new finance service invoices):
 
     SERVICE_FULL: Ledgerbase service with automatic reminders is used
     SERVICE_LIGHT: Ledgerbase service without automatic reminders is used.
     REMINDER_SERVICE: Reminder service is used

Can only retrieve data.

## Summary

<p>
 Retrieves the status and balance of an invoice sent to Fortnox Finans.
 You need to supply the invoice number in Fortox to retrieve the invoice.
 <p>
 <b>Note that</b> invoices sent with the old &quot;Noxbox&quot; platform will not have the &quot;ServiceName&quot;
 property in the response. This new property is added to the response if the invoice is
 sent with the new finance service.
 <p>
 Response explanation for <b>Service</b> and <b>ServiceName</b>
 <p>
 <b>Service:</b>
 <ul>
     <li><b>LEDGERBASE</b>: if the invoice is sent by using the old &quot;Noxbox&quot; platform, or the new finance service with the subtypes &quot;Service Full&quot; or &quot;Service Light&quot;. These services are explained above in the &quot;Fortnox Finans services&quot; section</li>
     <li><b>REMINDER</b>: If the invoice is sent by the new finance service, with the service Reminder Service</li>
 </ul>
 <p>
 <b>ServiceName</b> (only provided for <u>new finance service</u> invoices):
 <ul>
     <li><b>SERVICE_FULL</b>: Ledgerbase service <u>with</u> automatic reminders is used</li>
     <li><b>SERVICE_LIGHT</b>: Ledgerbase service <u>without</u> automatic reminders is used.</li>
     <li><b>REMINDER_SERVICE</b>: Reminder service is used</li>
 </ul>

## API Source

- Endpoint: `/3/noxfinansinvoices/{Number}`
- Operation: `get /3/noxfinansinvoices/{Number}`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 356 |
| Full scan rows per minute | 85,000 |
| Point query rows per minute | 168 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `financialyear` | `` | [ ] |  | Selects what financial year that should be used (does not work on every table). |
| `financialyeardate` | `` | [ ] |  | Selects by date, what financial year that should be used (does not work on every table). |
| `fromdate` | `` | [ ] |  | Defines a selection based on a start date. Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table). |
| `lastmodified` | `` | [ ] |  | Retrieves all records since the provided timestamp (does not work on every table). |
| `Number` | `` | [x] |  | The Fortnox invoice number |
| `todate` | `` | [ ] |  | Defines a selection based on an end date. Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table). |

## Table Columns

The columns of the table `FinancialInvoiceByNumber` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `NoxFinansInvoice_BalanceIncludeFees` | `double` | Nox Finans Invoice Balance Include Fees | [ ] | filters on the platform, writable, `NoxFinansInvoice.BalanceIncludeFees` |  |
| `NoxFinansInvoice_BalanceIncludeFeesCurrency` | `double` | Nox Finans Invoice Balance Include Fees Currency | [ ] | filters on the platform, writable, `NoxFinansInvoice.BalanceIncludeFeesCurrency` |  |
| `NoxFinansInvoice_CurrentCapitalBalance` | `double` | Nox Finans Invoice Current Capital Balance | [ ] | filters on the platform, writable, `NoxFinansInvoice.CurrentCapitalBalance` |  |
| `NoxFinansInvoice_CurrentCapitalBalanceCurrency` | `double` | Nox Finans Invoice Current Capital Balance Currency | [ ] | filters on the platform, writable, `NoxFinansInvoice.CurrentCapitalBalanceCurrency` |  |
| `NoxFinansInvoice_InvoiceDocumentURL` | `varchar2` | Nox Finans Invoice Document URL | [ ] | filters on the platform, writable, `NoxFinansInvoice.InvoiceDocumentURL` |  |
| `NoxFinansInvoice_InvoiceNumber` | `int32` | Nox Finans Invoice Number | [ ] | filters on the platform, writable, `NoxFinansInvoice.InvoiceNumber` |  |
| `NoxFinansInvoice_NextEvent` | `varchar2` | Nox Finans Invoice Next Event | [ ] | filters on the platform, writable, `NoxFinansInvoice.NextEvent` |  |
| `NoxFinansInvoice_NextEventDate` | `datetime` | Nox Finans Invoice Next Event Date | [ ] | filters on the platform, writable, `NoxFinansInvoice.NextEventDate` |  |
| `NoxFinansInvoice_OCRNumber` | `varchar2` | Nox Finans Invoice Ocr Number | [ ] | filters on the platform, writable, `NoxFinansInvoice.OCRNumber` |  |
| `NoxFinansInvoice_Service` | `varchar2` | Nox Finans Invoice Service | [ ] | filters on the platform, writable, `NoxFinansInvoice.Service` |  |
| `NoxFinansInvoice_ServiceName` | `varchar2` | Nox Finans Invoice Service Name | [ ] | filters on the platform, writable, `NoxFinansInvoice.ServiceName` |  |
| `NoxFinansInvoice_Status` | `varchar2` | Nox Finans Invoice Status | [ ] | filters on the platform, writable, `NoxFinansInvoice.Status` |  |
| `NoxFinansInvoice__url` | `varchar2` | Nox Finans Invoice URL | [ ] | filters on the platform, writable, `NoxFinansInvoice.@url` |  |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Fortnox](/en/release-notes/drivers?driver=fortnox)

