v1
latestOpenAPI 3.0.02026-07-2455104.8 MBList delivery notes V3
This endpoint requires the following scopes: deliveryNote:read.
Paginated list of Delivery Notes.
Query parameters
The filter parameter is used to filter the results of the given endpoint.
Supported filter operators by key:
id: equals, notEquals, in, notIn
documentNumber: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentDate: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals
writeProtection: equals, notEquals
address.id: equals, notEquals, in, notIn
project.id: equals, notEquals, in, notIn
tags: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
tags.id: equals, notEquals, in, notIn
language: equals, notEquals, in, notIn
bodyIntroduction: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
bodyOutroduction: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
project.abbreviation: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
internalDesignation: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
vatId: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
deliveryTerms: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
internalComment: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
isDocumentSent: equals, notEquals
editor.id: equals, notEquals, in, notIn
createdAt: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull
updatedAt: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull
documentAddress.name: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.title: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.contactPerson: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.department: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.subDepartment: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.addressSupplement: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.street: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.zipCode: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.city: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.state: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.country: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.gln: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.email: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.phone: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
documentAddress.fax: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
sales.id: equals, notEquals, in, notIn
status: equals, notEquals, in, notIn
costCenter: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
customerNumber: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
customerOrderNumber: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
masterReferenceNumber: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith
preferredWarehouse.id: equals, notEquals, in, notIn
shippingMethod.id: equals, notEquals, in, notIn
useAlternativeDocumentTitle: equals, notEquals
salesOrder.id: equals, notEquals, in, notIn
orderPicking.id: equals, notEquals, in, notIn
shipments.count: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals
isDeliveryNoteToSupplier: equals, notEquals
noInvoice: equals, notEquals
invoice.id: equals, notEquals, in, notIn
hasOpenShipment: equals, notEquals
withoutInvoice: equals, notEquals
notRetrievedFromStock: equals, notEquals
Sort via id, -id, documentNumber, -documentNumber, documentDate, -documentDate, customerNumber, -customerNumber, documentAddress.country, -documentAddress.country, project.id, -project.id, createdAt, -createdAt, updatedAt and -updatedAt. Default sort is id
Full-text-style search across predefined columns.
Number of items per page. Default: 15, Max: 1000
Page number. Only used with simple and table pagination.
The cursor to use for the paginated call. Only used with cursor pagination. Not compatible with page parameter
Headers
Controls the pagination format. Available types: simple, table, cursor. Defaults to 'simple' if not specified.
Response
Paginated list of Delivery Notes.
Example response
{
"data": [
{
"id": "1",
"documentNumber": "I-12343",
"documentDate": "2023-10-01",
"customerNumber": "CUST-54321",
"address": {
"id": "42",
"createdAt": "2025-03-15T09:27:00+01:00",
"updatedAt": "2025-10-20T14:45:12+01:00"
},
"project": {
"id": "54",
"name": "Standard Project",
"abbreviation": "STANDARD"
},
"tags": [
{
"id": "4",
"title": "important"
}
],
"documentAddress": {
"name": "John",
"type": "mr",
"title": "Ms.",
"contactPerson": "Laura Schneider",
"department": "Research & Development",
"subDepartment": "CAI Lab",
"addressSupplement": "Gebäude B, 4. Etage",
"street": "Fuggerstraße 11",
"zipCode": "86150",
"city": "Augsburg",
"state": "BY",
"country": "DE",
"salutation": "Sehr geehrte Damen und Herren",
"gln": "1234567890123",
"email": "alice@example.com",
"phone": "+1-234-567-8900",
"fax": "+1-234-567-8901",
"mobile": "+1-234-567-8902"
},
"internalDesignation": "FB-3860-L",
"language": "de",
"bodyIntroduction": "Dear customer, we are pleased to send you the following invoice.",
"bodyOutroduction": "Thank you for your business.",
"vatId": "DE123456789",
"deliveryTerms": "DDP",
"internalComment": "This is an internal comment.",
"editor": {
"id": "4"
},
"activity": [
{
"message": "Invoice released",
"causer": "John Doe",
"causedAt": "2023-01-01T00:00:00Z"
}
],
"customFields": [
{
"key": "customer_category",
"value": "Premium",
"label": "Customer Category"
},
{
"key": "priority_level",
"value": "High",
"label": "Priority Level"
}
],
"updatedAt": "2023-10-01T12:00:00Z",
"createdAt": "2023-10-01T12:00:00Z",
"salesOrder": {
"id": "13"
},
"preferredWarehouse": {
"id": "15"
},
"sales": {
"id": "1"
},
"status": "released",
"customerOrderNumber": "CUST-54321",
"commissionConsignmentWarehouse": {
"id": "16"
},
"supplierNumber": "SUP-98765",
"invoice": {
"id": "42"
},
"orderPicking": {
"id": "12"
},
"lineItems": [
{
"type": "product",
"id": "1",
"number": "2462-SK-D",
"name": "Strawberry Jam",
"description": "Delicious strawberry jam made from fresh strawberries.",
"quantity": 2,
"product": {
"createdAt": "2025-03-15T09:27:00+01:00",
"updatedAt": "2025-10-20T14:45:12+01:00"
},
"customFields": [
{
"key": "customer_category",
"value": "Premium",
"label": "Customer Category"
},
{
"key": "priority_level",
"value": "High",
"label": "Priority Level"
}
],
"unit": "kg",
"packagingUnit": "box",
"internalComment": "This is an internal comment.",
"customerProductNumber": "CUS-10077",
"order": 5,
"updatedAt": "2023-10-01T12:00:00Z",
"createdAt": "2023-10-01T12:00:00Z",
"salesOrderLineItem": {
"id": "1"
},
"deliveredQuantity": 2,
"parentLineItem": {
"id": "1"
},
"desiredQualityControlAttributes": {
"bestBeforeDate": "2024-12-31",
"batch": "BATCH-12345"
},
"customs": {
"valueSingle": {
"amount": "13.37",
"currency": "EUR"
},
"valueTotal": {
"amount": "13.37",
"currency": "EUR"
},
"weightSingle": 0.5,
"weightTotal": 5
},
"sscc": "123456789012345678",
"package": "PKG-001",
"packagingUnitQuantity": 5,
"individualPieceQuantity": 10
}
],
"shippingMethod": {
"id": "16",
"name": "Standard Shipping"
},
"masterReferenceNumber": "24DE1234567890ABCD",
"effectiveAddresses": {
"shipTo": {
"name": "John",
"type": "mr",
"title": "Ms.",
"contactPerson": "Laura Schneider",
"department": "Research & Development",
"subDepartment": "CAI Lab",
"addressSupplement": "Gebäude B, 4. Etage",
"street": "Fuggerstraße 11",
"zipCode": "86150",
"city": "Augsburg",
"state": "BY",
"country": "DE",
"salutation": "Sehr geehrte Damen und Herren",
"gln": "1234567890123",
"email": "alice@example.com",
"phone": "+1-234-567-8900",
"fax": "+1-234-567-8901",
"mobile": "+1-234-567-8902"
}
},
"costCenter": "CC-123"
}
],
"meta": {
"currentPage": 1,
"from": 1,
"path": "https://api.example.com/items",
"perPage": 15,
"to": 15
},
"links": {
"first": "https://api.example.com/items?page=1",
"next": "https://api.example.com/items?page=17"
}
}