API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
  • Utilities
LogoLogo
API StatusPartner Portal
Accounts payablePayables

GET
/payables
GET
/v1/payables
1curl https://api.sandbox.monite.com/v1/payables \
2 -H "x-monite-version: 2024-05-25" \
3 -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4 -H "Authorization: Bearer <token>"
Try it
1{
2 "data": [
3 {
4 "id": "id",
5 "created_at": "2024-01-15T09:30:00Z",
6 "updated_at": "2024-01-15T09:30:00Z",
7 "credit_notes": [
8 {
9 "id": "123e4567-e89b-12d3-a456-426614174000",
10 "status": "submitted_for_approval",
11 "document_id": "CN-123456",
12 "issued_at": "2024-01-15",
13 "total_amount": 1000
14 }
15 ],
16 "entity_id": "entity_id",
17 "payable_origin": "upload",
18 "source_of_payable_data": "ocr",
19 "status": "draft",
20 "amount_due": 1000,
21 "amount_paid": 1000,
22 "amount_to_pay": 1000,
23 "approval_policy_id": "approval_policy_id",
24 "counterpart": {
25 "address": {
26 "city": "Berlin",
27 "country": "AF",
28 "line1": "Flughafenstrasse 52",
29 "line2": "line2",
30 "postal_code": "10115",
31 "state": "state"
32 },
33 "bank_account": {
34 "account_holder_name": "account_holder_name",
35 "account_number": "123456789012",
36 "bic": "DEUTDE2HXXX",
37 "iban": "iban",
38 "routing_number": "routing_number",
39 "sort_code": "sort_code"
40 },
41 "email": "acme@example.com",
42 "name": "Acme Inc.",
43 "phone": "5551231234",
44 "tax_id": "DE12345678",
45 "vat_id": {
46 "country": "AF",
47 "type": "type",
48 "value": "value"
49 }
50 },
51 "counterpart_address_id": "counterpart_address_id",
52 "counterpart_bank_account_id": "counterpart_bank_account_id",
53 "counterpart_id": "counterpart_id",
54 "counterpart_raw_data": {
55 "address": {
56 "city": "Berlin",
57 "country": "AF",
58 "line1": "Flughafenstrasse 52",
59 "line2": "line2",
60 "postal_code": "10115",
61 "state": "state"
62 },
63 "bank_account": {
64 "account_holder_name": "account_holder_name",
65 "account_number": "123456789012",
66 "bic": "DEUTDE2HXXX",
67 "iban": "iban",
68 "routing_number": "routing_number",
69 "sort_code": "sort_code"
70 },
71 "email": "acme@example.com",
72 "name": "Acme Inc.",
73 "phone": "5551231234",
74 "tax_id": "DE12345678",
75 "vat_id": {
76 "country": "AF",
77 "type": "type",
78 "value": "value"
79 }
80 },
81 "counterpart_vat_id_id": "counterpart_vat_id_id",
82 "created_by_role_id": "created_by_role_id",
83 "currency": "AED",
84 "currency_exchange": {
85 "default_currency_code": "default_currency_code",
86 "rate": 1.1,
87 "total": 1.1
88 },
89 "description": "description",
90 "discount": 500,
91 "document_id": "DE2287",
92 "due_date": "due_date",
93 "einvoice_file_url": "https://bucketname.s3.amazonaws.com/12345/67890.xml",
94 "enforce_approval_policy_id": "enforce_approval_policy_id",
95 "file": {
96 "id": "id",
97 "created_at": "2024-01-15T09:30:00Z",
98 "file_type": "payables",
99 "md5": "31d1a2dd1ad3dfc39be849d70a68dac0",
100 "mimetype": "application/pdf",
101 "name": "invoice.pdf",
102 "region": "eu-central-1",
103 "size": 24381,
104 "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf",
105 "pages": [
106 {
107 "id": "id",
108 "mimetype": "image/png",
109 "number": 0,
110 "size": 21972,
111 "url": "https://bucket.s3.amazonaws.com/123/456.png"
112 }
113 ],
114 "previews": [
115 {
116 "height": 400,
117 "url": "https://bucketname.s3.amazonaws.com/1/2/3.png",
118 "width": 200
119 }
120 ]
121 },
122 "file_id": "file_id",
123 "issued_at": "issued_at",
124 "marked_as_paid_by_entity_user_id": "71e8875a-43b3-434f-b12a-54c84c176ef3",
125 "marked_as_paid_with_comment": "Was paid partly in the end of the month.",
126 "ocr_request_id": "ocr_request_id",
127 "ocr_status": "processing",
128 "other_extracted_data": {
129 "counterpart_account_id": "DEUTDEFF",
130 "counterpart_account_number": "counterpart_account_number",
131 "counterpart_address": "counterpart_address",
132 "counterpart_address_object": {
133 "city": "Berlin",
134 "country": "DE",
135 "line1": "Flughafenstrasse 52",
136 "line2": "line2",
137 "original_country_name": "Berlin",
138 "postal_code": "10115",
139 "state": "state"
140 },
141 "counterpart_branch_number": "counterpart_branch_number",
142 "counterpart_email": "counterpart_email",
143 "counterpart_name": "Monite GMbH",
144 "counterpart_routing_number": "counterpart_routing_number",
145 "counterpart_vat_id": "DE88939004",
146 "currency": "EUR",
147 "discount_raw": 1.1,
148 "document_due_date": "document_due_date",
149 "document_id": "CST-13341",
150 "document_issued_at_date": "document_issued_at_date",
151 "line_items_raw": [
152 {
153 "description": "Impact Players : How to Take the Lead , Play Bigger , and Multiply Your",
154 "item_adjusted": true,
155 "line_item_ocr_id": "line_item_ocr_id",
156 "quantity": 1.2,
157 "total_excl_vat": 120,
158 "total_incl_vat": 135,
159 "unit": "meters",
160 "unit_price": 100,
161 "vat_amount": 15,
162 "vat_percentage": 12.5
163 }
164 ],
165 "payment_terms_raw": [
166 "payment_terms_raw"
167 ],
168 "purchase_order_number": "1234",
169 "tax_payer_id": "12345678901",
170 "total_excl_vat_raw": 77,
171 "total_paid_amount_raw": 50,
172 "total_raw": 70,
173 "total_vat_amount_raw": 7,
174 "total_vat_rate_raw": 12.5,
175 "type": "invoice"
176 },
177 "paid_at": "2024-01-15T09:30:00Z",
178 "partner_metadata": {
179 "key": "value"
180 },
181 "payment_terms": {
182 "name": "name",
183 "term_final": {
184 "number_of_days": 1
185 },
186 "description": "description",
187 "term_1": {
188 "discount": 1,
189 "number_of_days": 1
190 },
191 "term_2": {
192 "discount": 1,
193 "number_of_days": 1
194 }
195 },
196 "project_id": "project_id",
197 "purchase_order_id": "purchase_order_id",
198 "sender": "hello@example.com",
199 "subtotal": 1250,
200 "suggested_payment_term": {
201 "date": "date",
202 "discount": 1
203 },
204 "tags": [
205 {
206 "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
207 "created_at": "2022-09-07T16:35:18Z",
208 "updated_at": "2022-09-07T16:35:18Z",
209 "name": "Marketing",
210 "category": "document_type",
211 "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
212 "description": "Tag for the Marketing Department"
213 }
214 ],
215 "tax": 2000,
216 "tax_amount": 250,
217 "total_amount": 1500,
218 "total_amount_with_credit_notes": 1,
219 "was_created_by_user_id": "was_created_by_user_id"
220 }
221 ],
222 "next_pagination_token": "next_pagination_token",
223 "prev_pagination_token": "prev_pagination_token"
224}
Was this page helpful?
Previous

Create a payable

Next
Lists all payables from the connected entity. If you already have the data of the payable (amount in [minor units]( https://docs.monite.com/references/currencies#minor-units), currency, vendor information, and other details) stored somewhere as individual attributes, you can create a payable with these attributes by calling [POST /payables](https://docs.monite.com/api/payables/post-payables) and providing the [base64-encoded]( https://en.wikipedia.org/wiki/Base64) contents of the original invoice file in the field `base64_encoded_file`. A payable is a financial document given by an entity`s supplier itemizing the purchase of a good or a service and demanding payment. The `file_name` field is optional. If omitted, it defaults to “default_file_name”. If the settings are configured to automatically set `suggested_payment_term`, this object can be omitted from the request body. The `id` generated for this payable can be used in other API calls to update the data of this payable or trigger [ status transitions](https://docs.monite.com/accounts-payable/approvals/manual-transition), for example. essential data fields to move from `draft` to `new` Related guide: [Create a payable from data](https://docs.monite.com/accounts-payable/payables/collect#create-a-payable-from-data) See also: [Automatic calculation of due date](https://docs.monite.com/accounts-payable/payables/collect#automatic-calculation-of-due-date) [Suggested payment date](https://docs.monite.com/accounts-payable/payables/collect#suggested-payment-date) [Attach file](https://docs.monite.com/accounts-payable/payables/collect#attach-file) [Collect payables by email](https://docs.monite.com/accounts-payable/payables/collect#send-payables-by-email) [Manage line items](https://docs.monite.com/accounts-payable/payables/line-items)
Get payables

Lists all payables from the connected entity.

If you already have the data of the payable (amount in minor units, currency, vendor information, and other details) stored somewhere as individual attributes, you can create a payable with these attributes by calling POST /payables and providing the base64-encoded contents of the original invoice file in the field base64_encoded_file.

A payable is a financial document given by an entity`s supplier itemizing the purchase of a good or a service and demanding payment.

The file_name field is optional. If omitted, it defaults to “default_file_name”. If the settings are configured to automatically set suggested_payment_term, this object can be omitted from the request body.

The id generated for this payable can be used in other API calls to update the data of this payable or trigger status transitions, for example. essential data fields to move from draft to new

Related guide: Create a payable from data

See also:

Automatic calculation of due date

Suggested payment date

Attach file

Collect payables by email

Manage line items

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.

Query Parameters

orderenumOptional
Sort order (ascending by default). Typically used together with the `sort` parameter.
The ID of the entity that owns the requested resource.
Allowed values:
limitintegerOptional1-100Defaults to 100
The number of items (0 .. 100) to return in a single page of the response. The response may contain fewer items if it is the last or only page.
pagination_tokenstringOptional
A pagination token obtained from a previous call to this endpoint. Use it to get the next or previous page of results for your initial query. If `pagination_token` is specified, all other query parameters are ignored and inferred from the initial query. If not specified, the first page of results will be returned.
sortenumOptional
The field to sort the results by. Typically used together with the `order` parameter.
Allowed values:
created_at__gtdatetimeOptional
Return only payables created in Monite after the specified date and time. The value must be in the ISO 8601 format YYYY-MM-DDThh:mm[:ss[.ffffff]][Z|±hh:mm].
created_at__ltdatetimeOptional
Return only payables created in Monite before the specified date and time.
created_at__gtedatetimeOptional
Return only payables created in Monite on or after the specified date and time.
created_at__ltedatetimeOptional
Return only payables created in Monite before or on the specified date and time.
statusenumOptional
Return only payables that have the specified [status](https://docs.monite.com/accounts-payable/payables/index). To query multiple statuses at once, use the `status__in` parameter instead.
status__inenumOptional
Return only payables that have the specified [statuses](https://docs.monite.com/accounts-payable/payables/index). To specify multiple statuses, repeat this parameter for each value: `status__in=draft&status__in=new`
id__instringOptionalformat: "uuid"
Return only payables with specified IDs. Valid but nonexistent IDs do not raise errors but produce no results. To specify multiple IDs, repeat this parameter for each value: `id__in=<id1>&id__in=<id2>`
total_amountintegerOptional
Return only payables with the exact specified total amount. The amount must be specified in the minor units of currency. For example, $12.5 is represented as 1250.
total_amount__gtintegerOptional
Return only payables whose total amount (in minor units) exceeds the specified value.
total_amount__ltintegerOptional
Return only payables whose total amount (in minor units) is less than the specified value.
total_amount__gteintegerOptional
Return only payables whose total amount (in minor units) is greater than or equal to the specified value.
total_amount__lteintegerOptional
Return only payables whose total amount (in minor units) is less than or equal to the specified value.
amountintegerOptional
Return only payables with the specified amount.
amount__gtintegerOptional
Return only payables whose amount (in minor units) exceeds the specified value.
amount__ltintegerOptional
Return only payables whose amount (in minor units) is less than the specified value.
amount__gteintegerOptional
Return only payables whose amount (in minor units) is greater than or equal to the specified value.
amount__lteintegerOptional
Return only payables whose amount (in minor units) is less than or equal to the specified value.
currencyenumOptional
Return only payables that use the specified currency.
counterpart_namestringOptional
Return only payables received from counterparts with the specified name (exact match, case-sensitive). For counterparts of `type = individual`, the full name is formatted as `first_name last_name`.
counterpart_name__containsstringOptional
Return only payables received from counterparts whose name contains the specified string (case-sensitive).
counterpart_name__icontainsstringOptional
Return only payables received from counterparts whose name contains the specified string (case-insensitive).
search_textstringOptional
Apply the `icontains` condition to search for the specified text in the `document_id` and `counterpart_name` fields in the payables.
due_datestringOptionalformat: "date"
Return payables that are due on the specified date (YYYY-MM-DD)
due_date__gtstringOptionalformat: "date"
Return payables that are due after the specified date (exclusive, YYYY-MM-DD).
due_date__ltstringOptionalformat: "date"
Return payables that are due before the specified date (exclusive, YYYY-MM-DD).
due_date__gtestringOptionalformat: "date"
Return payables that are due on or after the specified date (YYYY-MM-DD).
due_date__ltestringOptionalformat: "date"
Return payables that are due before or on the specified date (YYYY-MM-DD).
issued_atstringOptionalformat: "date"
Return payables that are issued at the specified date (YYYY-MM-DD)
issued_at__gtstringOptionalformat: "date"
Return payables that are issued after the specified date (exclusive, YYYY-MM-DD).
issued_at__ltstringOptionalformat: "date"
Return payables that are issued before the specified date (exclusive, YYYY-MM-DD).
issued_at__gtestringOptionalformat: "date"
Return payables that are issued on or after the specified date (YYYY-MM-DD).
issued_at__ltestringOptionalformat: "date"
Return payables that are issued before or on the specified date (YYYY-MM-DD).
document_idstringOptional
Return a payable with the exact specified document number (case-sensitive). The `document_id` is the user-facing document number such as INV-00042, not to be confused with Monite resource IDs (`id`).
document_id__containsstringOptional
Return only payables whose document number (`document_id`) contains the specified string (case-sensitive).
document_id__icontainsstringOptional
Return only payables whose document number (`document_id`) contains the specified string (case-insensitive).
was_created_by_user_idstringOptionalformat: "uuid"
Return only payables created in Monite by the entity user with the specified ID.
counterpart_idstringOptionalformat: "uuid"
Return only payables received from the counterpart with the specified ID. Counterparts that have been deleted but have associated payables will still return results here because the payables contain a frozen copy of the counterpart data. If the specified counterpart ID does not exist and never existed, no results are returned.
source_of_payable_dataenumOptional
Return only payables coming from the specified source.
Allowed values:
ocr_statusenumOptional
Return only payables with specific OCR statuses.
Allowed values:
line_item_idstringOptionalformat: "uuid"
Search for a payable by the identifier of the line item associated with it.
purchase_order_idstringOptionalformat: "uuid"
Search for a payable by the identifier of the purchase order associated with it.
project_idstringOptionalformat: "uuid"
Return only payables assigned to the project with the specified ID. Valid but nonexistent project IDs do not raise errors but return no results.
project_id__instringOptionalformat: "uuid"
Return only payables whose `project_id` include at least one of the project_id with the specified IDs. Valid but nonexistent project IDs do not raise errors but produce no results.
tag_idsstringOptionalformat: "uuid"
Return only payables whose `tags` include at least one of the tags with the specified IDs. Valid but nonexistent tag IDs do not raise errors but produce no results.
tag_ids__not_instringOptionalformat: "uuid"
Return only payables whose `tags` do not include any of the tags with the specified IDs. Valid but nonexistent tag IDs do not raise errors but produce the results.
has_tagsbooleanOptional
Filter objects based on whether they have tags. If true, only objects with tags are returned. If false, only objects without tags are returned.
originenumOptional
Return only payables from a given origin ['einvoice', 'upload', 'email']
Allowed values:
has_filebooleanOptional
Return only payables with or without attachments (files)

Response

Successful Response
datalist of objects
next_pagination_tokenstring or null

A token that can be sent in the pagination_token query parameter to get the next page of results, or null if there is no next page (i.e. you’ve reached the last page).

prev_pagination_tokenstring or null

A token that can be sent in the pagination_token query parameter to get the previous page of results, or null if there is no previous page (i.e. you’ve reached the first page).

Errors

Return only payables that have the specified statuses.

To specify multiple statuses, repeat this parameter for each value: status__in=draft&status__in=new

Return only payables created in Monite after the specified date and time. The value must be in the ISO 8601 format YYYY-MM-DDThh:mm[:ss[.ffffff]][Z|±hh:mm].

Return only payables that have the specified status.

To query multiple statuses at once, use the status__in parameter instead.

Return only payables with the exact specified total amount. The amount must be specified in the minor units of currency. For example, $12.5 is represented as 1250.

Return only payables with specified IDs. Valid but nonexistent IDs do not raise errors but produce no results.

To specify multiple IDs, repeat this parameter for each value: id__in=<id1>&id__in=<id2>

Return only payables whose total amount (in minor units) exceeds the specified value.

Return only payables whose total amount (in minor units) is less than the specified value.

Return only payables whose total amount (in minor units) is less than or equal to the specified value.

Return only payables whose total amount (in minor units) is greater than or equal to the specified value.

Return only payables whose amount (in minor units) exceeds the specified value.

Return only payables whose amount (in minor units) is less than the specified value.

Return only payables whose amount (in minor units) is greater than or equal to the specified value.

Bearer authentication of the form Bearer <token>, where token is your auth token.

Sort order (ascending by default). Typically used together with the sort parameter.

The number of items (0 .. 100) to return in a single page of the response. The response may contain fewer items if it is the last or only page.

A pagination token obtained from a previous call to this endpoint. Use it to get the next or previous page of results for your initial query. If pagination_token is specified, all other query parameters are ignored and inferred from the initial query.

If not specified, the first page of results will be returned.

The field to sort the results by. Typically used together with the order parameter.

Return only payables whose amount (in minor units) is less than or equal to the specified value.

Return only payables received from counterparts with the specified name (exact match, case-sensitive).

For counterparts of type = individual, the full name is formatted as first_name last_name.

Return only payables received from counterparts whose name contains the specified string (case-sensitive).

Return only payables received from counterparts whose name contains the specified string (case-insensitive).

Apply the icontains condition to search for the specified text in the document_id and counterpart_name fields in the payables.

Return payables that are due on the specified date (YYYY-MM-DD)

Return payables that are due after the specified date (exclusive, YYYY-MM-DD).

Return payables that are due on or after the specified date (YYYY-MM-DD).

Return payables that are due before the specified date (exclusive, YYYY-MM-DD).

Return payables that are issued at the specified date (YYYY-MM-DD)

Return payables that are due before or on the specified date (YYYY-MM-DD).

Return payables that are issued before or on the specified date (YYYY-MM-DD).

Return payables that are issued after the specified date (exclusive, YYYY-MM-DD).

Return payables that are issued before the specified date (exclusive, YYYY-MM-DD).

Return payables that are issued on or after the specified date (YYYY-MM-DD).

Return only payables whose document number (document_id) contains the specified string (case-sensitive).

Return a payable with the exact specified document number (case-sensitive).

The document_id is the user-facing document number such as INV-00042, not to be confused with Monite resource IDs (id).

Return only payables whose project_id include at least one of the project_id with the specified IDs. Valid but nonexistent project IDs do not raise errors but produce no results.

Return only payables whose document number (document_id) contains the specified string (case-insensitive).

Return only payables whose tags do not include any of the tags with the specified IDs. Valid but nonexistent tag IDs do not raise errors but produce the results.

Return only payables whose tags include at least one of the tags with the specified IDs. Valid but nonexistent tag IDs do not raise errors but produce no results.

Return only payables with or without attachments (files)

Return only payables from a given origin [‘einvoice’, ‘upload’, ‘email’]