Verify File

Verify a file by sending its hash. Returns verification results and optionally a PDF report when x-report-required is set.

Attribute	Details
Method	`POST`
Description	This endpoint verifies a file by hash against the blockchain. Send the hash as JSON in the body. Optionally request a PDF report.
Endpoint	`https://integritas.technology/core/v2/verify/file`

Request Headers

Header	Value	Description
Content-Type	`application/json`	Specifies the content type as JSON
x-api-key	`your-api-key`	Add your API-key from your profile at https://integritas.technology/
x-report-required	`true` / `false`	Request NFT trace from the verification process
x-request-id	`your-choice`	Add a request id to trace every step of the process

Request Body

Request Type	Content-Type	Body Type	Keys	Description
Raw data	`application/json`	`JSON`	`hash`	Input hash of file
Raw data	`application/json`	`JSON`	`filename`	Optional. File name
Raw data	`application/json`	`JSON`	`filesize`	Optional. File size (bytes)

When provided, filename and filesize are used in the PDF report and in matched segments (the full file will be treated as one segment).

Example

{
  "hash": "106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B",
  "filename": "test",
  "filesize": 5
}

Request Examples

curl -X POST https://integritas.minima.global/core/v2/verify/file \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -H "x-report-required: true" \
  -H "x-request-id: your-choice" \
  -d '{"hash":"106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B"}'

API Demo

Try the endpoint with your own API key and hash. The request is sent directly to the API, and the response is displayed below.

Your API key is only used for this request and is not stored.

API Response

The response contains verification results and optionally a PDF report download when x-report-required is set.

Example Response (Full Match with Report)

{
  "service": "CORE_API",
  "apiVersion": 2,
  "requestId": "POSTMAN",
  "status": "success",
  "statusCode": 200,
  "message": "Verification complete - PDF uploaded",
  "timestamp": "2026-01-29T13:54:50.427Z",
  "data": {
    "service": "SEARCH_API",
    "apiVersion": 2,
    "requestId": "POSTMAN",
    "responseTime": "3346.43 ms",
    "data": {
      "fileHash": "106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B",
      "fileName": "",
      "fileSize": 0,
      "result": "full match",
      "nftCoinId": "0xB2E182C1AA0635BDD1154EEB9C6512CA73568D09B59DE3E1831517241ABC5A96",
      "nftTxnId": "0x00000370B400925F2B5F196D212ACCCF6A8E993A28F90AACAC2520A5C3CCFCF4",
      "method": "file",
      "uniqueHashes": 1,
      "blockchainData": [
        {
          "blockNumber": 1906787,
          "blockDate": "2026-01-21T09:55:48.726Z",
          "txpowId": "0x00000019299334C6E083683292728F7F1459FCF14A16623F3CE2A77BA343E57F",
          "transactionId": "0x000011381DB9843340378BE44167704EC286BC2A7B63693CD945E619781AF48E",
          "matchedHash": "106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B"
        },
        {
          "blockNumber": 1903587,
          "blockDate": "2026-01-19T13:39:24.252Z",
          "txpowId": "0x0000000B72C97E1F756F29078F481ED8ABED2398F7D0E614A1ECC17C81B4C1D2",
          "transactionId": "0x000016C4EBCB9F50D6C7DAF8B6A74B388B7AA841378B1CA234499486EA9BC372",
          "matchedHash": "106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B"
        }
      ],
      "fileSegments": [
        {
          "matchedHash": "106F1589B5818A400679A87A19214C43605DEC3EBFDD61E45A776A81C120DD9B",
          "offset": 0,
          "packetSize": 0
        }
      ]
    },
    "file": {
      "fileName": "verification-report-2026-01-29T13-54-50-415Z.pdf",
      "downloadUrl": "https://integritas.technology/files/reports/verification-report-2026-01-29T13-54-50-415Z.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=integritas%2F20260129%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260129T135450Z&X-Amz-Expires=3600&X-Amz-Signature=0c2563cf51198ca36db2a00c575f1aba9fef8e354d253653fd95e627658af2db&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%3D%22verification-report-2026-01-29T13-54-50-415Z.pdf%22&x-amz-checksum-mode=ENABLED&x-id=GetObject",
      "fileSize": 78082,
      "expiresIn": "1 hour",
      "bucket": "reports"
    }
  }
}