Alle Kunden abrufen

Mit diesem Endpunkt können Sie eine paginierte Liste aller Kunden abrufen.

Request

GET /api/v1/customers

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Response

{
	"data": [
		{
			"customer_number": "12345",
			"name": "Musterfirma GmbH",
			"additional_name": null,
			"website": "www.musterfirma.de",
			"email": null,
			"phone": "030-1234567",
			"fax": "030-1234568",
			"currency": "EUR",
			"comments": "Wichtiger Kunde - besondere Betreuung",
			"industry": "Technologie",
			"vat": "19.0000",
			"tax_number": "DE123456789",
			"iban": "DE89370400440532013000",
			"bic": "COBADEFFXXX",
			"payment_target": 30,
			"payment_target_discount": 2,
			"status": {
				"id": 1,
				"name": "Active"
			},
			"created": null,
			"modified": "2024-12-15T10:30:00.000000Z",
			"billing_procedure": true,
			"automated_invoicing": true,
			"debit_payment": false,
			"department_id": 1,
			"categories": [],
			"dynamicAttributes": [],
			"addresses_count": 2,
			"managers_count": 1,
			"categories_count": 0,
			"dynamicAttributes_count": 0,
			"contacts_count": 3
		},
		{
			"customer_number": "12346",
			"name": "Beratung & Service AG",
			"additional_name": "IT-Abteilung",
			"website": "www.beratung-service.de",
			"email": "info@beratung-service.de",
			"phone": "089-9876543",
			"fax": null,
			"currency": "EUR",
			"comments": null,
			"industry": "Beratung",
			"vat": "19.0000",
			"tax_number": "DE987654321",
			"iban": null,
			"bic": null,
			"payment_target": 14,
			"payment_target_discount": null,
			"status": null,
			"created": null,
			"modified": "2024-11-20T14:15:00.000000Z",
			"billing_procedure": true,
			"automated_invoicing": true,
			"debit_payment": true,
			"department_id": 2,
			"categories": [
				{
					"name": "Premium-Kunde",
					"description": {
						"de": "Premium-Kunde"
					},
					"type": {
						"id": "kunde",
						"name": "Kunde"
					}
				}
			],
			"dynamicAttributes": [],
			"addresses_count": 1,
			"managers_count": 0,
			"categories_count": 1,
			"dynamicAttributes_count": 0,
			"contacts_count": 5
		}
	]
}

Optionale Parameter

Name
start_date
Type
date | Y-m-d
Description
Erster Tag des abzufragenden Zeitraums. Die Angabe ist inklusiv, d.h. der als start_date angegebene Tag wird auch in den Ergebnissen berücksichtigt.
Name
end_date
Type
date | Y-m-d
Description
Letzter Tag des abzufragenden Zeitraums. Er ist inklusiv, d. h. der als end_date angegebene Tag wird in den Ergebnissen ebenfalls berücksichtigt.
Name
customer_number | customer_number[]
Type
string | array of strings
Description
Eine einzelne Kundennummer oder eine Liste von Kundennummern zum Filtern der Ergebnisse.
Name
limit
Type
integer
Description
Attribut zur Begrenzung der Einträge pro Seite

Kunden GET Kunden-Details