v1

latestOpenAPI 3.1.22026-08-065935.5 KB
Lookup Postal Codes

Lookup postal codes from geo location

Send a bulk request to lookup postal codes from geo location.

post/doLookupPostalCodes

Headers

Accept'application/json' | 'application/xml' | '*/*' required

Format of the response.

Content-Type'application/json' | 'application/xml' required

Format of the request.

Request body

CustomerIdstring required

Required. The License Key issued by Melissa.

Latitudestring required

Required. The latitude geographic coordinate in decimal format.

Longitudestring required

Required. The longitude geographic coordinate in decimal format.

MaxDistancestring

The requested maximum distance in miles. The maximum value is 10. Default is 10.

MaxRecordsstring

The requested number of records. The maximum value is 100. Default is 100.

Optionsstring

Options - Specify which options to use for the selected action. List of options in <OptionName>:<Parameter> format. Multiple options are delimited with a ,.

For example: OptionName:Parameter,OptionName:Parameter.

  • Level:< CarrierRoute | Plus4 | PostalCode > - This option specifies the level of data to search. Depending on which parameter you set for Level, you can return the ZIP, ZIP+4, or ZIP and Carrier Route with your records.
    • CarrierRoute - Two fields are returned for each record:
      • PostalCode: A 5-digit postal code
      • CarrierRoute: the nearest Carrier Route.
    • Plus4 - Two fields are returned for each record:
      • PostalCode: a 9-digit ZIP+4 Postal Code.
      • CarrierRoute: the nearest Carrier Route.
    • PostalCode - Default. Returns the nearest 5-digit Postal Code.
TransmissionReferencestring

Serves as a unique request identifier.

Response

Successful response

Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Reverse GeoCoder Result Codes.

Resultsstring

Comma delimited status, error codes, and change codes for the record. For more information, see Reverse GeoCoder Result Codes.

TotalRecordsinteger

Total number of records.