API quickstart

The Fidemark Enterprise API is a thin HTTP layer over the SDK. Same schemas, same trust model, but with API-key auth, monthly quotas, batch attestation, webhooks, and audit log export: designed for backend pipelines that don’t want to manage signing keys themselves.

The production endpoint is https://api.fidemark.dev.

1. Get an API key

Request a key from your Fidemark account dashboard, or contact [email protected] if you don’t have an account yet.

The full key is shown exactly once at creation. Store it somewhere safe:

fmk_pro_abc123def456_<32hex>

The full key is printed exactly once. Store it somewhere safe:

fmk_pro_abc123def456_<32hex>

2. Make a request

curl -X POST https://api.fidemark.dev/v1/attestations \
  -H "Authorization: Bearer fmk_pro_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "human",
    "content": "An essay I wrote.",
    "contentType": "text/article"
  }'

Response:

{
  "uid": "0xabc...",
  "txHash": "0x...",
  "verifyUrl": "https://verify.fidemark.dev/0xabc..."
}

3. Look it up

No auth required for read endpoints:

curl https://api.fidemark.dev/v1/attestations/0xabc...

What’s available

Endpoint	Purpose
POST /v1/attestations	Single attestation (Human or AI, on- or off-chain)
POST /v1/attestations/batch	Up to 100 in one multicall
GET /v1/attestations/:uid	Read by UID (public)
GET /v1/attestations?hash=...	Search by content hash (public)
POST /v1/attestations/:uid/revoke	Revoke (relayer-signed)
POST /v1/webhooks	Subscribe to attestation events
GET /v1/audit/export	CSV/JSON dump for compliance
GET /openapi.json	Full machine-readable spec

See Authentication, Batch, Webhooks, Audit export, and Rate limits for the details on each.