Estimated delivery date (EDD) responses

The EDD API possible responses:

Status	Meaning	Description
200	OK	Successful delivery estimate response
400	Bad Request	The request is malformed or required parameters are missing
403	Forbidden	The API key given does not match a valid merchant account
500	Internal Server Error	An unknown error occurred, or there is a problem with the input parameters

Examples

Example responses:

Successful delivery estimate response

[
  {
    "service_level": "standard",
    "estimated_delivery": {
      "earliest": "2026-04-20",
      "latest": "2026-04-22",
      "confidence": "medium",
      "display": "Arrives Tue, Apr 20 - Thu, Apr 22"
    }
  },
  {
    "service_level": "express",
    "estimated_delivery": {
      "earliest": "2026-04-18",
      "latest": "2026-04-18",
      "confidence": "high",
      "display": "Arrives Sat, Apr 18"
    }
  }
]

Filtered service levels response

When specific service levels are requested:

[
  {
    "service_level": "standard",
    "estimated_delivery": {
      "earliest": "2026-04-20",
      "latest": "2026-04-26",
      "confidence": "low",
      "display": "Arrives by Mon, Apr 27"
    }
  },
  {
    "service_level": "express",
    "estimated_delivery": {
      "earliest": "2026-04-18",
      "latest": "2026-04-19",
      "confidence": "medium",
      "display": "Arrives Sat, Apr 18 - Sun, Apr 19"
    }
  }
]

Limited availability response

When only certain service levels are available for the route:

[
  {
    "service_level": "standard",
    "estimated_delivery": {
      "earliest": null,
      "latest": null,
      "confidence": "none",
      "display": "3 to 5 business days"
    }
  }
]

Failed delivery estimate responses

422 response for missing required parameters:

{
  "error": "Invalid request",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "received": "undefined",
      "path": ["to_postcode"],
      "message": "Required"
    }
  ]
}