> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Error Rate, Deutsche Post

> API Error Rate for Deutsche Post stores. Tracked live in Vortex IQ Nerve Centre. How to read it, why it matters, and how to act on it.

**Metrics type:** [Supporting Metrics](/nerve-centre/overview#metrics-types-explained)  •  **Category:** Operational Health

## At a glance

> Share of calls to the DHL Geschaftskundenportal API that failed in the last 24 hours, expressed as a percentage of total requests. It is the early-warning gauge for the Deutsche Post connection: a healthy link sits near zero, while a sustained climb means bookings, label generation or tracking ingestion are starting to fail before the despatch team notices missing parcels. The alert fires above 2 percent.

## What it tracks

The card counts failed DHL API responses (HTTP 4xx and 5xx) against total requests over a rolling 24-hour window, grounded in the `detail`: "API Error Rate for the selected period." The mix of error codes points at the cause. A spike in 401 / 403 usually means a credential problem, so check [Days to Token Expiry](/nerve-centre/kpi-cards/deutsche-post/days-to-token-expiry) first. A spike in 5xx points at DHL-side instability rather than anything in your account. A spike in 422 / 400 points at malformed booking or label payloads, often a bad address or weight field, which surfaces downstream on [Label Generation Success](/nerve-centre/kpi-cards/deutsche-post/label-generation-success). Sustained errors above the `>2%` threshold mean some despatch actions are silently not completing, so treat a tripped alert as a despatch risk, not just a technical one.

## Reconciling against the source

Cross-check against the request and error logs in the [DHL Developer Portal](https://developer.dhl.com/) (API analytics for your app) and any status notices in the [DHL Geschaftskundenportal](https://www.dhl.de/de/geschaeftskunden.html). Note that DHL logs timestamps in carrier-local time (CET / CEST) and our 24-hour window is computed in UTC, so boundary counts can differ slightly; reconcile on the error code mix, not the exact request total.

***

### Tracked live in Vortex IQ Nerve Centre

*API Error Rate* is one of hundreds of KPI pulses Vortex IQ tracks across Deutsche Post and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English.

[Start for free](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.
