Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

DocumentRead

interface

Fields

NameTypeDescription
documentIdInt!

Unique identifier of the document

fiscalZoneString

Fiscal zone code for tax calculation purposes

documentTypeIdInt!

Document type identifier (e.g., invoice, credit note, receipt)

documentTypeDocumentTypeRead!

Document type details

documentSetDocumentSetRead

Document set this document belongs to

companyCompanyRead!

Company that owns this document

companyIdInt!

Company identifier

documentSetNameString!

Name of the document set

documentSetIdInt

Document set identifier

numberInt

Sequential document number within its document set

dateDateTime

Issue date of the document

geographicZoneIdInt

Geographic zone identifier for regional tax rules

geographicZoneGeographicZoneRead

Geographic zone details for regional tax rules

yearInt

Fiscal year of the document

totalValueFloat!

Total monetary value of the document including taxes

documentTotalFloat

Calculated total of the document based on line items

totalRelatedAppliedValueFloat

Total value applied from related documents

reconciledValueFloat

Value already reconciled/settled against this document

remainingReconciledValueFloat

Remaining value to be reconciled

reconciliationPercentageFloat

Percentage of the document value that has been reconciled

currencyExchangeTotalValueFloat

Total value converted to the foreign currency

currencyExchangeCurrencyExchangeRead

Currency exchange rate details

currencyExchangeExchangeFloat

Exchange rate applied to the document

documentCalculationsModeInt

Calculation mode used for the document (e.g., tax-inclusive or tax-exclusive)

statusInt

Document status: 0 = draft, 1 = closed/finalized

suspendedBoolean

Whether the document is suspended (temporarily on hold)

nullifiedBoolean

Whether the document has been voided/cancelled

pdfExportString

Path to the PDF file at mediaAPI:

  • null = PDF generation not requested
  • empty string = PDF pending generation
deletionBlockers[DeletionBlocker!]!

Reasons why this document can't be deleted. Empty array means the document is deletable

nullifiableBoolean

Whether this document can be nullified

entityVatString

Tax identification number (VAT) of the entity, copied at document creation

entityNameString

Name of the entity (customer/supplier), copied at document creation

entityNumberString

Internal reference number of the entity, copied at document creation

entityAddressString

Address of the entity, copied at document creation

entityZipCodeString

Postal code of the entity, copied at document creation

entityCityString

City of the entity, copied at document creation

entityCountryNameString

Country name of the entity, copied at document creation

countryIdInt

Country identifier of the entity

countryCountryRead

Country details of the entity

lastOperationsLastOperationsRead

Last operations performed on this document (created, closed, nullified)

emailsCountInt

Number of emails sent for this document

hashString

SAF-T hash signature for document integrity validation

hashControlString

Hash control character used in the hash chain

yourReferenceString

Customer's own reference for this document

ourReferenceString

Internal reference for this document

lastModifiedDateTime

Date and time of the last modification

downloadsInt

Number of times the document PDF has been downloaded

createdAtDateTime!

Timestamp when the document was created

updatedAtDateTime!

Timestamp when the document was last updated

importStatusImportStatus

Import status for migrated documents

sourceDocumentSource

Origin of the document (where it was created from)

createdLogInfo
updatedLogInfo
Deprecated fields (1)
NameTypeDescription
deletableBoolean

Whether this document can be deleted

Use deletionBlockers instead

Implements

© 2026 Moloni ON

Tax Authority Certificate No. 3075