--- title: "Global Express Postal Code" method: GET path: "/GlobalExpressPostalCode" tags: ["Address Autocompletion"] --- # Global Express Postal Code `GET /GlobalExpressPostalCode` GlobalExpressPostalCode is provided as a convenient method for quickly retrieving locality and administrative area information using the postal code as the input. A subsequent call to GlobalExpressAddress benefits greatly by using the locality and administrative area information from GlobalExpressPostalCode with GlobalExpressLocalityAdministrativeArea. ## Query parameters - `diacriticreplace` true | false - `format` 'xml' | 'json' | 'jsonp' - `id` string, password, required - `maxrecords` number - `country` string, required - `postalcode` string, required ## Headers - `Accept` 'application/json' | 'application/javascript' | '*/*', required - `Content-Type` 'application/json' | 'application/xml' | 'application/javascript' | '*/*', required ## Response `200` Global Express Locality Administrative Area response - GlobalExpressPostalCodeResponse - `Version` string — The current service version number. - `ResultCode` string — Lists result codes for the most recent request. For more information, see [Global Express Entry Result Codes](https://docs.melissa.com/cloud-api/global-express-entry/result-codes.html). - `ErrorString` string — Lists error codes from any errors caused by the most recent request. For more information, see [Global Express Entry Result Codes](https://docs.melissa.com/cloud-api/global-express-entry/result-codes.html). - `Results` object[] — Array with Address array(s) containing the record level fields. - `Address` Address - `Address` string — The full address in one line. - `Address1` string — Address line 1. - `Address2` string — Address line 2. - `Address3` string — Address line 3. - `Address4` string — Address line 4. - `Address5` string — Address line 5. - `Address6` string — Address line 6. - `Address7` string — Address line 7. - `Address8` string — Address line 8. - `Address9` string — Address line 9. - `Address10` string — Address line 10. - `Address11` string — Address line 11. - `Address12` string — Address line 12. - `DeliveryAddress` string — The full delivery address in one line. - `DeliveryAddress1` string — Delivery address line 1. - `DeliveryAddress2` string — Delivery address line 2. - `DeliveryAddress3` string — Delivery address line 3. - `DeliveryAddress4` string — Delivery address line 4. - `DeliveryAddress5` string — Delivery address line 5. - `DeliveryAddress6` string — Delivery address line 6. - `DeliveryAddress7` string — Delivery address line 7. - `DeliveryAddress8` string — Delivery address line 8. - `DeliveryAddress9` string — Delivery address line 9. - `DeliveryAddress10` string — Delivery address line 10. - `DeliveryAddress11` string — Delivery address line 11. - `DeliveryAddress12` string - `CountryName` string — The name of the country. - `ISO3166_2` string — The 2 letter ISO 3166 country code value. For example: `US` for United States or `CA` for Canada. - `ISO3166_3` string — The 3 letter ISO 3166 country code value. For example: `USA` for United States or `CAN` for Canada. - `ISO3166_N` string — The ISO 3166 country number value. For example: `840` for United States or `124` for Canada. - `SuperAdministrativeArea` string — A region within a country that has a higher level of administrative control or governance than other areas. - `AdministrativeArea` string — State, Province. This is a common geographic area unit for larger countries. - `SubAdministrativeArea` string — **County**. A logical area that that is smaller than the administrative area but larger than a locality. Rarely used as part of an official address. - `Locality` string — **City, Town**. The most common geographic area, used by virtually all countries. - `CityAccepted` string — A list of accepted city names. - `CityNotAccepted` string — Any non-accepted city names will be included in this field. - `DependentLocality` string — **Urbanization**. A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. - `DoubleDependentLocality` string — A logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is rarely used. - `Thoroughfare` string — **Street**. The most common street or block data element. - `DependentThoroughfare` string — Dependent Street. A second thoroughfare that is required to narrow down the final address. This is rarely used. - `Building` string — A descriptive name identifying an individual location. - `Premise` string — **Street Number**. The premise identifying number. - `SubBuilding` string — A smaller division of a building. For example, if an address has a building name that is a part of a larger set of buildings, then the sub building may be populated. - `PostalCode` string — **ZIP Code**. Complete postal code for a particular delivery point. - `PostalCodePrimary` string — The primary portion of the postal code. In the US, this is a 5-digit ZIP code. - `PostalCodeSecondary` string — The secondary portion of the postal code. In the US this is the +4 of the ZIP code. - `Organization` string — **Business, Company**. This name of the organization. - `PostBox` string — Post box information for a particular delivery point. - `Unmatched` string — Any part of the address that did not match other fields will be saved in this field. - `GeneralDelivery` string — The USPS address type assigned for the address. - `DeliveryInstallation` string — **Canada Only**. The delivery installation for the address. - `Route` string — **Canada Only**. The route service number. - `AdditionalContent` string — Any additional content associated with the address. - `CountrySubdivisionCode` string — This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers. - `MAK` string — Melissa Address Key. A unique key assigned to the submitted address. - `BaseMAK` string — Melissa Address Key Base. If the address has suites or apartments the 10 digit proprietary BaseMAK will be returned and correspond to the overall building. - `Latitude` string — The latitude geographic coordinate of the output address. - `Longitude` string — The longitude geographic coordinate of the output address. - `DistanceFromPoint` integer — The distance in miles from the specified point. ## Other responses - `400` — Bad Request --- [API](https://skmtc.net/melissa/apis/global-express-entry.md) · [All operations](https://skmtc.net/melissa/apis/global-express-entry/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/global-express-entry/versions/6830c3650e78/schema)