Geo.zip

The ZIP or postal code, as a string such as "10001" or "SW1A 1AA".

CurrentstringOptionalSince 2.0

Field facts

Path: device.geo.zip, user.geo.zip
Object: Geo
Type: string
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 3.2.19

How it is used

Keep it a string: many postal codes contain letters, and US codes lose leading zeros as numbers. A postal code is a common coarse substitute for coordinates, though the 2.5 COPPA guidance recommends dropping it too for child-directed traffic.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "device": {
    "geo": {
      "zip": "10001"
    }
  }
}

Common mistakes

Sending a ZIP as a number, which drops leading zeros (02134 becomes 2134).

Version history

Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	string	No	No
2.3 to 2.3.1	string	No	No
2.4	string	No	No
2.5 to 2.6-202606	string	No	No