JSON Schemas

Data Schemas

Complete JSON schemas for every primitive and API response. Use these to validate payloads, generate types, or build client libraries.

Brand Capsule (JSON-LD)

{
  "@context": "https://schema.org",
  "@type": "Brand",
  "@id": "urn:registeredbrands:capsule:{capsuleId}",
  "name": "string — brand display name",
  "description": "string | null — brand description",
  "url": "string | null — primary domain",
  "logo": "string | null — logo URL",
  "identifier": [
    { "@type": "PropertyValue", "propertyID": "capsuleId", "value": "cap_..." },
    { "@type": "PropertyValue", "propertyID": "DUNS", "value": "string | null" },
    { "@type": "PropertyValue", "propertyID": "identityCode", "value": "string | null" }
  ],
  "additionalProperty": [
    { "@type": "PropertyValue", "propertyID": "trustScore", "value": 0, "maxValue": 100000 },
    { "@type": "PropertyValue", "propertyID": "verificationStatus", "value": "verified | unverified | flagged" },
    { "@type": "PropertyValue", "propertyID": "capsuleType", "value": "brand | agent | merchant | platform" },
    { "@type": "PropertyValue", "propertyID": "publicKey", "value": "base64-encoded Ed25519 public key" },
    { "@type": "PropertyValue", "propertyID": "dunsVerified", "value": true },
    { "@type": "PropertyValue", "propertyID": "identityVerified", "value": true },
    { "@type": "PropertyValue", "propertyID": "domainAnchored", "value": true }
  ],
  "dateCreated": "ISO 8601 timestamp",
  "dateModified": "ISO 8601 timestamp"
}

Entitlement Token

{
  "entitlementId": "ent_{nanoid}",
  "planId": "starter | professional | business",
  "planName": "Starter | Professional | Business",
  "credits": 25000,
  "creditsUsed": 0,
  "capsPerMinute": 30,
  "capsPerDay": 1000,
  "monthlyMaxUsd": 29,
  "status": "active | expired | revoked",
  "signature": "base64-encoded Ed25519 signature over canonical JSON",
  "paymentIntentId": "pi_{nanoid}",
  "expiresAt": "ISO 8601 timestamp",
  "issuedAt": "ISO 8601 timestamp",
  "issuerPublicKey": "base64-encoded Ed25519 public key"
}

Transaction Receipt

{
  "receiptId": "rcpt_{nanoid}",
  "buyerCapsuleId": "cap_...",
  "sellerCapsuleId": "cap_...",
  "entitlementId": "ent_... | null",
  "amount": "29.00",
  "currency": "USDC",
  "network": "base | ethereum",
  "txHash": "0x... | null",
  "status": "pending | confirmed | disputed | refunded",
  "signature": "base64-encoded Ed25519 signature",
  "metadata": {},
  "createdAt": "ISO 8601 timestamp"
}

Payment Intent

{
  "intentId": "pi_{nanoid}",
  "planId": "starter | professional | business",
  "amount": "29.00",
  "currency": "USDC",
  "network": "base | ethereum",
  "provider": "mock | stripe | onchain",
  "status": "pending | confirmed | failed | expired",
  "paymentAddress": "0x...",
  "txHash": "0x... | null",
  "expiresAt": "ISO 8601 timestamp",
  "confirmedAt": "ISO 8601 timestamp | null"
}

Trust Score Breakdown

{
  "trustScore": 87500,
  "maxScore": 100000,
  "breakdown": {
    "dunsScore": {
      "value": 20000,
      "max": 20000,
      "description": "DUNS number verification (0 = none, 10000 = has DUNS, 20000 = verified)"
    },
    "identityScore": {
      "value": 15000,
      "max": 15000,
      "description": "Identity code verification (0 = none, 7500 = has code, 15000 = verified)"
    },
    "trustProfileScore": {
      "value": 10000,
      "max": 10000,
      "description": "Trust profile URI (0 = none, 5000 = has URI, 10000 = verified)"
    },
    "documentScore": {
      "value": 12000,
      "max": 15000,
      "description": "Document completeness (3000 per document, max 15000)"
    },
    "communityScore": {
      "value": 10000,
      "max": 10000,
      "description": "Community reputation (starts at 10000, -2000 per flag)"
    },
    "ageScore": {
      "value": 7000,
      "max": 10000,
      "description": "Account age bonus (500 at 7d, 2000 at 30d, 4000 at 90d, 7000 at 180d, 10000 at 365d)"
    },
    "flagPenalty": {
      "value": 0,
      "description": "-15000 per upheld community flag"
    }
  }
}

Verify Capsule Response

{
  "verified": true,
  "capsuleId": "cap_7xK9mN2p",
  "brandName": "Meridian Commerce Group",
  "trustScore": 87500,
  "maxTrustScore": 100000,
  "status": "verified",
  "capsuleType": "brand",
  "verifiedAt": "ISO 8601 timestamp",
  "dunsVerified": true,
  "identityVerified": true,
  "trustProfileVerified": true,
  "domainAnchored": true,
  "signatureValid": true | null,
  "protocol": "rfc9421",
  "timestamp": "ISO 8601 timestamp",
  "signatureAlgorithm": "ed25519",
  "responseNonce": "hex string"
}

Verify Receipt Response

{
  "verified": true,
  "receiptId": "rcpt_Q4wR7xK9",
  "status": "confirmed",
  "schemaValid": true,
  "signatureValid": true | null,
  "buyer": {
    "capsuleId": "cap_buyer123",
    "brandName": "Buyer Corp",
    "verified": true
  },
  "seller": {
    "capsuleId": "cap_seller456",
    "brandName": "Seller Inc",
    "verified": true
  },
  "amount": "29.00",
  "currency": "USDC",
  "network": "base",
  "timestamp": "ISO 8601 timestamp"
}