Compliance

EDD memo

Generate an enhanced due diligence memo for a wallet set using exact-match OFAC wallet screening and OFAC SDN digital currency address checks, status labels for compliance review, case metadata, and JSON, PDF, or DOCX output.

Browser note: GET on this URL serves human-readable docs. Paid execution still requires POST with x402 settlement.

Best when operations or compliance needs an audit-ready memo without pretending the system is providing legal approval or denial.

Example request body

Use this payload shape for the paid POST call.

{
  "subject_name": "Northwind Treasury Counterparty",
  "case_name": "Counterparty onboarding review",
  "review_reason": "Treasury payout review",
  "jurisdiction": "US",
  "requested_by": "ops@northwind.example",
  "reference_id": "case-2026-04-07-001",
  "output_format": "pdf",
  "artifact_only": true,
  "addresses": [
    "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
    "0x1111111111111111111111111111111111111111"
  ],
  "asset": "ETH"
}

Request schema

The canonical body contract as exposed through discovery and OpenAPI.

{
  "type": "object",
  "properties": {
    "subject_name": {
      "type": "string",
      "description": "Human-readable subject or counterparty name for the memo."
    },
    "case_name": {
      "type": "string",
      "description": "Optional case or review title."
    },
    "review_reason": {
      "type": "string",
      "description": "Optional reason the EDD memo is being prepared."
    },
    "jurisdiction": {
      "type": "string",
      "description": "Optional jurisdiction or operating region for the case."
    },
    "requested_by": {
      "type": "string",
      "description": "Optional requester or owning team."
    },
    "reference_id": {
      "type": "string",
      "description": "Optional internal case or review reference."
    },
    "output_format": {
      "type": "string",
      "description": "Select json for the structured memo payload or pdf|docx for a generated artifact.",
      "enum": [
        "json",
        "pdf",
        "docx"
      ]
    },
    "artifact_only": {
      "type": "boolean",
      "description": "When output_format is pdf or docx, return a compact artifact-first response without the full memo payload."
    },
    "addresses": {
      "type": "array",
      "description": "Wallet addresses to include in the enhanced due diligence memo.",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 100
    },
    "asset": {
      "type": "string",
      "description": "Optional asset or network ticker filter, such as ETH, USDC, XBT, TRX, ARB, or BSC."
    }
  },
  "required": [
    "subject_name",
    "addresses",
    "output_format"
  ],
  "additionalProperties": false
}

Example response

A representative output payload for the route.

{
  "success": true,
  "output_format": "pdf",
  "artifact": {
    "type": "pdf",
    "name": "edd-report-northwind-treasury-counterparty.pdf",
    "sizeBytes": 9555,
    "contentBase64": "JVBERi0xLjQK..."
  },
  "artifact_summary": {
    "documentType": "pdf",
    "fileName": "edd-report-northwind-treasury-counterparty.pdf",
    "mimeType": "application/pdf",
    "sizeBytes": 9555,
    "engine": "report-pdf",
    "mode": "real-binary",
    "lane": "premium-report",
    "fulfilledLane": "premium-report",
    "usedFallback": false,
    "degraded": false,
    "degradationReason": null,
    "recommendedLocalPath": "outputs/edd-report-northwind-treasury-counterparty.pdf",
    "delivery": {
      "primary": "base64",
      "downloadUrl": null,
      "downloadUrlExpiresAt": null,
      "note": "Decode artifact.contentBase64 to save the generated file. This endpoint does not persist hosted artifacts."
    }
  },
  "data": {
    "case": {
      "subjectName": "Northwind Treasury Counterparty",
      "caseName": "Counterparty onboarding review",
      "reviewReason": "Treasury payout review",
      "jurisdiction": "US",
      "requestedBy": "ops@northwind.example",
      "referenceId": "case-2026-04-07-001",
      "addresses": [
        "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
        "0x1111111111111111111111111111111111111111"
      ],
      "asset": "ETH"
    },
    "workflowStatus": "manual_review_required",
    "evidenceSummary": [
      "Northwind Treasury Counterparty screening returned exact OFAC SDN digital currency address matches linked to Lazarus Group."
    ],
    "requiredFollowUp": [
      "Escalate the case to a human compliance reviewer before onboarding, payout release, or funds movement."
    ]
  },
  "output": {
    "mimeType": "application/pdf",
    "artifact": {
      "type": "pdf",
      "name": "edd-report-northwind-treasury-counterparty.pdf",
      "sizeBytes": 9555,
      "contentBase64": "JVBERi0xLjQK..."
    },
    "artifact_summary": {
      "delivery": {
        "primary": "base64",
        "downloadUrl": null
      }
    }
  },
  "source": "OFAC SDN Advanced XML"
}

cURL

Use this as the starting point for HTTP execution after the initial 402 challenge.

curl -X POST "https://api.aurelianflo.com/api/workflows/compliance/edd-report" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  # include x402 settlement headers after the initial 402 challenge \
  -d '{
  "subject_name": "Northwind Treasury Counterparty",
  "case_name": "Counterparty onboarding review",
  "review_reason": "Treasury payout review",
  "jurisdiction": "US",
  "requested_by": "ops@northwind.example",
  "reference_id": "case-2026-04-07-001",
  "output_format": "pdf",
  "artifact_only": true,
  "addresses": [
    "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
    "0x1111111111111111111111111111111111111111"
  ],
  "asset": "ETH"
}'

Related routes

Use these when you want the lower-level primitive, the buyer-facing memo workflow, or the agent install surface around this endpoint.

Exposure forecast Forecast future OFAC exposure for the same wallet set before the memo is finalized. Queue optimizer Prioritize manual review when the wallet set becomes part of a larger compliance queue. Batch screening Lower-priced wallet-set screening primitive underneath the EDD workflow. Single-wallet screen Concrete exact-match OFAC example for one wallet address. Payments MCP Install and prompt templates for agent-first access to the compliance routes.