Skip to main content
400 Bad RequestIdempotency

IDEMPOTENCY_KEY_REQUIRED

An Idempotency-Key header is required

When it happens

POST /deliveries, POST /deliveries/{id}/book, POST /deliveries/{id}/cancel or POST /wallet/fund arrived without an Idempotency-Key header.

How to fix it

  1. Add an Idempotency-Key header that identifies this attempt, for example order-10045-delivery-1.
  2. Reuse the same key when you retry the same request.
RetryingFix the request, then send it with a new key.How idempotency works

Example response

HTTP 400 Bad Request
{
"status": "failed",
"error": {
"code": "IDEMPOTENCY_KEY_REQUIRED",
"message": "This request needs an Idempotency-Key header.",
"doc_url": "https://developer.getreeds.co/errors/IDEMPOTENCY_KEY_REQUIRED"
}
}