Copy page

Errors

ADDRESS_INVALID

ADDRESS_INVALID

The delivery address on the request could not be geocoded or is missing required components (street, city, postal code).

Reserved error code — not currently emitted by any endpoint. Partners may begin handling it defensively; backend will start emitting once wired in.

Summary

Field	Value
HTTP status	400
errorCategory	validation
retryable	false

When This Fires

• PUT /v1/marketplace/session/fulfillment-context — partner submits a delivery address that fails geocoding or is missing required components.
• POST /v1/marketplace/orders/validate / /place — same condition surfaces at order time on a delivery order.

Recommended Action

Re-prompt the user with address-autocomplete and resubmit:

1. Use a places autocomplete component to capture a structured address.
2. Verify all required fields (street, city, postal code, country) are populated.
3. Resubmit.

Example

Code
{
  "type": "https://developer.gett-tech.com/errors/ADDRESS_INVALID",
  "title": "Bad Request",
  "status": 400,
  "detail": "The delivery address could not be geocoded.",
  "instance": "/v1/marketplace/session/fulfillment-context",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "ADDRESS_INVALID",
  "errorCategory": "validation",
  "retryable": false
}