Generate an ISCC for a file
Uploads a file and returns its ISCC-CODE (Meta, Content, Data and Instance units). Send the raw file bytes as the request body and the base64-encoded original filename in the X-Upload-Filename header. Supported media: images, text documents (plain text, PDF, DOCX, EPUB, ...), audio and video; unsupported types return 422. The file is only fingerprinted and is deleted from the service within minutes.
No API key is required. Requests are rate limited to 30 per minute per IP and the body is capped at 200 MB.
Headers
X-Upload-Filenamestring · requiredOriginal filename, base64 encoded (UTF-8). Used for media-type detection and the Meta-Code.
Responses
ISCC generated
isccstring · requiredComposite ISCC-CODE
namestringdescriptionstringmodestring · enumEnum values:textimageaudiovideomixedmediatypestringfilenamestringfilesizeintegerwidthintegerheightintegerdurationnumberthumbnailstringData URL of an auto-generated preview (images, video, PDF)
datahashstringmetahashstringunitsstring[]Full-length ISCC-UNITs the composite code was built from
Decode an ISCC
Decodes an ISCC-CODE (or a single ISCC-UNIT) into its units with readable, hex, integer and bit representations.
path Parameters
codestring · requiredThe ISCC to decode, with or without the
ISCC:prefix.
Headers
Authorizationstring · requiredBearer token for authentication (e.g.,
Bearer <your-api-key>)
Responses
Decoded ISCC
isccstringreadablestringmultiformatstringdecomposedstringunitsobject[]