Documentation / BlockID™ /

BlockID™

Identity verification APIs for KYC/AML automation, portable credential management, and Entra Verified ID integration.

Agent-Driven KYC/AML

Autonomous agents automate identity verification, customer identification, and anti-money-laundering checks. Reduces manual overhead while maintaining SOC 2 and PCI DSS compliance.

Self-Custody Data Wallet

Users own and control their identity data through edge-held wallets. No centralized data custody eliminates single points of failure.

Portable Credentials

Verifiable credentials that move with users across providers. Complete KYC once, reuse across the FreshCredit Ecosystem™. Integrated with Microsoft Entra Verified ID.

Privacy-Preserving Verification

Zero-knowledge proofs enable identity verification without exposing underlying data. Prove requirements are met without revealing personal information.

API Reference /

POST/v1/blockid/verify

Initiate an identity verification workflow

Request

{
  "user_id": "user_123",
  "verification_type": "kyc_basic",
  "callback_url": "https://your-app.com/webhooks/blockid"
}

Response

{
  "verification_id": "vrf_abc123",
  "status": "pending",
  "url": "https://verify.freshcredit.com/vrf_abc123",
  "expires_at": "2024-12-31T23:59:59Z"
}

GET/v1/blockid/verify/{verification_id}

Retrieve verification status and results

Response

{
  "verification_id": "vrf_abc123",
  "status": "completed",
  "user_id": "user_123",
  "result": {
    "verified": true,
    "verification_date": "2024-01-15T10:30:00Z",
    "credentials": ["identity", "address"]
  }
}

POST/v1/blockid/credentials/issue

Issue a verifiable credential to a user

Request

{
  "user_id": "user_123",
  "credential_type": "identity_verified",
  "claims": {
    "name": "John Doe",
    "verified_at": "2024-01-15T10:30:00Z"
  }
}

Response

{
  "credential_id": "cred_xyz789",
  "status": "issued",
  "vc_jwt": "eyJhbGciOiJFUzI1NksifQ..."
}

Verification Types /

kyc_basicName, DOB, address verification

< 30 seconds

kyc_plusBasic + document verification

2-5 minutes

kyc_enterpriseFull KYC + PEP/sanctions screening

5-15 minutes

aml_screeningAnti-money laundering check

< 5 seconds

business_kybBusiness verification

1-24 hours

Webhook Events /

blockid.verification.completedSent when a verification is successfully completed

blockid.verification.failedSent when a verification fails or is rejected

blockid.credential.issuedSent when a new credential is issued to a user

blockid.credential.revokedSent when a credential is revoked

Next Steps

Explore BlockScore™Review Authentication