MinakiLabs API

Cryptographic proof, document security, and zero-knowledge storage — all on MinakiChain.

Overview

The MinakiLabs API gives developers programmatic access to all six MinakiLabs products. Every request is authenticated with an API key and proxied through Kong Gateway. All responses are JSON.

🔒 ReserveProof

Crypto proof-of-reserves

/v1/reserveproof

📄 DocProof

Document notarization on-chain

/v1/docproof

🔍 AuditTrail

Immutable compliance logs

/v1/audittrail

✍️ SignatureProof

Ed25519 document signing

/v1/signatureproof

🗄️ DocumentVault

AES-256 encrypted file storage

/v1/documentvault

🔑 CredVault

Zero-knowledge password vault

/v1/credvault

Authentication

All API requests require an API key passed in the apikey header. Get your key from the MinakiLabs dashboard.

apikey: your-api-key-here 
# Example request
curl https://api.minaki.io/v1/docproof/health \
  -H "apikey: your-api-key-here"

Base URL

https://api.minaki.io/v1

Errors

401No API key found in request
Missing apikey header
401Unauthorized
Invalid or revoked API key
429Rate limit exceeded
Too many requests — see rate limits below

Rate Limits

Rate limit headers are returned on every response:

RateLimit-Limit: 60
RateLimit-Remaining: 59
RateLimit-Reset: 60
X-RateLimit-Limit-Minute: 60
X-RateLimit-Limit-Hour: 1000

ReserveProof

Submit and verify cryptographic proof-of-reserves. Anchored to MinakiChain.

GET/v1/reserveproof/health
Service health check
GET/v1/reserveproof/api/records
List reserve records
POST/v1/reserveproof/api/records
Submit a new reserve proof

DocProof

Notarize documents by anchoring their SHA-256 hash to MinakiChain.

GET/v1/docproof/health
Service health check
GET/v1/docproof/api/documents
List notarized documents
POST/v1/docproof/api/documents
Notarize a new document hash
GET/v1/docproof/api/documents/{doc_id}
Get document proof details
curl -X POST https://api.minaki.io/v1/docproof/api/documents \
  -H "apikey: your-key" \
  -H "Content-Type: application/json" \
  -d '{"filename":"contract.pdf","sha256":"abc123...","owner_email":"you@example.com"}'

AuditTrail

Write immutable compliance events anchored to MinakiChain. Tamper-evident.

GET/v1/audittrail/health
Service health check
GET/v1/audittrail/api/events
List audit events
POST/v1/audittrail/api/events
Write a new audit event

SignatureProof

Create multi-party Ed25519 signature requests and verify cryptographic signatures.

GET/v1/signatureproof/health
Service health check
POST/v1/signatureproof/api/requests
Create a signature request
GET/v1/signatureproof/api/requests/{token}
Get request status
POST/v1/signatureproof/api/requests/{token}/sign
Submit a signature

DocumentVault

Store AES-256-GCM encrypted files. Zero-knowledge — files are encrypted client-side before upload.

GET/v1/documentvault/health
Service health check
GET/v1/documentvault/api/entries
List vault entries
POST/v1/documentvault/api/entries
Create a vault entry
POST/v1/documentvault/api/upload/{vault_id}
Upload encrypted file
GET/v1/documentvault/api/download/{vault_id}
Download encrypted file
DELETE/v1/documentvault/api/entries/{vault_id}
Delete a vault entry

CredVault

Zero-knowledge encrypted credential storage. Master password never leaves the client.

GET/v1/credvault/health
Service health check
GET/v1/credvault/api/entries
List credentials
POST/v1/credvault/api/entries
Store an encrypted credential
PUT/v1/credvault/api/entries/{entry_id}
Update a credential
DELETE/v1/credvault/api/entries/{entry_id}
Delete a credential

Ready to build?

Get your API key from the MinakiLabs dashboard.

Get API Key →