Get credit notes

GET

/payable_credit_notes

Headers

Auth

AuthorizationstringRequired

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

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.

Allowed values: ascdesc

limitintegerOptional>=1<=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: idcreated_at

created_at__gtdatetimeOptional

created_at__ltdatetimeOptional

created_at__gtedatetimeOptional

created_at__ltedatetimeOptional

issued_atstringOptionalformat: "date"

issued_at__gtstringOptionalformat: "date"

issued_at__ltstringOptionalformat: "date"

issued_at__gtestringOptionalformat: "date"

issued_at__ltestringOptionalformat: "date"

document_idstringOptional

document_id__iexactstringOptional

document_id__containsstringOptional

document_id__icontainsstringOptional

has_filebooleanOptional

total_amount__gtintegerOptional>=0

total_amount__ltintegerOptional>=0

total_amount__gteintegerOptional>=0

total_amount__lteintegerOptional>=0

subtotal__gtintegerOptional>=0

subtotal__ltintegerOptional>=0

subtotal__gteintegerOptional>=0

subtotal__lteintegerOptional>=0

based_onstringOptionalformat: "uuid"

counterpart_idstringOptionalformat: "uuid"

created_by_entity_user_idstringOptionalformat: "uuid"

statusenumOptional

status__inenumOptional

status__not_inenumOptional

originenumOptional

Allowed values: uploadeinvoicing

currencyenumOptional

project_idstringOptionalformat: "uuid"

project_id__instringOptionalformat: "uuid"

Response

Successful Response

datalist of objects

List of credit notes for the current page

next_pagination_tokenstringOptional

Token to retrieve the next page of results

prev_pagination_tokenstringOptional

Token to retrieve the previous page of results

Errors

GET

1 curl https://api.sandbox.monite.com/v1/payable_credit_notes \
2      -H "x-monite-version: 2024-05-25" \
3      -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "data": [
3     {
4       "id": "123e4567-e89b-12d3-a456-426614174000",
5       "created_at": "2024-01-15T14:30:00Z",
6       "updated_at": "2024-01-15T14:30:00Z",
7       "entity_id": "123e4567-e89b-12d3-a456-426614174000",
8       "origin": "SAP",
9       "source_of_data": "user_specified",
10       "status": "submitted_for_approval",
11       "based_on": "123e4567-e89b-12d3-a456-426614174000",
12       "based_on_document_id": "INV-2287",
13       "counterpart": {
14         "address": {
15           "city": "Berlin",
16           "country": "AF",
17           "line1": "Flughafenstrasse 52",
18           "line2": "line2",
19           "postal_code": "10115",
20           "state": "state"
21         },
22         "bank_account": {
23           "account_holder_name": "account_holder_name",
24           "account_number": "123456789012",
25           "bic": "DEUTDE2HXXX",
26           "iban": "iban",
27           "sort_code": "sort_code"
28         },
29         "email": "acme@example.com",
30         "name": "Acme Inc.",
31         "phone": "5551231234",
32         "tax_id": "DE12345678",
33         "vat_id": {
34           "country": "AF",
35           "type": "type",
36           "value": "value"
37         }
38       },
39       "counterpart_address_id": "123e4567-e89b-12d3-a456-426614174000",
40       "counterpart_bank_account_id": "123e4567-e89b-12d3-a456-426614174000",
41       "counterpart_id": "123e4567-e89b-12d3-a456-426614174000",
42       "counterpart_raw": {
43         "address": {
44           "city": "Berlin",
45           "country": "AF",
46           "line1": "Flughafenstrasse 52",
47           "line2": "line2",
48           "postal_code": "10115",
49           "state": "state"
50         },
51         "bank_account": {
52           "account_holder_name": "account_holder_name",
53           "account_number": "123456789012",
54           "bic": "DEUTDE2HXXX",
55           "iban": "iban",
56           "sort_code": "sort_code"
57         },
58         "email": "acme@example.com",
59         "name": "Acme Inc.",
60         "phone": "5551231234",
61         "tax_id": "DE12345678",
62         "vat_id": {
63           "country": "AF",
64           "type": "type",
65           "value": "value"
66         }
67       },
68       "counterpart_vat_id_id": "123e4567-e89b-12d3-a456-426614174000",
69       "created_by_external_user_id": "ext_user_123",
70       "created_by_external_user_name": "John Doe",
71       "created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
72       "currency": "EUR",
73       "currency_exchange": {
74         "default_currency_code": "default_currency_code",
75         "rate": 1.1,
76         "total": 1.1
77       },
78       "description": "Credit note for returned items from invoice INV-2287",
79       "document_id": "CN-2287",
80       "file_id": "123e4567-e89b-12d3-a456-426614174000",
81       "file_url": "file_url",
82       "issued_at": "2024-01-15",
83       "ocr_request_id": "123e4567-e89b-12d3-a456-426614174000",
84       "ocr_status": "completed",
85       "project_id": "123e4567-e89b-12d3-a456-426614174000",
86       "sender": "supplier@example.com",
87       "subtotal": 1000,
88       "tags": [
89         {
90           "id": "123e4567-e89b-12d3-a456-426614174000",
91           "created_at": "2022-09-07T16:35:18Z",
92           "updated_at": "2022-09-07T16:35:18Z",
93           "name": "Department A",
94           "category": "department",
95           "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
96           "description": "Tag for the Marketing Department"
97         }
98       ],
99       "tax": 20,
100       "tax_amount": 200,
101       "total_amount": 1200
102     }
103   ],
104   "next_pagination_token": "eyJwYWdlIjoyfQ==",
105   "prev_pagination_token": "eyJwYWdlIjoxfQ=="
106 }

Create a credit note

Up Next

1	curl https://api.sandbox.monite.com/v1/payable_credit_notes \
2	-H "x-monite-version: 2024-05-25" \
3	-H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4	-H "Authorization: Bearer <token>"

1	{
2	"data": [
3	{
4	"id": "123e4567-e89b-12d3-a456-426614174000",
5	"created_at": "2024-01-15T14:30:00Z",
6	"updated_at": "2024-01-15T14:30:00Z",
7	"entity_id": "123e4567-e89b-12d3-a456-426614174000",
8	"origin": "SAP",
9	"source_of_data": "user_specified",
10	"status": "submitted_for_approval",
11	"based_on": "123e4567-e89b-12d3-a456-426614174000",
12	"based_on_document_id": "INV-2287",
13	"counterpart": {
14	"address": {
15	"city": "Berlin",
16	"country": "AF",
17	"line1": "Flughafenstrasse 52",
18	"line2": "line2",
19	"postal_code": "10115",
20	"state": "state"
21	},
22	"bank_account": {
23	"account_holder_name": "account_holder_name",
24	"account_number": "123456789012",
25	"bic": "DEUTDE2HXXX",
26	"iban": "iban",
27	"sort_code": "sort_code"
28	},
29	"email": "acme@example.com",
30	"name": "Acme Inc.",
31	"phone": "5551231234",
32	"tax_id": "DE12345678",
33	"vat_id": {
34	"country": "AF",
35	"type": "type",
36	"value": "value"
37	}
38	},
39	"counterpart_address_id": "123e4567-e89b-12d3-a456-426614174000",
40	"counterpart_bank_account_id": "123e4567-e89b-12d3-a456-426614174000",
41	"counterpart_id": "123e4567-e89b-12d3-a456-426614174000",
42	"counterpart_raw": {
43	"address": {
44	"city": "Berlin",
45	"country": "AF",
46	"line1": "Flughafenstrasse 52",
47	"line2": "line2",
48	"postal_code": "10115",
49	"state": "state"
50	},
51	"bank_account": {
52	"account_holder_name": "account_holder_name",
53	"account_number": "123456789012",
54	"bic": "DEUTDE2HXXX",
55	"iban": "iban",
56	"sort_code": "sort_code"
57	},
58	"email": "acme@example.com",
59	"name": "Acme Inc.",
60	"phone": "5551231234",
61	"tax_id": "DE12345678",
62	"vat_id": {
63	"country": "AF",
64	"type": "type",
65	"value": "value"
66	}
67	},
68	"counterpart_vat_id_id": "123e4567-e89b-12d3-a456-426614174000",
69	"created_by_external_user_id": "ext_user_123",
70	"created_by_external_user_name": "John Doe",
71	"created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
72	"currency": "EUR",
73	"currency_exchange": {
74	"default_currency_code": "default_currency_code",
75	"rate": 1.1,
76	"total": 1.1
77	},
78	"description": "Credit note for returned items from invoice INV-2287",
79	"document_id": "CN-2287",
80	"file_id": "123e4567-e89b-12d3-a456-426614174000",
81	"file_url": "file_url",
82	"issued_at": "2024-01-15",
83	"ocr_request_id": "123e4567-e89b-12d3-a456-426614174000",
84	"ocr_status": "completed",
85	"project_id": "123e4567-e89b-12d3-a456-426614174000",
86	"sender": "supplier@example.com",
87	"subtotal": 1000,
88	"tags": [
89	{
90	"id": "123e4567-e89b-12d3-a456-426614174000",
91	"created_at": "2022-09-07T16:35:18Z",
92	"updated_at": "2022-09-07T16:35:18Z",
93	"name": "Department A",
94	"category": "department",
95	"created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
96	"description": "Tag for the Marketing Department"
97	}
98	],
99	"tax": 20,
100	"tax_amount": 200,
101	"total_amount": 1200
102	}
103	],
104	"next_pagination_token": "eyJwYWdlIjoyfQ==",
105	"prev_pagination_token": "eyJwYWdlIjoxfQ=="
106	}