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.

Fraud Prevention

Edge-held identity verification stops fraud at the infrastructure level. Synthetic identity detection helps prevent fraud during onboarding.

Portable Credentials

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

Agent Automation

BlockID™ agent workflows automate the verification and licensing process. Reduce manual overhead while maintaining accuracy and compliance.

API Reference /

POST/api/v1/identity/verify

Initiate identity verification workflow

Request

POST /api/v1/identity/verify
{
  "credential_type": "blockid_verified",
  "provider": "freshcredit",
  "verification_level": "enhanced"
}

Response

{
  "verification_id": "vrf_abc123xyz789",
  "status": "initiated",
  "expires_at": "2025-03-08T12:00:00Z"
}

GET/api/v1/identity/verification/{id}

Retrieve verification status and details

Response

{
  "verification_id": "vrf_abc123xyz789",
  "status": "completed",
  "credential": {
    "type": "blockid_verified",
    "issued_at": "2025-03-08T10:30:00Z",
    "expires_at": "2026-03-08T10:30:00Z"
  }
}

POST/api/v1/credentials/issue

Issue verifiable credential

Request

POST /api/v1/credentials/issue
{
  "user_id": "user_123",
  "credential_type": "kyc_verified",
  "claims": {
    "name": "Jane Doe",
    "verified_at": "2025-03-08T10:30:00Z"
  }
}

Response

{
  "credential_id": "cred_xyz789",
  "status": "issued",
  "proof": "zkp_abc123..."
}

Verification Types /

BasicShipping

FreshCredit Identity credential issuance and verification via Microsoft Entra Verified ID

StandardSandbox

Plaid IDV plumbing for document-based verification — sandbox-gated while in rollout

EnhancedProvider-side

Liveness and watchlist checks are provider-side integrations, not shipped FreshCredit levels

EnterpriseCustom

Custom verification workflows for regulated industries

Webhook Events /

verification.completedSent when verification is successfully completed

verification.failedSent when verification fails or is rejected

credential.issuedSent when a new credential is issued

credential.revokedSent when a credential is revoked

Next Steps

Explore BlockScore™Review Authentication

{ "verification_id": "vrf_abc123xyz789", "status": "completed", "credential": { "type": "blockid_verified", "issued_at": "2025-03-08T10:30:00Z", "expires_at": "2026-03-08T10:30:00Z" } }