CIRCL hashlookup
App · 6 actions
Check whether a file is known with CIRCL hashlookup, the free database of billions of files from NIST's NSRL, Linux distributions, Windows builds and app stores run by Luxembourg's CERT: look up an MD5, SHA-1 or SHA-256 to get the file's name, size, product or package, trust score and malware flag, check up to 1,000 hashes at once, list the packages a file ships in and the files inside a package, and see the most looked-up hashes. No account needed.
Actions
| Action | What it does |
|---|---|
| Get database info | Get how many hashes CIRCL hashlookup holds and which release of NIST's NSRL reference data it carries. |
| List files inside a package | List the files known to be inside a package, archive or installer, each with its name, size and hashes. |
| List most looked-up hashes | List the hashes people look up most in CIRCL hashlookup, from its public statistics: either known files, with their names, or hashes it doesn't know, each with how many times it was looked up. |
| List packages containing a file | List the packages, archives and installers known to contain a file, such as the Ubuntu packages and snaps a program ships in, each with its name, version and hashes. |
| Look up a file hash | Check whether a file is known by looking up its MD5, SHA-1 or SHA-256 hash in CIRCL hashlookup, a free database of billions of files from NIST's NSRL, Linux distributions, Windows builds and app stores. |
| Look up many hashes | Look up to 1,000 MD5 and SHA-1 hashes at once, such as every file from a folder or a scan, and get a result for each one plus lists of the known, unknown and malware-listed hashes. |
Get database info
Get how many hashes CIRCL hashlookup holds and which release of NIST's NSRL reference data it carries. Useful for noting what a check was made against.
Inputs
None.
Outputs
datasetslist- Hashes per dataset, when the service lists them
hashlookup_versiontext- The version of the hashlookup service, when it says
nsrl_versiontext- The release of NIST's NSRL reference data it carries, such as 2023.09.2
summarytext- One line with the database's size and NSRL release
total_hashesnumber- How many hashes hashlookup holds
Example output
{
"datasets": [],
"hashlookup_version": null,
"nsrl_version": "2023.09.2",
"summary": "CIRCL hashlookup holds 6,524,574,397 hashes, NSRL release 2023.09.2",
"total_hashes": 6524574397
}List files inside a package
List the files known to be inside a package, archive or installer, each with its name, size and hashes. Use the SHA-1 that List packages containing a file returns, or any hash of the package. Results come a page at a time.
Inputs
- File hash
file_hashtextRequired - The SHA-1, MD5 or SHA-256 of the package, archive or installer. hashlookup keeps these links by SHA-1, so an MD5 or SHA-256 is looked up first to find it.
- Results per page
limitnumber - Optional. From 1 to 1,000; 100 by default.From 1 to 1000. Default:
100. - Next page
cursortext - Optional. To get the page after an earlier one, use Next cursor from that result. Leave blank for the first page.
Outputs
childrenlist- This page of files inside it, in hashlookup's order
countnumber- How many are on this page
has_moretrue/false- True when there is another page
next_cursortext- Put this in Next page to get the next page; empty on the last page
sha1text- The SHA-1 of the file asked about (an MD5 or SHA-256 is looked up to find it); empty when hashlookup doesn't know it
summarytext- One line saying how many were listed, of how many
totalnumber- How many files inside it hashlookup knows in all
Example output
{
"children": [
{
"added_at": "2024-09-22T23:30:02Z",
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": "snap-hashlookup-import/usr/share/man/man1/speed.1ssl.gz",
"file_size": 3085,
"known_malicious": false,
"malicious_source": null,
"md5": "BC7B9A6016097DD1363765FC05D1B514",
"mime_type": "application/gzip",
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "024B712A3F59419D34E9D48D85B984E629BE9D61",
"sha256": "79B7AFF1D136B5913DA96432F6CCDB4460B48AC4529ADC83C9293A54091FF38E",
"sha512": null,
"source": "snap:srA99WfCGunEo4R9lGWNTQT1HYa1Zv7h_140",
"ssdeep": null,
"tlsh": null
},
{
"added_at": "2026-01-26T10:59:46Z",
"application_type": null,
"crc32": "F96C9AB9",
"database": "nsrl_modern_rds",
"download_url": null,
"file_name": "./usr/share/doc/openssl/HOWTO/keys.txt",
"file_size": 3653,
"known_malicious": false,
"malicious_source": null,
"md5": "86C11189191EC40ED9565CFC56B18F65",
"mime_type": "text/plain",
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "0B6D2EC27D2424E5A2FF1CB5AE11393CEFCA733A",
"sha256": "F1243EB87DB2B3ED7D311E4EEF174B8E08E6350F3C9AD13003F08DF9B54BE9C3",
"sha512": null,
"source": "snap:dp7lGMhTrRDDUpLp8eQooUgAm7L3jqoO_2",
"ssdeep": null,
"tlsh": null
}
],
"count": 2,
"has_more": true,
"next_cursor": "0B6D2EC27D2424E5A2FF1CB5AE11393CEFCA733A",
"sha1": "02ADDB9985B9F21F42072CEA4A3C1A97448C67AC",
"summary": "Listed 2 of the 86 children of 02ADDB9985B9F21F42072CEA4A3C1A97448C67AC",
"total": 86
}List most looked-up hashes
List the hashes people look up most in CIRCL hashlookup, from its public statistics: either known files, with their names, or hashes it doesn't know, each with how many times it was looked up.
Inputs
- Which hashes
statustext - Optional. Known files by default.One of:
known(Known files (in the database)),unknown(Unknown hashes (not in the database)). Default:known. - How many
limitnumber - Optional. From 1 to 100; 25 by default.From 1 to 100. Default:
25.
Outputs
countnumber- How many hashes are listed
hasheslist- The hashes, most looked-up first
statustext- Which list it is: known or unknown
summarytext- One line saying what was listed
Example output
{
"count": 3,
"hashes": [
{
"file_name": null,
"hash": "0A2D170ABBF5031566377B01431E3B82D342630A",
"hash_type": "sha1",
"lookups": 1514397,
"rank": 1
},
{
"file_name": "./usr/share/pnp4nagios/html/media/images/1x1.gif",
"hash": "D5FCEB6532643D0D84FFE09C40C481ECDF59E15A",
"hash_type": "sha1",
"lookups": 568607,
"rank": 2
},
{
"file_name": "usr/share/squid/icons/SN.png",
"hash": "018FB6D1936F14EF0AD204E66D2DB5361D58F703",
"hash_type": "sha1",
"lookups": 557085,
"rank": 3
}
],
"status": "known",
"summary": "The 3 most looked-up known files in CIRCL hashlookup"
}List packages containing a file
List the packages, archives and installers known to contain a file, such as the Ubuntu packages and snaps a program ships in, each with its name, version and hashes. Useful for finding where a file on a system came from. Results come a page at a time.
Inputs
- File hash
file_hashtextRequired - The SHA-1, MD5 or SHA-256 of the file. hashlookup keeps these links by SHA-1, so an MD5 or SHA-256 is looked up first to find it.
- Results per page
limitnumber - Optional. From 1 to 1,000; 100 by default.From 1 to 1000. Default:
100. - Next page
cursortext - Optional. To get the page after an earlier one, use Next cursor from that result. Leave blank for the first page.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when there is another page
next_cursortext- Put this in Next page to get the next page; empty on the last page
parentslist- This page of packages, archives and installers containing the file, in hashlookup's order
sha1text- The SHA-1 of the file asked about (an MD5 or SHA-256 is looked up to find it); empty when hashlookup doesn't know it
summarytext- One line saying how many were listed, of how many
totalnumber- How many packages, archives and installers containing the file hashlookup knows in all
Example output
{
"count": 3,
"has_more": true,
"next_cursor": "02ADDB9985B9F21F42072CEA4A3C1A97448C67AC",
"parents": [
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": "https://api.snapcraft.io/api/v1/snaps/download/DjI3nhYmq6jeI4qguNI54pgbDZWbUo2N_52.snap",
"file_name": "DjI3nhYmq6jeI4qguNI54pgbDZWbUo2N_52.snap",
"file_size": null,
"known_malicious": false,
"malicious_source": null,
"md5": null,
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": "jhaturanga",
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "0006E05A9FC1F165A94713131592E4269DCB0B5D",
"sha256": null,
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": "https://api.snapcraft.io/api/v1/snaps/download/bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4.snap",
"file_name": "bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4.snap",
"file_size": null,
"known_malicious": false,
"malicious_source": null,
"md5": null,
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": "bytecode-viewer",
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "027EC67FDB1BCB3CA236FEAC0A47334ECE3F5BB0",
"sha256": null,
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": null,
"file_size": 613848,
"known_malicious": false,
"malicious_source": null,
"md5": "124A707963928961F17F873921B0DF13",
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": "Secure Sockets Layer toolkit - cryptographic utility\n This package is part of the OpenSSL project's implementation of the SSL\n and TLS cryptographic protocols for secure communication over the\n Internet.",
"package_maintainer": "Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>",
"package_name": "openssl",
"package_version": "1.1.1-1ubuntu2.1~18.04.13",
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "02ADDB9985B9F21F42072CEA4A3C1A97448C67AC",
"sha256": "E8E123812167819F0D1AD572C85094F13369413A6E3D1127E4A786CC0A31FD0D",
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
}
],
"sha1": "72F104BF11A12511154267328F069FE0541E841E",
"summary": "Listed 3 of the 156 parents of 72F104BF11A12511154267328F069FE0541E841E",
"total": 156
}Look up a file hash
Check whether a file is known by looking up its MD5, SHA-1 or SHA-256 hash in CIRCL hashlookup, a free database of billions of files from NIST's NSRL, Linux distributions, Windows builds and app stores. A known file comes back with its name, size, every hash, the product or package it ships with, a trust score and some of the packages it is in; an unknown one comes back with Found set to false instead of failing the step. Being known doesn't make a file safe by itself: check Known malicious and the trust score too.
Inputs
- File hash
file_hashtextRequired - The file's MD5, SHA-1 or SHA-256, in capitals or not. Which kind it is is worked out from its length.
Outputs
added_attext- When hashlookup added the record (ISO 8601, UTC)
application_typetext- NSRL's kind of product, such as Operating System
child_countnumber- How many known files the file contains
childrenlist- Up to 15 of the files inside it (a random 10 when there are more). List files inside a package gets them all.
crc32text- The file's CRC32 checksum
databasetext- The NSRL set it came from, such as nsrl_modern_rds
download_urltext- Where the package can be downloaded, for a snap
file_nametext- The file's name or path where it was seen, such as ./usr/bin/openssl
file_sizenumber- The file's size in bytes
foundtrue/false- True when hashlookup knows the file
hashtext- The hash that was looked up, in capitals
hash_typetext- What kind of hash it is: md5, sha1 or sha256
known_malicioustrue/false- True when a malware feed lists this file
malicious_sourcetext- The malware feed that lists it, such as malshare.com
md5text- The file's MD5 hash
mime_typetext- The kind of file, such as application/x-sharedlib
os_nametext- The operating system NSRL lists for the file
os_versiontext- That operating system's version
package_architecturetext- That package's processor type, such as x86_64
package_descriptiontext- What that package is, in its own words
package_maintainertext- Who maintains that package
package_nametext- The Linux package or snap the record is, or the file comes from
package_versiontext- That package's version
parent_countnumber- How many known packages, archives or installers contain the file
parentslist- Up to 15 of the packages that contain the file (a random 10 when there are more). List parent files gets them all.
product_languagetext- That product's language, such as English
product_nametext- The NSRL product the file ships with, such as a Windows update
product_versiontext- That product's version
sha1text- The file's SHA-1 hash
sha256text- The file's SHA-256 hash
sha512text- The file's SHA-512 hash
sourcetext- Where hashlookup found the file, such as NSRL or snap:<snap id>
ssdeeptext- The file's ssdeep fuzzy hash, for finding similar files
summarytext- One line saying what the file is, or that it is unknown
tlshtext- The file's TLSH fuzzy hash, for finding similar files
trustnumber- hashlookup's trust score from 0 to 100: 50 means no opinion, higher means seen in more packages, lower means a malware feed lists it
trust_verdicttext- The trust score in words: more trusted, no opinion or less trusted
Example output
{
"added_at": "2025-11-18T15:46:27Z",
"application_type": null,
"child_count": 0,
"children": [],
"crc32": null,
"database": null,
"download_url": null,
"file_name": "snap-hashlookup-import/usr/bin/openssl",
"file_size": 723944,
"found": true,
"hash": "301C9EC7A9AADEE4D745E8FD4FA659DAFBBCC6B75B9FF491D14CBBDD840814E9",
"hash_type": "sha256",
"known_malicious": false,
"malicious_source": null,
"md5": "34D827A288FA51B93297EF2A8A43B769",
"mime_type": "application/x-sharedlib",
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"parent_count": 156,
"parents": [
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": "https://api.snapcraft.io/api/v1/snaps/download/DjI3nhYmq6jeI4qguNI54pgbDZWbUo2N_52.snap",
"file_name": "DjI3nhYmq6jeI4qguNI54pgbDZWbUo2N_52.snap",
"file_size": null,
"known_malicious": false,
"malicious_source": null,
"md5": null,
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": "jhaturanga",
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "0006E05A9FC1F165A94713131592E4269DCB0B5D",
"sha256": null,
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": "https://api.snapcraft.io/api/v1/snaps/download/bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4.snap",
"file_name": "bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4.snap",
"file_size": null,
"known_malicious": false,
"malicious_source": null,
"md5": null,
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": "bytecode-viewer",
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "027EC67FDB1BCB3CA236FEAC0A47334ECE3F5BB0",
"sha256": null,
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": null,
"file_size": 613848,
"known_malicious": false,
"malicious_source": null,
"md5": "124A707963928961F17F873921B0DF13",
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": "Secure Sockets Layer toolkit - cryptographic utility\n This package is part of the OpenSSL project's implementation of the SSL\n and TLS cryptographic protocols for secure communication over the\n Internet.",
"package_maintainer": "Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>",
"package_name": "openssl",
"package_version": "1.1.1-1ubuntu2.1~18.04.13",
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "02ADDB9985B9F21F42072CEA4A3C1A97448C67AC",
"sha256": "E8E123812167819F0D1AD572C85094F13369413A6E3D1127E4A786CC0A31FD0D",
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
}
],
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "72F104BF11A12511154267328F069FE0541E841E",
"sha256": "301C9EC7A9AADEE4D745E8FD4FA659DAFBBCC6B75B9FF491D14CBBDD840814E9",
"sha512": "2533D682DB224F0D3BEA043A8A986DC1D341FBEFFD158CB97CD360190BE091F43CC6DBF07E6E985CC0DCE17ADC207A61AC9831BE91099202093ACFED584602D1",
"source": "snap:bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4",
"ssdeep": "12288:g7LKf6QceJ83r69SOPdxouwUnSysbLY+YR2L7b+3l7E71rb/t:gsceJ83rESOlxJwUZsbLY+YR2Xa3l7E7",
"summary": "Known file: snap-hashlookup-import/usr/bin/openssl, 723,944 bytes, trust 100/100, inside 156 known packages",
"tlsh": "T150F4281AE64719BDC8B2C230455B50327A31B945F332BF6B26C196311E42B1EA73FBE5",
"trust": 100,
"trust_verdict": "more trusted"
}Look up many hashes
Look up to 1,000 MD5 and SHA-1 hashes at once, such as every file from a folder or a scan, and get a result for each one plus lists of the known, unknown and malware-listed hashes. Output from md5sum or sha1sum works as it is. Look up a SHA-256 with Look up a file hash instead.
Inputs
- Hashes
hasheslistRequired - Up to 1,000 MD5 and SHA-1 hashes: a list from an earlier step, or hashes separated by commas or new lines. Lines with a hash and then a file name, as md5sum and sha1sum write them, are fine.
Outputs
checkednumber- How many different hashes were looked up
found_countnumber- How many are known files
found_hasheslist- The hashes of known files
known_malicious_hasheslist- The hashes a malware feed lists
not_found_countnumber- How many hashlookup doesn't know
not_found_hasheslist- The hashes hashlookup doesn't know
resultslist- One result for each different hash, in the order given
summarytext- One line saying how many were found
Example output
{
"checked": 4,
"found_count": 3,
"found_hashes": [
"8ED4B4ED952526D89899E723F3488DE4",
"72F104BF11A12511154267328F069FE0541E841E",
"9B6C3518A91D23ED77504B5416BFB5B3"
],
"known_malicious_hashes": [
"9B6C3518A91D23ED77504B5416BFB5B3"
],
"not_found_count": 1,
"not_found_hashes": [
"00000000000000000000000000000001"
],
"results": [
{
"added_at": "2022-03-11T05:51:49Z",
"application_type": null,
"crc32": "7A5407CA",
"database": "nsrl_modern_rds",
"download_url": null,
"file_name": "wow64_microsoft-windows-i..timezones.resources_31bf3856ad364e35_10.0.16299.579_de-de_f24979c73226184d.manifest",
"file_size": 2520,
"found": true,
"hash": "8ED4B4ED952526D89899E723F3488DE4",
"hash_type": "md5",
"known_malicious": false,
"malicious_source": null,
"md5": "8ED4B4ED952526D89899E723F3488DE4",
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "00000079FD7AAC9B2F9C988C50750E1F50B27EB5",
"sha256": null,
"sha512": null,
"source": "NSRL",
"ssdeep": null,
"tlsh": null
},
{
"added_at": "2025-11-18T15:46:27Z",
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": "snap-hashlookup-import/usr/bin/openssl",
"file_size": 723944,
"found": true,
"hash": "72F104BF11A12511154267328F069FE0541E841E",
"hash_type": "sha1",
"known_malicious": false,
"malicious_source": null,
"md5": "34D827A288FA51B93297EF2A8A43B769",
"mime_type": "application/x-sharedlib",
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "72F104BF11A12511154267328F069FE0541E841E",
"sha256": "301C9EC7A9AADEE4D745E8FD4FA659DAFBBCC6B75B9FF491D14CBBDD840814E9",
"sha512": "2533D682DB224F0D3BEA043A8A986DC1D341FBEFFD158CB97CD360190BE091F43CC6DBF07E6E985CC0DCE17ADC207A61AC9831BE91099202093ACFED584602D1",
"source": "snap:bNNkzjNJvvbhGfm80hDhQTFdHzkfJEYB_4",
"ssdeep": "12288:g7LKf6QceJ83r69SOPdxouwUnSysbLY+YR2L7b+3l7E71rb/t:gsceJ83rESOlxJwUZsbLY+YR2Xa3l7E7",
"tlsh": "T150F4281AE64719BDC8B2C230455B50327A31B945F332BF6B26C196311E42B1EA73FBE5"
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": null,
"file_size": null,
"found": false,
"hash": "00000000000000000000000000000001",
"hash_type": "md5",
"known_malicious": false,
"malicious_source": null,
"md5": null,
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": null,
"sha256": null,
"sha512": null,
"source": null,
"ssdeep": null,
"tlsh": null
},
{
"added_at": null,
"application_type": null,
"crc32": null,
"database": null,
"download_url": null,
"file_name": null,
"file_size": null,
"found": true,
"hash": "9B6C3518A91D23ED77504B5416BFB5B3",
"hash_type": "md5",
"known_malicious": true,
"malicious_source": "malshare.com",
"md5": "9B6C3518A91D23ED77504B5416BFB5B3",
"mime_type": null,
"os_name": null,
"os_version": null,
"package_architecture": null,
"package_description": null,
"package_maintainer": null,
"package_name": null,
"package_version": null,
"product_language": null,
"product_name": null,
"product_version": null,
"sha1": "0A2D170ABBF5031566377B01431E3B82D342630A",
"sha256": "A04AC6D98AD989312783D4FE3456C53730B212C79A426FB215708B6C6DAA3DE3",
"sha512": null,
"source": null,
"ssdeep": "1536:87VBQ1LGAXSEYQJBCHAAU2YU23M51DJZGSQAVCYKFTZTJZBHT5:8D+CAXFYQCHAAUK5LJNQSSL",
"tlsh": null
}
],
"summary": "Found 3 of 4 hashes in CIRCL hashlookup; 1 listed as malicious"
}