For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Upload an incoming invoice (payable) in PDF, PNG, or JPEG format and scan its contents. The maximum file size is 20MB.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.
Request
This endpoint expects a multipart form containing a file.
filefileRequired
Response
Successful Response
idstringformat: "uuid"
A unique ID assigned to this payable.
created_atdatetime
UTC date and time when this payable was created. Timestamps follow the ISO 8601 format.
updated_atdatetime
UTC date and time when this payable was last updated. Timestamps follow the ISO 8601 format.
credit_noteslist of objects
The list of linked credit notes of the payable.
entity_idstringformat: "uuid"
The ID of the entity to which the payable was issued.
payable_originenum
Specifies how this payable was created in Monite: upload - created via an API call, email - sent via email to the entity’s mailbox.
source_of_payable_dataenum
Specifies how the property values of this payable were provided: ocr - Monite OCR service extracted the values from the provided PDF or image file, user_specified - values were added or updated via an API call.
The ID of counterpart bank account object stored in counterparts service
counterpart_idstringOptionalformat: "uuid"
The ID of the counterpart object that represents the vendor or supplier.
counterpart_raw_dataobjectOptional
Object representing counterpart data which was extracted by OCR. Used for informational purposes.
counterpart_vat_id_idstringOptionalformat: "uuid"
The ID of counterpart VAT ID object stored in counterparts service
created_by_role_idstringOptionalformat: "uuid"
The ID of the role that the entity user who created this payable had at that time. If the payable was created using a partner access token, the value is null.
currencyenumOptional
The currency code of the currency used in the payable.
currency_exchangeobjectOptional
descriptionstringOptional
An arbitrary description of this payable.
discountintegerOptional
The value of the additional discount that will be applied to the total amount. in minor units. For example, $12.50 is represented as 1250.
document_idstringOptional
A unique invoice number assigned by the invoice issuer for payment tracking purposes. This is different from id which is an internal ID created automatically by Monite.
due_datestringOptionalformat: "date"
The date by which the payable must be paid, in the YYYY-MM-DD format. If the payable specifies payment terms with early payment discounts, this is the final payment date.
Id of an existing approval policy that should be enforced when submitting the payable for approval.If this field is set, no other policies will be evaluated via their triggers - the specified policy will always be applied instead.
fileobjectOptional
The original file from which this payable was created.
file_idstringOptionalformat: "uuid"
File id to retrieve file info from file saver.
issued_atstringOptionalformat: "date"
The date when the payable was issued, in the YYYY-MM-DD format.
The ID of the entity user who marked this document as paid.
marked_as_paid_with_commentstringOptional
An arbitrary comment that describes how and when this payable was paid.
ocr_request_idstringOptionalformat: "uuid"
Id of OCR request to match asynchronous result of processing payable.
ocr_statusenumOptional
The status of the data recognition process using OCR. The 'processing' status means that the data recognition is in progress and the user needs to wait for the data enrichment. The 'error' status indicates that some error occurred on the OCR side and the user can fill in the data manually. The 'success' status means the data recognition has been successfully completed, after which the user can check the data if desired and enrich or correct it.
other_extracted_dataobjectOptional
Data extracted from the uploaded payable by OCR.
paid_atdatetimeOptional
The date by which the payable was paid
partner_metadatamap from strings to anyOptional
Metadata for partner needs
payment_termsobjectOptional
The number of days to pay with potential discount for options shorter than due_date
project_idstringOptionalformat: "uuid"
Project ID of a payable.
purchase_order_idstringOptionalformat: "uuid"
The identifier of the purchase order to which this payable belongs.
senderstringOptionalformat: "email"
The email address from which the invoice was sent to the entity.
subtotalintegerOptional
The subtotal amount to be paid, in minor units. For example, $12.50 is represented as 1250.
suggested_payment_termobjectOptional
The suggested date and corresponding discount in which payable could be paid. The date is in the YYYY-MM-DD format. The discount is calculated as X * (10^-4) - for example, 100 is 1%, 25 is 0,25%, 10000 is 100 %. Date varies depending on the payment terms and may even be equal to the due date with discount 0.
tagslist of objectsOptional
A list of user-defined tags (labels) assigned to this payable. Tags can be used to trigger a specific approval policy for this payable.
taxintegerOptional
Registered tax percentage applied for a service price in minor units, e.g. 200 means 2%, 1050 means 10.5%.
tax_amountintegerOptional
Tax amount in minor units. For example, $12.50 is represented as 1250.
total_amountintegerOptional
The total amount to be paid, in minor units. For example, $12.50 is represented as 1250.
total_amount_with_credit_notesintegerOptional
The total price of the payable in minor units, excluding all issued credit notes.
