API Reference

The eHealthID API provides programmatic access to health records, access controls, and cryptographic verification features. All API endpoints use HTTPS and require authentication.

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Core Endpoints

GET /api/v1/health-records

Retrieve health records for the authenticated user.

curl -X GET https://api.ehealthid.com/v1/health-records \ -H "Authorization: Bearer YOUR_API_KEY"

POST /api/v1/access-grants

Grant access to health records for a specific provider or individual.

curl -X POST https://api.ehealthid.com/v1/access-grants \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"grantee_id": "provider_123", "duration": "30d"}'

POST /api/v1/verify-credential

Generate a zero-knowledge proof to verify a credential without revealing details.

curl -X POST https://api.ehealthid.com/v1/verify-credential \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"credential_type": "vaccination", "required": "covid19"}'

SDKs and Libraries

JavaScript/TypeScript

npm install @ehealthid/sdk

Python

pip install ehealthid

Go

go get github.com/ehealthid/go-sdk