Reference Guide#

Introduction#

Melissa Releases allows users to securely and efficiently download data files, object binaries, and other collateral files from Melissa. This service enables users to automate the process of updating their data by allowing them to script the download of specific files rather than downloading the entire zip file. Additionally, file versioning is provided, making it easier to download historical data if necessary.

For example, users are able to download the data files specific for Address Object plus the correct Windows object library and any wrappers required, without needing to download the entire zip archive.

To ensure the security and integrity of the data being downloaded, Melissa Releases requires the user’s subscription license.

CLI Application#

Melissa also offers an open-source command-line interface (CLI) for Windows and Ubuntu, available here: Melissa Updater Git. The CLI simplifies the update process by providing a simple interface to consume the Melissa Releases service. Instead of scheduling a custom process, you can schedule simplified console commands.

For more information, see the Quickstart.

Base URL#

https://releases.melissadata.net

Parameters for Melissa Releases are primarily path parameters. Therefore the values used become part of the URL path in the requests and should be used in a specific order.

Licensing#

The License Key is a software key required to use the web service. You will receive your license key from your Melissa representative. If you don’t have a license key, contact the Melissa sales team at Sales@Melissa.com or 800-MELISSA ext. 3 (800-635-4772 ext. 3). Without a license key this service will not function.

To set the license key, use the id/CustomerID property in your requests.

Endpoints#

Use it from a Web Browser#

/Browse#

Try It Now#
  • Open in Browser
https://releases.melissadata.net/Browse?
&id={{customerId}}
&mft=dq_data
&release=latest
&sort=dsize
Request Parameters#
  • Open in Browser

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

mft

Manifest Name.

release

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

sort

Sortation to use listing returned fules.

Code

Description

architecture

Ascending by architecture.

compiler

Ascending by compiler.

darchitecture

Descending by architecture.

dcompiler

Descending by compiler.

dfileName

Descending by file name.

dos

Descending by operating system.

drelease

Descending by release date.

dsize

Descending by file size.

dtype

Descending by file type.

fileName

Ascending by file name.

os

Ascending by operating system.

release

Ascending by release date.

size

Ascending by file size.

type

Ascending by file type.

Response#

After successful submission, you will be redirected to the online browser where you may select different releases and manifests from drop-down boxes. Be sure to include your Customer ID.

To access the site directly, use https://releases.melissadata.net/Browse.

Download a Specific File#

Download Binary File#

/Download/Library/{{os}}/{{compiler}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to download binary files. For example: Address Object DLLs for the latest engine improvements.

Try It Now#
  • GET JSON
curl -L -o MelissaUpdater.exe "https://releases.melissadata.net/Download/Library\
/WINDOWS\
/NET\
/ANY\
/LATEST\
/MelissaUpdater.exe\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{compiler}}

Describes the target compiler.

Code

Description

ACC3

HP-UX native compiler

ANY

Any compiler

C

C/C++

COM

Windows COM DLL

DLL

Windows standard DLL

GCC32

gcc v3.2 (Linux)

GCC34

gcc v3.4 (AIX, HP-UX, Linux)

GCC41

gcc v4.1 (Linux)

GCC46

gcc v4.6 (zLinux)

GCC48

gcc v4.8 (Linux)

GCC83

gcc v8.3 (AIX)

JAVA

Java

MSSQL

SQL Server T-SQL

NET

.NET

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PLSQL

Oracle PL/SQL

PYTHON

Python

RUBY

Ruby

SSIS2005

SSIS 2005 component

SSIS2008

SSIS 2008 component

SSIS2012

SSIS 2012 component

SSIS2014

SSIS 2014 component

SSIS2016

SSIS 2016 component

SSIS2017

SSIS 2017 component

SSIS2019

SSIS 2019 component

SSIS2022

SSIS 2022 component

WINDOWS

Windows

WS12

Solaris native compiler

WS6

Solaris native compiler

XLC12

AIX native compiler

XLC6

AIX native compiler

{{filename}}

Name of File.

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#

After successful submission, you will be redirected to an automatic file download.

Download Data File#

/Download/Data/{{release}}/{{filename}}#

Use this endpoint to download reference data files. For example: Address Object reference data, such as mdAddrKey files for fresh and new data.

Try It Now#
  • GET JSON
curl -L -o ews.txt "https://releases.melissadata.net/Download/Data\
/LATEST\
/ews.txt\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{filename}}

Name of File.

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#

After successful submission, you will be redirected to an automatic file download.

Download Language Interface File#

/Download/Interface/{{os}}/{{language}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to download language interface files. For example: Address Object .NET wrappers to interface with the DLLs.

Try It Now#
  • GET JSON
curl -L -o mdAddr_cSharpCode.cs "https://releases.melissadata.net/Download/Interface\
/ANY\
/NET\
/ANY\
/LATEST\
/mdAddr_cSharpCode.cs\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{filename}}

Name of File.

{{language}}

Describes the language interface.

Code

Description

NET

.NET

C

C/C++

JAVA

Java

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PYTHON

Python

RUBY

Ruby

PLSQL

Oracle PL/SQL

MSSQL

SQL Server T-SQL

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#

After successful submission, you will be redirected to an automatic file download.

Download Product File#

/Download/Product/{{release}}/{{productname}}#

Use this endpoint to download product files.

Try It Now#
  • GET JSON
curl -L -o DataQualitySuite.zip "https://releases.melissadata.net/Download/Product\
/LATEST\
/DataQualitySuite\
?id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{productname}}

The name of the target product.

Code

CanadianGeoData

DataQualityComponents-SSIS

DataQualitySuite

FoneData

Geocoder

GeoData

GlobalMatchUp

mdCanada

mdELOT

MP4

RightFielder

ZipData

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#

After successful submission, you will be redirected to an automatic file download.

Retrieve Available Release Version Numbers#

Retrieve Available Release Version Numbers for Binary File#

/Releases/Library/{{os}}/{{compiler}}/{{architecture}}/{{filename}}#

Use this endpoint to retrieve a list of all available releases, in the format YYYY.MM.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Releases/Library\
/WINDOWS\
/NET\
/ANY\
/MelissaUpdater.exe\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{compiler}}

Describes the target compiler.

Code

Description

ACC3

HP-UX native compiler

ANY

Any compiler

C

C/C++

COM

Windows COM DLL

DLL

Windows standard DLL

GCC32

gcc v3.2 (Linux)

GCC34

gcc v3.4 (AIX, HP-UX, Linux)

GCC41

gcc v4.1 (Linux)

GCC46

gcc v4.6 (zLinux)

GCC48

gcc v4.8 (Linux)

GCC83

gcc v8.3 (AIX)

JAVA

Java

MSSQL

SQL Server T-SQL

NET

.NET

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PLSQL

Oracle PL/SQL

PYTHON

Python

RUBY

Ruby

SSIS2005

SSIS 2005 component

SSIS2008

SSIS 2008 component

SSIS2012

SSIS 2012 component

SSIS2014

SSIS 2014 component

SSIS2016

SSIS 2016 component

SSIS2017

SSIS 2017 component

SSIS2019

SSIS 2019 component

SSIS2022

SSIS 2022 component

WINDOWS

Windows

WS12

Solaris native compiler

WS6

Solaris native compiler

XLC12

AIX native compiler

XLC6

AIX native compiler

{{filename}}

Name of File.

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
[
  "2019.12",
  "2020.01",
  "2020.02",

  ...

  "2023.12",
  "2024.01"
]

Retrieve Available Release Version Numbers for Data File#

/Releases/Data/{{filename}}#

Use this endpoint to retrieve a list of all available data file releases, in the format YYYY.MM.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Releases/Data\
/ews.txt\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{filename}}

Name of File.

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
[
  "2023.06",
  "2023.07",
  "2023.08",

  ...

  "2023.12",
  "2024.01"
]

Retrieve Available Release Version Numbers for Language Interface File#

/Releases/Interface/{{os}}/{{language}}/{{architecture}}/{{filename}}#

Use this endpoint to retrieve a list of all available releases, in the format YYYY.MM.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Releases/Interface\
/ANY\
/NET\
/ANY\
/mdAddr_cSharpCode.cs\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{filename}}

Name of File.

{{language}}

Describes the language interface.

Code

Description

NET

.NET

C

C/C++

JAVA

Java

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PYTHON

Python

RUBY

Ruby

PLSQL

Oracle PL/SQL

MSSQL

SQL Server T-SQL

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
[
  "2023.06",
  "2023.07",
  "2023.08",

  ...

  "2023.12",
  "2024.01"
]

Retrieve Available Release Version Numbers for Manifest#

/ManifestReleases/{{manifest}}#

Use this endpoint to retrieve a list of available releases, in the format YYYY.MM.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/ManifestReleases\
/dq_wrappers\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{manifest}}

Manifest Name.

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
[
  "2023.07",
  "2023.08",
  "2023.09",

  ...

  "2023.12",
  "2024.01"
]

Retrieve Available Release Version Numbers for Product File#

/Releases/Product/{{productname}}#

Use this endpoint to retrieve a list of all available product file releases, in the format YYYY.MM.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Releases/Product\
/DataQualitySuite\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{productname}}

The name of the target product.

Code

CanadianGeoData

DataQualityComponents-SSIS

DataQualitySuite

FoneData

Geocoder

GeoData

GlobalMatchUp

mdCanada

mdELOT

MP4

RightFielder

ZipData

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
[
  "2024.07",
  "2024.08",
  "2024.09",
  "2024.10"
]

Retrieve a List of Files from a Specific Manifest#

/Manifest/{{release}}/{{manifest}}#

Use this endpoint to retrieve a list of download links for data or binary files for a specific release, in the format YYYY.MM. This approach is recommended to ensure the retrieval of all of the latest files in the manifest(s) for a given product.

Try It Now#

  • GET JSON
curl -X GET "https://releases.melissadata.net/Manifest\
/LATEST\
/dq_wrappers\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Request Parameters#

  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{manifest}}

Manifest Name.

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Headers#

  • GET JSON
Content-Type: application/json
Accept: application/json

Response#

  • GET JSON
[
  "https://releases.melissadata.net/Download/Interface/LINUX/JAVA/64BIT/2024.01/libmdAddrJavaWrapper.so/?ID={{customerID}}",
  "https://releases.melissadata.net/Download/Interface/LINUX/JAVA/64BIT/2024.01/libmdEmailJavaWrapper.so/?ID={{customerID}}",
  "https://releases.melissadata.net/Download/Interface/LINUX/JAVA/64BIT/2024.01/libmdNameJavaWrapper.so/?ID={{customerID}}",

  ...

  "https://releases.melissadata.net/Download/Interface/ANY/JAVA/ANY/2024.01/mdPhoneJavaWrapper.cpp/?ID={{customerID}}",
  "https://releases.melissadata.net/Download/Interface/WINDOWS/JAVA/64BIT/2024.01/mdPhoneJavaWrapper.dll/?ID={{customerID}}"
]

Retrieve a List of Manifests from a Specific Release Version Number#

/ManifestList/{{release}}#

Use this endpoint to retrieve a list of available manifests for a given release.

Try It Now#

  • GET JSON
curl -X GET "https://releases.melissadata.net/ManifestList\
/LATEST\
?&id={{customerId}}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Request Parameters#

  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Headers#

  • GET JSON
Content-Type: application/json
Accept: application/json

Response#

  • GET JSON
[
  {
    "manifestName": "ca_geodata",
    "description": "Canadian geodata files",
    "url": "https://releases.melissadata.net/Manifest/2024.03/ca_geodata/?ID={{customerID}}"
  },
  {
    "manifestName": "cgd_dvd",
    "description": "Canadian geodata files",
    "url": "https://releases.melissadata.net/Manifest/2023.12/cgd_dvd/?ID={{customerID}}"
  },
  {
    "manifestName": "cleanser_data",
    "description": "description",
    "url": "https://releases.melissadata.net/Manifest/2023.09/cleanser_data/?ID={{customerID}}"
  },

  ...

  {
    "manifestName": "zi_ziplist5",
    "description": "description",
    "url": "https://releases.melissadata.net/Manifest/2024.02/zi_ziplist5/?ID={{customerID}}"
  },
  {
    "manifestName": "zipdata2",
    "description": "ZipData2 files",
    "url": "https://releases.melissadata.net/Manifest/2024.02/zipdata2/?ID={{customerID}}"
  }
]

Retrieve Metadata for a Specific File#

Retrieve Metadata for Binary File#

/Metadata/Library/{{os}}/{{compiler}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to retrieve metadata for a given file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Metadata/Library\
/WINDOWS\
/NET\
/ANY\
/LATEST\
/MelissaUpdater.exe\
?&id={{customerId}}\
&format=json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{compiler}}

Describes the target compiler.

Code

Description

ACC3

HP-UX native compiler

ANY

Any compiler

C

C/C++

COM

Windows COM DLL

DLL

Windows standard DLL

GCC32

gcc v3.2 (Linux)

GCC34

gcc v3.4 (AIX, HP-UX, Linux)

GCC41

gcc v4.1 (Linux)

GCC46

gcc v4.6 (zLinux)

GCC48

gcc v4.8 (Linux)

GCC83

gcc v8.3 (AIX)

JAVA

Java

MSSQL

SQL Server T-SQL

NET

.NET

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PLSQL

Oracle PL/SQL

PYTHON

Python

RUBY

Ruby

SSIS2005

SSIS 2005 component

SSIS2008

SSIS 2008 component

SSIS2012

SSIS 2012 component

SSIS2014

SSIS 2014 component

SSIS2016

SSIS 2016 component

SSIS2017

SSIS 2017 component

SSIS2019

SSIS 2019 component

SSIS2022

SSIS 2022 component

WINDOWS

Windows

WS12

Solaris native compiler

WS6

Solaris native compiler

XLC12

AIX native compiler

XLC6

AIX native compiler

{{filename}}

Name of File.

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
{
  "FileName": "mdGeo.dll",
  "Release": "2024.03",
  "BuildNumber": "4.0.1.17390",
  "FileSize": "1653608",
  "OS": "WINDOWS",
  "Compiler": "DLL",
  "Architecture": "64BIT",
  "MD5": "aacfa224e7b5734592f65594ab64d50e",
  "SHA1": "c80c990d2ead209f68665f8b4296961438d1f64a",
  "SHA256": "c9eb970ee534ebe9ff9894aa0a7d2959bc8856a81d84bb694de11d39dbedd641"
}

Retrieve Metadata for Data File#

/Metadata/Data/{{release}}/{{filename}}#

Use this endpoint to retrieve metadata for a given file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Metadata/Data\
/LATEST\
/ews.txt\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{filename}}

Name of File.

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
{
  "FileName": "Congress.csv",
  "Release": "2024.01",
  "BuildDate": "2023-12",
  "FileSize": "45995",
  "MD5": "c42cd3b9f31e5a54a395c9b1b6455d5a",
  "SHA1": "f9e23f670f82c1e440fb78d8e1f1f6b4fd603356",
  "SHA256": "ec0d336cbfdd4bc4ee0ae39d997b1604819f6942f216a0b3eb62f3a718bed560"
}

Retrieve Metadata for Language Interface File#

/Metadata/Interface/{{os}}/{{language}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to retrieve metadata for a given file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Metadata/Interface\
/ANY\
/NET\
/ANY\
/LATEST\
/mdAddr_cSharpCode.cs\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{filename}}

Name of File.

{{language}}

Describes the language interface.

Code

Description

NET

.NET

C

C/C++

JAVA

Java

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PYTHON

Python

RUBY

Ruby

PLSQL

Oracle PL/SQL

MSSQL

SQL Server T-SQL

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
{
  "FileName": "mdAddr_cSharpCode.cs",
  "Release": "2024.01",
  "FileSize": "99767",
  "Language": "NET",
  "Architecture": "ANY",
  "MD5": "250568c3798c8a51f948bc6291490cc3",
  "SHA1": "b4dfe0d63c67c3d1454a32e344c8e51e326f715a",
  "SHA256": "e93a0e7474db0d49dbf1fa57ecccec145bfc6f22974d3bad9ae05710b1e640bb"
}

Retrieve Metadata for Product File#

/Metadata/Product/{{release}}/{{productname}}#

Use this endpoint to retrieve metadata for a given product file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net/Metadata/Product\
/LATEST\
/DataQualitySuite\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{productname}}

The name of the target product.

Code

CanadianGeoData

DataQualityComponents-SSIS

DataQualitySuite

FoneData

Geocoder

GeoData

GlobalMatchUp

mdCanada

mdELOT

MP4

RightFielder

ZipData

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
{
  "FileName": "DataQualitySuite",
  "Release": "2024.10",
  "BuildDate": "2024-10",
  "FileSize": "9959574360",
  "MD5": "08658a02dd97703cc11b76b1b3bf821c",
  "SHA1": "362b34f52b74037bb443a226ac5b728c679a8a24",
  "SHA256": "15615dd2243b25118b76d66598ba4a42218e60b6b93c21d115255cf491d7a599"
}

Retrieve Hashes for a Specific File#

Retrieve Hash Value for Binary File#

/{{hashtype}}/Library/{{os}}/{{compiler}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to retrieve a hash of a specified type for a given file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net\
/SHA256\
/LIBRARY\
/WINDOWS\
/NET\
/ANY\
/LATEST\
/MelissaUpdater.exe\
?&id={{customerId}}\
&format=json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{compiler}}

Describes the target compiler.

Code

Description

ACC3

HP-UX native compiler

ANY

Any compiler

C

C/C++

COM

Windows COM DLL

DLL

Windows standard DLL

GCC32

gcc v3.2 (Linux)

GCC34

gcc v3.4 (AIX, HP-UX, Linux)

GCC41

gcc v4.1 (Linux)

GCC46

gcc v4.6 (zLinux)

GCC48

gcc v4.8 (Linux)

GCC83

gcc v8.3 (AIX)

JAVA

Java

MSSQL

SQL Server T-SQL

NET

.NET

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PLSQL

Oracle PL/SQL

PYTHON

Python

RUBY

Ruby

SSIS2005

SSIS 2005 component

SSIS2008

SSIS 2008 component

SSIS2012

SSIS 2012 component

SSIS2014

SSIS 2014 component

SSIS2016

SSIS 2016 component

SSIS2017

SSIS 2017 component

SSIS2019

SSIS 2019 component

SSIS2022

SSIS 2022 component

WINDOWS

Windows

WS12

Solaris native compiler

WS6

Solaris native compiler

XLC12

AIX native compiler

XLC6

AIX native compiler

{{filename}}

Name of File.

{{hashtype}}

The algorithm used to generate a hash value.

Code

MD5

SHA1

SHA256

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
c9eb970ee534ebe9ff9894aa0a7d2959bc8856a81d84bb694de11d39dbedd641

Retrieve Hash Value for Data File#

/{{hashtype}}/Data/{{release}}/{{filename}}#

Use this endpoint to retrieve a hash of a specified type for a given file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net\
/SHA256\
/DATA\
/LATEST\
/ews.txt\
?&id={{customerId}}\
&format=json"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

format

Desired Format of Response.

Code

Description

crLfList

Default. File list delimited by CR/LF.

lfList

File list delimited by LF.

comma

comma delimited list.

tab

tab delimited list.

json

JSON serialized list.

xml

XML serialized list.

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{filename}}

Name of File.

{{hashtype}}

The algorithm used to generate a hash value.

Code

MD5

SHA1

SHA256

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
ec0d336cbfdd4bc4ee0ae39d997b1604819f6942f216a0b3eb62f3a718bed560

Retrieve Hash Value for Language Interface File#

/{{hashtype}}/Interface/{{os}}/{{language}}/{{architecture}}/{{release}}/{{filename}}#

Use this endpoint to retrieve a hash of a specified type for a given interface file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net\
/SHA256\
/INTERFACE\
/ANY\
/NET\
/ANY\
/LATEST\
/mdAddr_cSharpCode.cs\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{architecture}}

Describes the target architecture (ie, ‘bitness’). Used for object binaries and language interface binaries on certain OS platforms.

Code

32BIT

64BIT

ANY

{{filename}}

Name of File.

{{hashtype}}

The algorithm used to generate a hash value.

Code

MD5

SHA1

SHA256

{{language}}

Describes the language interface.

Code

Description

NET

.NET

C

C/C++

JAVA

Java

PERL

Perl

PHP

PHP (legacy, prior to v7)

PHP7

PHP v7

PYTHON

Python

RUBY

Ruby

PLSQL

Oracle PL/SQL

MSSQL

SQL Server T-SQL

{{os}}

Describes the target OS. Used for object binaries and language interface binaries.

Code

Description

AIX

AIX PowerPC

ANY

Any OS

HPUX_IT

HP-UX ia64

HPUX_PA

HP-UX RISC

LINUX

Linux Redhat

SOLARIS

Solaris Sparc

WINDOWS

Windows

ZLINUX

IBM zLinux

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Headers#
  • GET JSON
Content-Type: application/json
Accept: application/json
Response#
  • GET JSON
e93a0e7474db0d49dbf1fa57ecccec145bfc6f22974d3bad9ae05710b1e640bb

Retrieve Hash Value for Product File#

/{{hashtype}}/Product/{{release}}/{{productname}}#

Use this endpoint to retrieve a hash of a specified type for a given product file and release.

Try It Now#
  • GET JSON
curl -X GET "https://releases.melissadata.net\
/SHA256\
/PRODUCT\
/LATEST\
/DataQualitySuite\
?&id={{customerId}}"
Request Parameters#
  • GET JSON

Code

Description

Record Level Parameters

id

The License Key issued by Melissa (Encrypted).

Path Parameters

{{hashtype}}

The algorithm used to generate a hash value.

Code

MD5

SHA1

SHA256

{{productname}}

The name of the target product.

Code

CanadianGeoData

DataQualityComponents-SSIS

DataQualitySuite

FoneData

Geocoder

GeoData

GlobalMatchUp

mdCanada

mdELOT

MP4

RightFielder

ZipData

{{release}}

Specific Release. This can be specified in several ways.

Code

Description

YYYY.MM OR YYYY-MM

(year, month)

YYYY.QQ

(year, quarter)

[metaReleaseName]

Release name, for example: latest

Response#
  • GET JSON
15615dd2243b25118b76d66598ba4a42218e60b6b93c21d115255cf491d7a599