---
title: "Lookup a Melissa Address Key (MAK)"
method: GET
path: "/doMAKLookup"
tags: ["Melissa Keys Lookup"]
---

# Lookup a Melissa Address Key (MAK)

`GET /doMAKLookup`

Search for the equivalent address associated with a MAK.

## Query parameters

- `id` string, password, required
- `format` 'JSON' | 'XML'
- `opt` string
- `ctry` string
- `mak` string, required

## Headers

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

## Response `200`

Successful Response

- Response
  - `TotalRecords` string — Total number of records.
  - `TransmissionReference` string — *Optional*. Serves as a unique request identifier.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Melissa Keys Lookup Result Codes](https://docs.melissa.com/cloud-api/melissa-keys-lookup/result-codes.html).
  - `Version` string — The current service version number.
  - `Records` ResponseRecord[]
    - `AddressLine1` string — These are string values that return the standardized or corrected address for the associated MAK.
    - `AddressLine2` string — Standardized or corrected contents of the input address line 2.
    - `AddressLine3` string — Standardized or corrected contents of the input address line 3.
    - `AddressLine4` string — Standardized or corrected contents of the input address line 4.
    - `AddressLine5` string — Standardized or corrected contents of the input address line 5.
    - `AddressLine6` string — Standardized or corrected contents of the input address line 6.
    - `AddressLine7` string — Standardized or corrected contents of the input address line 7.
    - `AddressLine8` string — Standardized or corrected contents of the input address line 8.
    - `AdministrativeArea` string — State, Province. This is a common geographic area unit for larger countries.
    - `City` string — The city name for the associated MAK.
    - `CountryISO3166_1_Alpha2` string — The 2 letter ISO 3166 country code value. For example: `US` for United States or `CA` for Canada.
    - `CountryISO3166_1_Alpha3` string — The 3 letter ISO 3166 country code value. For example: `USA` for United States or `CAN` for Canada.
    - `CountryISO3166_1_Numeric` string — The ISO 3166 country number value. For example: `840` for United States or `124` for Canada.
    - `CountryName` string — The full country name for the associated MAK.
    - `CountrySubdivisionCode` string — The ISO3166-2 code for country subdivisions, usually tied to 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. For example: `US-CA`, `CN-16`, or `AU-VIC`. This field is only populated for the following countries: AE, AR, AT, AU, BB, BE, BH, BR,BS, CA, CH, CL, CN, CO, CR, DE, DK, DM, DO, ES, FI, FJ, FR, GB, GH, GT, GY, HN, ID, IE, IL, IN, IS, IT, JP, KR, KW, LT, LU, LV, MX, MY, NC, NG, NI, NL, NO, NZ, PE, PH, PK, PL, PR, PT, RS, SA, SG, SI, SV, TH, TR, UA, US, UY, VN.
    - `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. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico.
    - `DoubleDependentLocality` string — A double dependent locality is a logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is very rarely used. Great Britain is an example of a country that uses double dependent locality.
    - `Locality` string — City. This is the most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, or Postal Town.
    - `PostalCode` string — ZIP Code. Most countries have some form of a postal code system.
    - `RecordID` string — The number of the record. Always `1` for a single request, otherwise it serves as an index of the array of records.
    - `Results` string — Comma delimited status, error codes, and change codes for the record.
    - `State` string — The state name.
    - `SubAdministrativeArea` string — County. This is a logical area that that is smaller than the administrative area but larger than a locality. While many countries can have a sub-administrative area value, it is very rarely used as part of an official address.
    - `SubNationalArea` string — The standardized arbitrary administrative region below that of the sovereign state. A sub-national area is a logical area unit that is larger than an administrative area but smaller than the country itself. It is extremely rarely used.
    - `SubPremises` string — Suite, Apartment. A subpremise are individual units with their own addresses inside a building.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/melissa-keys-lookup.md) · [All operations](https://skmtc.net/melissa/apis/melissa-keys-lookup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/melissa-keys-lookup/revisions/065ab969e558/schema)