Authentication

You must authenticate yourself in order to access the REST API. To do this, you must generate a Bearer Token, which you insert into the request header.

Bearer Token

You can generate the bearer token in the ZEP interfaces module in your ZEP. Here you can see an example of how to insert the generated token into the request header using cURL:

Authentication with Bearer Token

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

⚠️

Always keep your personal token safe and reset it if you suspect that it has been misused. Please do not send your ZEP password and token to GitHub or similar.

Rate Limiting

The API has a rate limit of 1000 requests per 5 minutes. If this limit is exceeded, further requests are blocked for 60 seconds. You will then receive an error message with the HTTP status code 429.

Please contact your customer advisor if the specified limit is not sufficient and you require a higher number of requests.

Quickstart Pagination