{sha256}: Lookup file by SHA256 hash

API: circl.lu:hashlookup-circl-api
Endpoint: /lookup/sha256/{sha256}
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 137ms

Description

Returns comprehensive file metadata including filename, size, package associations, and parent containers if the SHA256 hash exists in the database. Use this to identify files by their SHA256 hash and find which software packages contain them.

From spec: Lookup a file by its SHA256 hash. Returns file metadata including name, size, associated packages, and parent containers if the hash is found in the database.

Usage Tips

- Input must be a valid 64-character hexadecimal SHA256 hash - Case-insensitive: 'abc' and 'ABC' are equivalent - Returns 200 OK with 'hashlookup:trust' field even for unknown hashes (check parents array) - Rate limit: Be respectful of the public service

Parameters (1)

sha256 (string, path, required)

SHA256 hash in hexadecimal format (64 characters)

Constraints: {'pattern': '^[a-fA-F0-9]{64}$'}

Examples (1)

Lookup SHA256 hash of empty file probe-gate

Demonstrates looking up a file by its SHA256 hash (hash of empty file)

curl 'https://hashlookup.circl.lu/lookup/sha256/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'
import requests

resp = requests.get("https://hashlookup.circl.lu/lookup/sha256/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855")
data = resp.json()
import zingu_apis

api = zingu_apis.api("circl")
result = api.fetch("lookup/sha256/{sha256}")

for item in result:
    print(item)
const resp = await fetch("https://hashlookup.circl.lu/lookup/sha256/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 00:19:25.668291 200 137ms
2026-04-15 03:25:40.020993 200 128ms
2026-04-14 00:06:12.022741 200 168ms
2026-04-12 14:19:57.373640 200 139ms
2026-04-10 02:38:58.062701 200 109ms
2026-04-09 01:43:49.004084 200 156ms
2026-04-08 07:29:17.009884 200 125ms
2026-04-07 01:32:28.628764 200 177ms