A New World of Functionality Available Via API
Easily connect or create applications that leverage Integra's blockchain document technologies.
What You Can Build
Transform your applications with blockchain-verified document capabilities. Our REST API provides everything you need to register documents as Real World Contracts, verify authenticity in milliseconds, and create tokens bound to legal documents—all without deep blockchain expertise.
Instant Document Registration
Register any document as a Real World Contract with a single API call. Our system computes the integraHash—a unique cryptographic fingerprint—and permanently anchors it to the blockchain. Bulk registration endpoints process thousands of documents per hour, while webhook notifications confirm on-chain settlement in real-time.
Cryptographic Verification
Verify document authenticity by comparing hashes against blockchain records. Our verification endpoint returns results in under 100 milliseconds—fast enough for real-time fraud detection. Pass any document and receive cryptographic proof of whether it matches a registered RWC, when it was registered, and its complete on-chain history.
Token Creation & Management
Create and manage tokens bound to verified documents through purpose-built tokenizer endpoints. Support for ERC-721 (single ownership), ERC-1155 (multi-party), and ERC-20 (fractional) token standards. Reserve tokens for recipients without wallets and automate claims via attestation verification—all through simple REST calls.
Event Webhooks
Receive real-time notifications for document and transaction events. Configure webhooks for registration confirmations, token transfers, attestation updates, and resolver events. Includes retry logic, signature verification, and event filtering to integrate seamlessly with your existing systems.
Production-Ready REST API
Our API follows REST conventions with predictable resource-oriented URLs, JSON request/response bodies, and standard HTTP methods. All endpoints support both synchronous and asynchronous modes for integration flexibility.
Base URL: https://api.trustwithintegra.com/v1
Document Registration Endpoints:
POST /documents # Register single document
POST /documents/batch # Bulk registration (up to 1000)
GET /documents/{integraHash} # Retrieve document record
GET /documents/{integraHash}/tokens # List bound tokensVerification Endpoints:
POST /verify # Verify document hash
POST /verify/batch # Bulk verification
GET /verify/{integraHash}/history # Complete audit trailTokenization Endpoints:
POST /tokens/reserve # Reserve token for recipient
POST /tokens/claim # Claim reserved token
POST /tokens/transfer # Transfer token ownership
GET /tokens/{tokenId} # Token details with RWC bindingAuthentication: All endpoints require API key authentication via the X-API-Key header. Rate limits scale with your plan tier, from 100 requests/minute (free) to unlimited (enterprise).
Response Format: Every response includes the operation status, relevant blockchain transaction hashes, and a processHash correlation ID for enterprise workflow integration.
Client Libraries
Skip the low-level API calls. Our official SDKs handle authentication, retries, type safety, and error handling so you can focus on building your application. Choose your language and start integrating in minutes.
JavaScript/TypeScript SDK
Full-featured SDK for Node.js and browser applications. TypeScript-first with complete type definitions. Supports both CommonJS and ES modules. Built-in wallet integration for signing operations, automatic retry logic, and streaming support for bulk operations. ```javascript import { IntegraClient } from '@integra/sdk'; const client = new IntegraClient({ apiKey: 'your-key' }); const rwc = await client.documents.register(documentHash); ```
Python SDK
Python SDK for data pipelines, backend services, and automation workflows. Async/await support for high-throughput processing. Pandas integration for bulk document operations. Compatible with Python 3.8+ and commonly used in enterprise ETL pipelines. ```python from integra import IntegraClient client = IntegraClient(api_key="your-key") rwc = await client.documents.register(document_hash) ```
Direct REST API
Direct REST API access for any language or platform. OpenAPI 3.0 specification available for automatic client generation in Go, Java, Rust, C#, and 40+ other languages. Postman collection included for rapid testing and exploration.
From API Key to Production
Getting started with the Integra API takes minutes, not days. Follow this proven path from initial setup to production deployment.
Get Your API Key
Sign up for a free developer account and generate your API key instantly. Free tier includes 1,000 API calls per month—enough to build and test your integration. No credit card required, no approval process.
Install SDK
Install the SDK for your language via npm, pip, or direct download. Initialize the client with your API key. The SDK handles authentication, retries, and connection management automatically.
Register First Document
Compute the SHA-256 hash of any document client-side. Call the registration endpoint with the hash. Receive your integraHash—the document's permanent blockchain identity—within seconds.
Verify & Tokenize
Use the verification endpoint to confirm document authenticity. Create tokens bound to your RWC using the tokenization endpoints. Configure webhooks to receive real-time updates on all operations.
Deploy to Production
Upgrade to a paid plan for production rate limits. Enable IP whitelisting and webhook signatures for security. Monitor API usage through the developer dashboard.
Complete Documentation
Our API documentation is designed for developers of all blockchain experience levels. Whether you're a Web3 native or new to blockchain entirely, you'll find clear explanations and working examples.
Interactive API Explorer: Test any endpoint directly in your browser. See live request/response examples, error handling, and webhook payloads without writing code.
Code Examples: Every endpoint includes examples in JavaScript, Python, cURL, and our REST specification. Copy-paste ready code that works immediately.
Enterprise Integration Guides: Step-by-step guides for integrating with Salesforce, SAP, Oracle, and other enterprise platforms using processHash correlation.
Webhook Configuration: Complete webhook setup guide including signature verification, retry policies, and event filtering patterns.
Error Reference: Comprehensive error code documentation with resolution steps for every possible failure scenario.
Common Questions
Start Building Today
Get your API key and start integrating Integra into your applications in minutes. Free tier includes 1,000 monthly API calls—no credit card required.