---
title: "Mark a payable as paid"
method: POST
path: "/payables/{payable_id}/mark_as_paid"
tags: ["Payables"]
---

# Mark a payable as paid

`POST /payables/{payable_id}/mark_as_paid`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/payables/{payable_id}/mark_as_paid`
- Auth: HTTP bearer

Mark a payable as paid.

Payables can be paid using the payment channels offered by Monite or through external payment channels. In the latter
 case, the invoice is not automatically marked as paid in the system and needs to be converted to the paid status
 manually.

Optionally, it is possible to pass the `comment` field in the request body, to describe how and when the invoice was
paid.

Notes:
- To use this endpoint with an entity user token, this entity user must have a role that includes the `pay` permission
for payables.
- The `amount_to_pay` field is automatically calculated based on the `amount_due` less the percentage described
in the `payment_terms.discount` value.

Related guide: [Mark a payable as paid](https://docs.monite.com/accounts-payable/approvals/manual-transition#mark-as-paid)

See also:

[Payables lifecycle](https://docs.monite.com/accounts-payable/payables/index)

[Payables status transitions](https://docs.monite.com/accounts-payable/payables/collect#suggested-payment-date)

## Path parameters

- `payable_id` string, required

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `comment` string: An arbitrary comment that describes how and when this payable was paid.

## Response `200`

Successful Response

- PayableResponseSchema: Represents an Accounts Payable document received from a vendor or supplier.
  - `id` string, uuid, required: A unique ID assigned to this payable.
  - `created_at` string, date-time, required: UTC date and time when this payable was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `updated_at` string, date-time, required: UTC date and time when this payable was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `amount_due` integer: How much is left to be paid on the invoice (in minor units).
  - `amount_paid` integer: How much was paid on the invoice (in minor units).
  - `amount_to_pay` integer: How much is left to be paid on the invoice (in minor units) with discounts from payment terms.
  - `approval_policy_id` string, uuid: Id of existing approval policy that applies to this payable, if any. A policy is applied if the payable matches the policy trigger conditions.
  - `counterpart` CounterpartRawData
    - `address` CounterpartRawAddress: Address information.
      - `city` string: City name.
      - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX'
      - `line1` string: Street address.
      - `line2` string: Additional address information (if any).
      - `postal_code` string: ZIP or postal code.
      - `state` string: State, region, province, or county.
    - `bank_account` CounterpartRawBankAccount
      - `account_holder_name` string: Vendor's bank account name.
      - `account_number` string: Vendor's bank account number, IBAN, or similar (if specified in the payable document).
      - `bic` string: SWIFT code (BIC) of the vendor's bank.
      - `iban` string: required for non-GB bank accounts
      - `routing_number` string: required for US bank accounts
      - `sort_code` string: required for GB bank accounts
    - `email` string, email: The email address of the organization
    - `name` string: Vendor or supplier name.
    - `phone` string: The phone number of the organization
    - `tax_id` string: The tax id of the counterpart.
    - `vat_id` CounterpartRawVatId
      - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX'
      - `type` string
      - `value` string
  - `counterpart_address_id` string, uuid: The ID of counterpart address object stored in counterparts service
  - `counterpart_bank_account_id` string, uuid: The ID of counterpart bank account object stored in counterparts service
  - `counterpart_id` string, uuid: The ID of the counterpart object that represents the vendor or supplier.
  - `counterpart_raw_data` CounterpartRawData
    - `address` CounterpartRawAddress: Address information.
      - `city` string: City name.
      - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX'
      - `line1` string: Street address.
      - `line2` string: Additional address information (if any).
      - `postal_code` string: ZIP or postal code.
      - `state` string: State, region, province, or county.
    - `bank_account` CounterpartRawBankAccount
      - `account_holder_name` string: Vendor's bank account name.
      - `account_number` string: Vendor's bank account number, IBAN, or similar (if specified in the payable document).
      - `bic` string: SWIFT code (BIC) of the vendor's bank.
      - `iban` string: required for non-GB bank accounts
      - `routing_number` string: required for US bank accounts
      - `sort_code` string: required for GB bank accounts
    - `email` string, email: The email address of the organization
    - `name` string: Vendor or supplier name.
    - `phone` string: The phone number of the organization
    - `tax_id` string: The tax id of the counterpart.
    - `vat_id` CounterpartRawVatId
      - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX'
      - `type` string
      - `value` string
  - `counterpart_vat_id_id` string, uuid: The ID of counterpart VAT ID object stored in counterparts service
  - `created_by_role_id` string, 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`.
  - `credit_notes` PayableCreditNoteData[], required: The list of linked credit notes of the payable.
    - `id` string, uuid, required: The unique identifier of the credit note.
    - `document_id` string: The credit note's unique document number.
    - `issued_at` string, date: The date when the credit note was issued, in the YYYY-MM-DD format
    - `status` string, required: The current status of the credit note in its lifecycle
    - `total_amount` integer: Credit note total amount.
  - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'SVC' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW'
  - `currency_exchange` CurrencyExchangeSchema2
    - `default_currency_code` string, required
    - `rate` number, double, required
    - `total` number, double, required
  - `description` string: An arbitrary description of this payable.
  - `discount` integer: The value of the additional discount that will be applied to the total amount. in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
  - `document_id` string: 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_date` string, 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.
  - `einvoice_file_url` string: The URL to download the original e-invoice file.
  - `enforce_approval_policy_id` string, uuid: 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.
  - `entity_id` string, uuid, required: The ID of the entity to which the payable was issued.
  - `file` FileSchema: Represents a file (such as a PDF invoice) that was uploaded to Monite.
    - `id` string, uuid, required: A unique ID of this file.
    - `created_at` string, date-time, required: UTC date and time when this file was uploaded to Monite. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `file_type` string, required: The type of the business object associated with this file.
    - `md5` string, required: The MD5 hash of the file.
    - `mimetype` string, required: The file's [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types).
    - `name` string, required: The original file name (if available).
    - `pages` PageSchema2[]: If the file is a PDF document, this property contains individual pages extracted from the file. Otherwise, an empty array.
      - `id` string, uuid, required: A unique ID of the image.
      - `mimetype` string, required: The [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types) of the image.
      - `number` integer, required: The page number in the PDF document, from 0.
      - `size` integer, required: Image file size, in bytes.
      - `url` string, required: The URL to download the image.
    - `previews` PreviewSchema2[]: Preview images generated for this file. There can be multiple images with different sizes.
      - `height` integer, required: The image height in pixels.
      - `url` string, required: The image URL.
      - `width` integer, required: The image width in pixels.
    - `region` string, required: Geographical region of the data center where the file is stored.
    - `size` integer, required: The file size in bytes.
    - `url` string, required: The URL to download the file.
  - `file_id` string, uuid: File id to retrieve file info from file saver.
  - `issued_at` string, date: The date when the payable was issued, in the YYYY-MM-DD format.
  - `marked_as_paid_by_entity_user_id` string, uuid: The ID of the entity user who marked this document as paid.
  - `marked_as_paid_with_comment` string: An arbitrary comment that describes how and when this payable was paid.
  - `ocr_request_id` string, uuid: Id of OCR request to match asynchronous result of processing payable.
  - `ocr_status` 'processing' | 'error' | 'success'
  - `other_extracted_data` union: Data extracted from the uploaded payable by OCR.
    - OcrResponseInvoiceReceiptData
      - `counterpart_account_id` string: Counterpart bank ID
      - `counterpart_account_number` string: The bank account number
      - `counterpart_address` string: Counterpart address
      - `counterpart_address_object` OcrAddress: In general it's compatible with CounterpartAddress model but * All fields are optional * There is an additional field original_country_name
        - `city` string: City name.
        - `country` string: Two-letter ISO country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        - `line1` string: Street address.
        - `line2` string: Additional address information (if any).
        - `original_country_name` string: Country name as it is stated in the document.
        - `postal_code` string: ZIP or postal code.
        - `state` string: State, region, province, or county.
      - `counterpart_branch_number` string: The bank branch number
      - `counterpart_email` string: Email address of the counterpart
      - `counterpart_name` string: Counterpart name
      - `counterpart_routing_number` string: The bank routing number
      - `counterpart_vat_id` string: Counterpart VAT ID
      - `currency` string: ISO 4217 currency code
      - `discount_raw` number, double: Discount Raw amount
      - `document_due_date` string: Document due date in ISO format
      - `document_id` string: Invoice/receipt ID
      - `document_issued_at_date` string: Document issuance date in ISO format
      - `line_items_raw` OcrResponseInvoiceReceiptLineItemRaw[]: List of line items from document raw, without minor units conversion.
        - `description` string: Human-readable line item description
        - `item_adjusted` boolean: Item Quantity/Unit Price adjusted
        - `line_item_ocr_id` string: OCR Id of line item
        - `quantity` number, double: Quantity
        - `total_excl_vat` number, double: Total excluded VAT as parsed.
        - `total_incl_vat` number, double: Total included VAT as parsed.
        - `unit` string: Unit
        - `unit_price` number, double: Price as parsed
        - `vat_amount` number, double: VAT Amount as parsed.
        - `vat_percentage` number, double: VAT Percent as parsed.
      - `payment_terms_raw` string[]: Raw payment terms parsed but not calculated.
      - `purchase_order_number` string: Purchase Order Number
      - `tax_payer_id` string: Tax payer ID
      - `total_excl_vat_raw` number, double: Subtotal, without minor units
      - `total_paid_amount_raw` number, double: Total paid amount
      - `total_raw` number, double: Total, without minor units
      - `total_vat_amount_raw` number, double: VAT amount, without minor units
      - `total_vat_rate_raw` number, double: VAT Percent raw, without minor units.
      - `type` 'invoice'
    - OcrRecognitionResponse: Contains information about all text blocks extracted from an uploaded invoice by OCR. The text blocks are grouped into `line_items` (invoice line items) and `summary` (all other information). Legacy schema used for AWS textract recognition.
      - `line_items` LabelNValue[]: Text content of the invoice line items as recognized by OCR.
        - `label` Item, required: Contains information about a text block or line extracted from an uploaded document by OCR.
          - `confidence` number, double, required: OCR confidence score - the estimated accuracy percentage of character recognition of the extracted text, from 0 to 100%.
          - `processed_text` unknown
          - `text` string, required: The text as recognized by OCR.
        - `value` Item, required: Contains information about a text block or line extracted from an uploaded document by OCR.
          - `confidence` number, double, required: OCR confidence score - the estimated accuracy percentage of character recognition of the extracted text, from 0 to 100%.
          - `processed_text` unknown
          - `text` string, required: The text as recognized by OCR.
      - `summary` LabelNValue[]: Invoice text content other than the line items. Such as the invoice issue and due dates, vendor name and address, and other general information.
        - `label` Item, required: Contains information about a text block or line extracted from an uploaded document by OCR.
          - `confidence` number, double, required: OCR confidence score - the estimated accuracy percentage of character recognition of the extracted text, from 0 to 100%.
          - `processed_text` unknown
          - `text` string, required: The text as recognized by OCR.
        - `value` Item, required: Contains information about a text block or line extracted from an uploaded document by OCR.
          - `confidence` number, double, required: OCR confidence score - the estimated accuracy percentage of character recognition of the extracted text, from 0 to 100%.
          - `processed_text` unknown
          - `text` string, required: The text as recognized by OCR.
  - `paid_at` string, date-time: The date by which the payable was paid
  - `partner_metadata` object: Metadata for partner needs
  - `payable_origin` 'upload' | 'email' | 'einvoicing', required
  - `payment_terms` PayablePaymentTermsCreatePayload
    - `description` string
    - `name` string, required
    - `term_1` PayablePaymentTermDiscount
      - `discount` integer, required: The discount percentage in minor units. E.g., 200 means 2%, 1050 means 10.5%.
      - `number_of_days` integer, required: The amount of days after the invoice issue date.
    - `term_2` PayablePaymentTermDiscount
      - `discount` integer, required: The discount percentage in minor units. E.g., 200 means 2%, 1050 means 10.5%.
      - `number_of_days` integer, required: The amount of days after the invoice issue date.
    - `term_final` PayablePaymentTermFinal, required
      - `number_of_days` integer, required: The amount of days after the invoice issue date.
  - `project_id` string, uuid: Project ID of a payable.
  - `purchase_order_id` string, uuid: The identifier of the purchase order to which this payable belongs.
  - `sender` string, email: The email address from which the invoice was sent to the entity.
  - `source_of_payable_data` 'ocr' | 'user_specified' | 'einvoicing', required
  - `status` 'draft' | 'new' | 'approve_in_progress' | 'waiting_to_be_paid' | 'partially_paid' | 'paid' | 'canceled' | 'rejected', required
  - `subtotal` integer: The subtotal amount to be paid, in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
  - `suggested_payment_term` SuggestedPaymentTerm: Suggested payment date and corresponding discount
    - `date` string, date, required
    - `discount` integer
  - `tags` TagReadSchema[]: A list of user-defined tags (labels) assigned to this payable. Tags can be used to trigger a specific approval policy for this payable.
    - `id` string, uuid, required: A unique ID of this tag.
    - `created_at` string, date-time, required: Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `updated_at` string, date-time, required: Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
    - `created_by_entity_user_id` string, uuid: ID of the user who created the tag.
    - `description` string: The tag description.
    - `name` string, required: The tag name.
  - `tax` integer: Registered tax percentage applied for a service price in minor units, e.g. 200 means 2%, 1050 means 10.5%.
  - `tax_amount` integer: Tax amount in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
  - `total_amount` integer: The total amount to be paid, in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
  - `total_amount_with_credit_notes` integer: The total price of the payable in [minor units](https://docs.monite.com/references/currencies#minor-units), excluding all issued credit notes.
  - `was_created_by_user_id` string, uuid

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Possible responses: `Action for {object_type} at permissions not found: {action}`, `Object type at permissions not found: {object_type}`, `Action {action} for {object_type} not allowed`, `Payable couldn't be updated due to current state`, `The file cannot be attached because another file is already attached. Please note that only one file attachment is allowed.`
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)