Documentation
Everything you need to integrate Engrave's immutable audit evidence platform into your applications.
Quick Start
Get up and running with Engrave in 5 minutes.
1 Create Your Account
Sign up for a free account. Your dedicated database is provisioned automatically.
2 Get Your API Key
Navigate to the API Keys section in your dashboard and generate a new API key. Keep this key secure - you'll need it for all API requests.
# Your API key looks like this:
API_KEY=ek_live_abc123def456...
3 Record Your First Event
Use the REST API to record an audit event. Include any metadata relevant to your use case.
curl -X POST https://api.tryengrave.com/api/v1/events \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_type": "user_signup",
"metadata": {
"user_id": "usr_12345",
"email": "user@example.com"
}
}'
4 Verify Integrity
Use the verification endpoint to cryptographically prove the event hasn't been modified.
curl https://api.tryengrave.com/api/v1/events/{id}/verify \
-H "X-API-Key: YOUR_API_KEY"
# Response:
{
"verified": true,
"tx_id": 12345,
"hash_matches": true
}
API Overview
Base URL
https://api.tryengrave.com
Authentication
All API requests require an API key passed in the X-API-Key header.
X-API-Key: ek_live_your_api_key_here
Core Endpoints
/api/v1/events
Record new audit event
/api/v1/events
List/search events
/api/v1/events/{id}
Get event details
/api/v1/events/{id}/verify
Verify event integrity
/api/v1/events/{id}/evidence
Upload evidence
/api/v1/evidence/{id}
Download evidence
Ready to Get Started?
Create your free account and start recording audit events today.
Start Free Trial