Search operations for finding declarations by ISCC
Search declarations by ISCC code
GET
https://api.commonsdb.org
/v1/search/{code}
Search for declarations using nearest neighbor search based on ISCC content hash. Returns declarations with similar content, filtered by a distance threshold. Results exclude redacted declarations and those older than the minimum declaration timestamp.
path Parameters
codestring · pattern:^[A-Z0-9]{55}$· requiredThe ISCC code to search for (without 'ISCC:' prefix). Must be 55 alphanumeric characters.
Headers
Authorizationstring · requiredBearer token for authentication (e.g.,
Bearer <your-api-key>)
Responses
Successful search operation
qstringThe ISCC query that was searched (with ISCC: prefix)
hashBitsstringBinary representation of the content hash bits used for search
invalidCountintegerNumber of results that were filtered out due to invalid data
versionstringAPI version
resultsobject[]Array of matching declarations sorted by similarity score (ascending)