Overview (v2)

This documentation provides an overview of the Integritas API v2, which enables both uploading and verification of data file hashes against the blockchain. It supports optional NFT traceability and returns structured results that include on-chain validation details. Use this guide to understand endpoints, request formats, and how to interpret the verification responses.

Base URL

All v2 API requests are made to the following base URL:

https://integritas.minima.global/core/v2

Example

To make a request to the "Verify file" endpoint, you would use:

https://integritas.minima.global/core/v2/verify/file

Authentication

Authentication is required and done through the use of API keys. Get yours at https://integritas.technology/.

Endpoints Overview

There are three available v2 endpoints.

Stamp file - Submit a hash (or check if it already exists). Returns verification data when the hash is already on-chain.
File check - Check whether a hash exists on the blockchain. Returns a simple found/not-found result.
Verify file - Verify a file by sending its hash. Returns verification results and optionally a PDF report when x-report-required is set.

Quick Reference

Endpoint	Method	Path	When to Use
Stamp file	`POST`	`/v2/timestamp/post`	Submit a hash or get verification data if the hash already exists on-chain.
File check	`POST`	`/v2/file/check`	Check if a hash exists on the blockchain.
Verify file	`POST`	`/v2/verify/file`	Verify a file by hash; optionally request a PDF verification report.

For details on the response envelopes and field structures used by these endpoints, see the API Response Schema.