---
title: "Lookup a postal code from geo location"
method: GET
path: "/doLookupPostalCodes"
tags: ["Lookup Postal Codes"]
---

# Lookup a postal code from geo location

`GET /doLookupPostalCodes`

Send a GET request to lookup a postal code from geo location.

## Query parameters

- `t` string
- `id` unknown, required
- `lat` string, required
- `long` string, required
- `dist` number
- `recs` number
- `opt` 'Level:CarrierRoute' | 'Level:Plus4' | 'Level:PostalCode'
- `format` 'json' | 'xml'

## Headers

- `Accept` 'application/json' | 'application/xml' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- PostalCodeResponse
  - `Version` string — The current service version number.
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Reverse GeoCoder Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
  - `Results` string — Comma delimited status, error codes, and change codes for the record. For more information, see [Reverse GeoCoder Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
  - `TotalRecords` integer — Total number of records.
  - `Records` PostalCodeRecord[]
    - `City` string — The city of the output address.
    - `State` string — The state of the output address.
    - `PostalCode` string — The postal code of the output address.
    - `CarrierRoute` string — Returns the 5-digit Postal Code of the output address. If the Level option is set to Plus4 this field will instead return the 9-digit ZIP+4 of the output address.
    - `Latitude` string — The latitude geographic coordinate of the output address.
    - `Longitude` string — The longitude geographic coordinate of the output address.
    - `Distance` string — The distance in miles between the input coordinates and the output coordinates.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/melissa/apis/reverse-geocoder.md) · [All operations](https://skmtc.dev/melissa/apis/reverse-geocoder/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/reverse-geocoder/revisions/06423007a5d3/schema)