Skip to main content
POST
/
delivery_notes
curl --request POST \
  --url https://api.sandbox.monite.com/v1/delivery_notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-monite-entity-id: <x-monite-entity-id>' \
  --header 'x-monite-version: <x-monite-version>' \
  --data '
{
  "counterpart_id": "18a45457-377e-4b7c-b9a1-7b2e7f264d46",
  "counterpart_address_id": "9a0282e1-bae7-49c9-a6f3-152dbe6fe6b8",
  "delivery_date": "2025-07-01",
  "delivery_number": "INV-042",
  "display_signature_placeholder": true,
  "line_items": [
    {
      "product": {
        "name": "LG WH1000XM Monitor"
      },
      "quantity": 10
    },
    {
      "product_id": "e0c21d00-6556-4536-8390-830c4d3cf4ca",
      "quantity": 5
    }
  ]
}
'
{
  "id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "status": "created",
  "created_at": "2022-01-01T00:00:00Z",
  "updated_at": "2022-01-01T00:00:00Z",
  "entity_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "entity": {
    "name": "Entity Name"
  },
  "entity_address": {
    "line1": "Entity Street",
    "city": "Entity City",
    "postal_code": "123009",
    "country": "DE"
  },
  "created_by_entity_user_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "counterpart_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "counterpart": {
    "name": "Counterpart Name"
  },
  "counterpart_address": {
    "line1": "Counterpart Street",
    "city": "Counterpart City",
    "postal_code": "123009",
    "country": "DE"
  },
  "line_items": [
    {
      "quantity": 20,
      "product": {
        "name": "Product Name",
        "description": "Description of product",
        "measure_unit": {
          "name": "pcs",
          "description": "Pieces"
        }
      }
    }
  ],
  "document_id": "DN-2022-01-01-0001",
  "delivery_date": "2022-01-01",
  "delivery_number": "102-2022-0987",
  "memo": "This is a memo",
  "display_signature_placeholder": true,
  "file_url": "https://example.com/delivery_note.pdf",
  "original_file_url": "https://example.com/delivery_note_original.pdf",
  "file_language": "en",
  "original_file_language": "de",
  "based_on": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "based_on_document_id": "IN-2022-01-01-0001"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-monite-version
string<date>
required
​
x-monite-entity-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Body

application/json

Delivery Note creation request schema

​
counterpart_address_id
string<uuid>
required

ID of the counterpart address selected for the delivery note

​
counterpart_id
string<uuid>
required

ID of the counterpart

​
line_items
object[]
required

List of line items in the delivery note

Required array length: 1 - 100 elements
​
delivery_date
string<date>

Date of delivery

​
delivery_number
string

Delivery number

Minimum string length: 1
​
display_signature_placeholder
boolean
default:false

Whether to display a signature placeholder in the generated PDF

​
document_id
string

Document ID of the delivery note

Required string length: 1 - 100
​
memo
string

An optional note for the customer, displayed above the line items table in the PDF.

Minimum string length: 1

Response

Successful Response

​
id
string<uuid>
required

Unique ID of the delivery note

​
created_at
string<date-time>
required

Time at which the delivery note was created. Timestamps follow the ISO 8601 standard.

​
updated_at
string<date-time>
required

Time at which the delivery note was last updated. Timestamps follow the ISO 8601 standard.

​
counterpart
object
required

Counterpart of the delivery note

​
counterpart_address
object
required

Address of the counterpart

​
counterpart_id
string<uuid>
required

ID of the counterpart

​
display_signature_placeholder
boolean
required

Whether to display a signature placeholder in the generated PDF

​
document_id
string
required

Document ID of the delivery note

​
entity
object
required

Entity that created the delivery note

​
entity_address
object
required

Address of the entity that created the delivery note

​
entity_id
string<uuid>
required

ID of the entity that created the delivery note

​
file_language
enum<string>
required

The language of the customer-facing PDF file (file_url). The value matches the counterpart's language at the time when this PDF file was generated.

Available options:
ab,
aa,
af,
ak,
sq,
am,
ar,
an,
hy,
av,
ae,
ay,
az,
bm,
ba,
eu,
be,
bn,
bi,
bs,
br,
bg,
my,
ca,
ch,
ce,
ny,
zh,
cu,
cv,
kw,
co,
cr,
hr,
cs,
da,
dv,
nl,
dz,
en,
eo,
et,
ee,
fo,
fj,
fi,
fr,
fy,
ff,
gd,
gl,
lg,
ka,
de,
el,
kl,
gn,
gu,
ht,
ha,
he,
hz,
hi,
ho,
hu,
io,
ig,
id,
ia,
ie,
iu,
ik,
ga,
it,
ja,
jv,
kn,
kr,
ks,
kk,
km,
ki,
rw,
ky,
kv,
kg,
ko,
kj,
ku,
lo,
la,
lv,
li,
ln,
lt,
lu,
lb,
mk,
mg,
ms,
ml,
mt,
gv,
mi,
mr,
mh,
mn,
na,
nv,
nd,
nr,
ng,
ne,
no,
nb,
nn,
ii,
oc,
oj,
om,
os,
pi,
ps,
fa,
pl,
pt,
pa,
qu,
ro,
rm,
rn,
ru,
se,
sm,
sg,
sa,
sc,
sr,
sn,
sd,
si,
sk,
sl,
so,
st,
es,
su,
sw,
ss,
sv,
tl,
ty,
tg,
ta,
tt,
te,
th,
bo,
ti,
to,
ts,
tn,
tr,
tk,
tw,
ug,
uk,
ur,
uz,
ve,
vi,
vo,
wa,
cy,
wo,
xh,
yi,
yo,
za,
zu
​
line_items
object[]
required

List of line items in the delivery note

Minimum array length: 1
​
original_file_language
enum<string>
required

The language of the entity's copy of the PDF file (original_file_url). The value matches the entity's language at the time when this PDF file was generated.

Available options:
ab,
aa,
af,
ak,
sq,
am,
ar,
an,
hy,
av,
ae,
ay,
az,
bm,
ba,
eu,
be,
bn,
bi,
bs,
br,
bg,
my,
ca,
ch,
ce,
ny,
zh,
cu,
cv,
kw,
co,
cr,
hr,
cs,
da,
dv,
nl,
dz,
en,
eo,
et,
ee,
fo,
fj,
fi,
fr,
fy,
ff,
gd,
gl,
lg,
ka,
de,
el,
kl,
gn,
gu,
ht,
ha,
he,
hz,
hi,
ho,
hu,
io,
ig,
id,
ia,
ie,
iu,
ik,
ga,
it,
ja,
jv,
kn,
kr,
ks,
kk,
km,
ki,
rw,
ky,
kv,
kg,
ko,
kj,
ku,
lo,
la,
lv,
li,
ln,
lt,
lu,
lb,
mk,
mg,
ms,
ml,
mt,
gv,
mi,
mr,
mh,
mn,
na,
nv,
nd,
nr,
ng,
ne,
no,
nb,
nn,
ii,
oc,
oj,
om,
os,
pi,
ps,
fa,
pl,
pt,
pa,
qu,
ro,
rm,
rn,
ru,
se,
sm,
sg,
sa,
sc,
sr,
sn,
sd,
si,
sk,
sl,
so,
st,
es,
su,
sw,
ss,
sv,
tl,
ty,
tg,
ta,
tt,
te,
th,
bo,
ti,
to,
ts,
tn,
tr,
tk,
tw,
ug,
uk,
ur,
uz,
ve,
vi,
vo,
wa,
cy,
wo,
xh,
yi,
yo,
za,
zu
​
status
enum<string>
required

Status of the delivery note

Available options:
created,
canceled,
delivered
​
based_on
string<uuid>

The unique ID of a previous document related to the delivery note if applicable.

​
based_on_document_id
string

The unique document ID of a previous document related to the delivery note if applicable.

​
created_by_entity_user_id
string<uuid>

ID of the user that created the delivery note

​
delivery_date
string<date>

Date of delivery

​
delivery_number
string

Delivery number

​
file_url
string

The delivery note's PDF URL in the customer-facing language.

​
memo
string

An optional note for the customer, displayed above the line items table in the PDF.

​
original_file_url
string

The delivery note's PDF URL in the entity's language.