Skip to content
/
Retrieve Metadata for a S...

Melissa Releases

Overview

Melissa Releases allows you to securely and efficiently download data files, object binaries, and other collateral files from Melissa. This service enables you to automate the process of updating your data and APIs by scripting the download of specific files rather than downloading the entire zip archive. File versioning is also provided, if needed, making it easier to download historical data or builds.

Melissa Releases can be used to:

  • Automate database updates.
  • Check for updates for specific products.
  • Securely download data files.
  • Download only needed files, saving space and time.
  • Download historical data as needed.

Documentation

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
melissa-releases.json
melissa-releases.yaml
Languages
Servers
Melissa Releases Server
https://releases.melissadata.net/

Use it from a Web Browser

Use this endpoint to view a list of files in a web browser.

Operations

Download a Specific File

Use this endpoint to download a file.

Operations

Retrieve Available Release Version Numbers

Use this endpoint to get a list of all available release versions.

Operations

Retrieve a List of Files from a Specific Manifest

Use this endpoint to get a list of download links for all files in a manifest.

Operations

Retrieve a List of Manifests from a Specific Release Version Number

Use this endpoint to get a list of available manifests for a release version.

Operations

Retrieve Metadata for a Specific File

Use this endpoint to get the metadata of a file.

Operations

Retrieve Metadata for Binary File

Request

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

Path
architecturestringrequired

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

Enum"32BIT""64BIT""ANY"
Example: ANY
compilerstringrequired

Describes the target compiler.

  • 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
Enum"ACC3""ANY""C""COM""DLL""GCC32""GCC34""GCC41""GCC46""GCC48"
Example: NET
filenamestringrequired

Name of File.

Example: MelissaUpdater.exe
osstringrequired

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

  • 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
Enum"AIX""ANY""HPUX_IT""HPUX_PA""LINUX""SOLARIS""WINDOWS""ZLINUX"
Example: WINDOWS
releasestringrequired

Specific Release. This can be specified in several ways.

  • YYYY.MM OR YYYY-MM - (year, month)
  • YYYY.QQ - (year, quarter)
  • [metaReleaseName] - Release Name, for example: latest
Example: LATEST
Query
formatstring

Desired Format of Response.

  • 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.
Enum"crLfList""lfList""comma""tab""json""xml"
Example: format=json
idany(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
curl -i -X GET \
  'https://releases.melissadata.net/Metadata/Library/WINDOWS/NET/ANY/LATEST/MelissaUpdater.exe?id={REPLACE-WITH-YOUR-LICENSE-KEY}'

Responses

Successful response.

Bodyapplication/json
FileNamestring
Example: "mdGeo.dll"
Releasestring
Example: "2024.03"
BuildNumberstring
Example: "4.0.1.17390"
FileSizestring
Example: "1653608"
OSstring
Example: "WINDOWS"
Compilerstring
Example: "DLL"
Architecturestring
Example: "64BIT"
MD5string
Example: "aacfa224e7b5734592f65594ab64d50e"
SHA1string
Example: "c80c990d2ead209f68665f8b4296961438d1f64a"
SHA256string
Example: "c9eb970ee534ebe9ff9894aa0a7d2959bc8856a81d84bb694de11d39dbedd641"
Response
application/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

Request

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

Path
filenamestringrequired

Name of File.

Example: ews.txt
releasestringrequired

Specific Release. This can be specified in several ways.

  • YYYY.MM OR YYYY-MM - (year, month)
  • YYYY.QQ - (year, quarter)
  • [metaReleaseName] - Release Name, for example: latest
Example: LATEST
Query
idany(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
curl -i -X GET \
  'https://releases.melissadata.net/Metadata/Data/LATEST/ews.txt?id={REPLACE-WITH-YOUR-LICENSE-KEY}'

Responses

Successful response.

Bodyapplication/json
FileNamestring
Example: "Congress.csv"
Releasestring
Example: "2024.01"
BuildDatestring
Example: "2023-12"
FileSizestring
Example: "45995"
MD5string
Example: "c42cd3b9f31e5a54a395c9b1b6455d5a"
SHA1string
Example: "f9e23f670f82c1e440fb78d8e1f1f6b4fd603356"
SHA256string
Example: "ec0d336cbfdd4bc4ee0ae39d997b1604819f6942f216a0b3eb62f3a718bed560"
Response
application/json
{
  "FileName": "Congress.csv",
  "Release": "2024.01",
  "BuildDate": "2023-12",
  "FileSize": "45995",
  "MD5": "c42cd3b9f31e5a54a395c9b1b6455d5a",
  "SHA1": "f9e23f670f82c1e440fb78d8e1f1f6b4fd603356",
  "SHA256": "ec0d336cbfdd4bc4ee0ae39d997b1604819f6942f216a0b3eb62f3a718bed560"
}

Retrieve Metadata for Language Interface File

Request

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

Path
architecturestringrequired

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

Enum"32BIT""64BIT""ANY"
Example: ANY
filenamestringrequired

Name of File.

Example: mdAddr_cSharpCode.cs
languagestringrequired

Describes the language interface.

  • 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
Enum"NET""C""JAVA""PERL""PHP""PHP7""PYTHON""RUBY""PLSQL""MSSQL"
Example: NET
osstringrequired

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

  • 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
Enum"AIX""ANY""HPUX_IT""HPUX_PA""LINUX""SOLARIS""WINDOWS""ZLINUX"
Example: ANY
releasestringrequired

Specific Release. This can be specified in several ways.

  • YYYY.MM OR YYYY-MM - (year, month)
  • YYYY.QQ - (year, quarter)
  • [metaReleaseName] - Release Name, for example: latest
Example: LATEST
Query
idany(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
curl -i -X GET \
  'https://releases.melissadata.net/Metadata/Interface/ANY/NET/ANY/LATEST/mdAddr_cSharpCode.cs?id={REPLACE-WITH-YOUR-LICENSE-KEY}'

Responses

Successful response.

Bodyapplication/json
FileNamestring
Example: "mdAddr_cSharpCode.cs"
Releasestring
Example: "2024.01"
FileSizestring
Example: "99767"
Languagestring
Example: "NET"
Architecturestring
Example: "ANY"
MD5string
Example: "250568c3798c8a51f948bc6291490cc3"
SHA1string
Example: "b4dfe0d63c67c3d1454a32e344c8e51e326f715a"
SHA256string
Example: "e93a0e7474db0d49dbf1fa57ecccec145bfc6f22974d3bad9ae05710b1e640bb"
Response
application/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

Request

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

Path
productnamestringrequired

The name of the target product.

Enum"CanadianGeoData""DataQualityComponents-SSIS""DataQualitySuite""FoneData""Geocoder""GeoData""GlobalMatchUp""mdCanada""mdELOT""MP4"
Example: DataQualitySuite
releasestringrequired

Specific Release. This can be specified in several ways.

  • YYYY.MM OR YYYY-MM - (year, month)
  • YYYY.QQ - (year, quarter)
  • [metaReleaseName] - Release Name, for example: latest
Example: LATEST
Query
idany(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
curl -i -X GET \
  'https://releases.melissadata.net/Metadata/Product/LATEST/DataQualitySuite?id={REPLACE-WITH-YOUR-LICENSE-KEY}'

Responses

Successful response.

Bodyapplication/json
FileNamestring
Example: "mdAddr_cSharpCode.cs"
Releasestring
Example: "2024.01"
FileSizestring
Example: "99767"
Languagestring
Example: "NET"
Architecturestring
Example: "ANY"
MD5string
Example: "250568c3798c8a51f948bc6291490cc3"
SHA1string
Example: "b4dfe0d63c67c3d1454a32e344c8e51e326f715a"
SHA256string
Example: "e93a0e7474db0d49dbf1fa57ecccec145bfc6f22974d3bad9ae05710b1e640bb"
Response
application/json
{
  "FileName": "mdAddr_cSharpCode.cs",
  "Release": "2024.01",
  "FileSize": "99767",
  "Language": "NET",
  "Architecture": "ANY",
  "MD5": "250568c3798c8a51f948bc6291490cc3",
  "SHA1": "b4dfe0d63c67c3d1454a32e344c8e51e326f715a",
  "SHA256": "e93a0e7474db0d49dbf1fa57ecccec145bfc6f22974d3bad9ae05710b1e640bb"
}

Retrieve Hashes for a Specific File

Use this endpoint to get the hash of a file.

Operations