{
  "info": {
    "name": "Legichain API v1",
    "_postman_id": "9f5b8c4a-1a2b-4c5d-9e8f-7f3c2b1a0d99",
    "description": "Official Postman collection for the Legichain AML/sanctions/crypto-risk API.\n\nFill in the `base_url` and `api_key` collection variables, then run any request. Mutating endpoints accept an `Idempotency-Key`; one is auto-generated per request via a pre-request script.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      { "key": "token", "value": "{{api_key}}", "type": "string" }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Auto-attach an Idempotency-Key to every mutating request.",
          "const method = pm.request.method;",
          "if (['POST','PUT','PATCH','DELETE'].includes(method)) {",
          "  if (!pm.request.headers.has('Idempotency-Key')) {",
          "    pm.request.headers.add({ key: 'Idempotency-Key', value: pm.variables.replaceIn('{{$guid}}') });",
          "  }",
          "}"
        ]
      }
    }
  ],
  "variable": [
    { "key": "base_url", "value": "https://api.legichain.com", "type": "string" },
    { "key": "api_key",  "value": "lc_test_xxxxxx.sk_test_xxxxxx", "type": "string" }
  ],
  "item": [
    {
      "name": "Status (public)",
      "request": {
        "method": "GET",
        "auth": { "type": "noauth" },
        "header": [],
        "url": { "raw": "{{base_url}}/v1/status", "host": ["{{base_url}}"], "path": ["v1","status"] }
      }
    },
    {
      "name": "Health: live",
      "request": {
        "method": "GET",
        "auth": { "type": "noauth" },
        "url": { "raw": "{{base_url}}/healthz/live", "host": ["{{base_url}}"], "path": ["healthz","live"] }
      }
    },
    {
      "name": "Health: ready",
      "request": {
        "method": "GET",
        "auth": { "type": "noauth" },
        "url": { "raw": "{{base_url}}/healthz/ready", "host": ["{{base_url}}"], "path": ["healthz","ready"] }
      }
    },
    {
      "name": "Screen :: Person",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Vladimir Putin\",\n  \"country\": \"RU\",\n  \"dob\": \"1952-10-07\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/person", "host": ["{{base_url}}"], "path": ["v1","screen","person"] }
      }
    },
    {
      "name": "Screen :: Company",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Central Bank of Iran\",\n  \"country\": \"IR\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/company", "host": ["{{base_url}}"], "path": ["v1","screen","company"] }
      }
    },
    {
      "name": "Screen :: Crypto (ETH)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"0x6c0bD2BB04Fda9CBfeBb8DC1208Db32a0F8a4Edd\",\n  \"chain\": \"ETH\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/crypto", "host": ["{{base_url}}"], "path": ["v1","screen","crypto"] }
      }
    },
    {
      "name": "Screen :: Crypto (BSC)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"0x...\",\n  \"chain\": \"BSC\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/crypto", "host": ["{{base_url}}"], "path": ["v1","screen","crypto"] }
      }
    },
    {
      "name": "Screen :: Crypto (TRX)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"TTiDLWE6fZK8okMJv6ijg42yrH6W2pjSr9\",\n  \"chain\": \"TRX\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/crypto", "host": ["{{base_url}}"], "path": ["v1","screen","crypto"] }
      }
    },
    {
      "name": "Screen :: Crypto (BTC)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh\",\n  \"chain\": \"BTC\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/crypto", "host": ["{{base_url}}"], "path": ["v1","screen","crypto"] }
      }
    },
    {
      "name": "Screen :: Batch (sync, ≤25)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": [\n    { \"name\": \"John Doe\", \"country\": \"US\" },\n    { \"address\": \"0x6c0bD2BB04Fda9CBfeBb8DC1208Db32a0F8a4Edd\", \"chain\": \"ETH\" }\n  ]\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/batch", "host": ["{{base_url}}"], "path": ["v1","screen","batch"] }
      }
    },
    {
      "name": "Screen :: Batch (async)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": [\n    { \"name\": \"John Doe\" },\n    { \"address\": \"0x...\", \"chain\": \"ETH\" }\n  ]\n}"
        },
        "url": { "raw": "{{base_url}}/v1/screen/batch/async", "host": ["{{base_url}}"], "path": ["v1","screen","batch","async"] }
      }
    },
    {
      "name": "Screen :: Job lookup",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/screen/jobs/{{job_id}}", "host": ["{{base_url}}"], "path": ["v1","screen","jobs","{{job_id}}"] }
      }
    },
    {
      "name": "Report :: Wallet (JSON)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"0x6c0bD2BB04Fda9CBfeBb8DC1208Db32a0F8a4Edd\",\n  \"chain\": \"ETH\",\n  \"format\": \"json\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/reports/wallet", "host": ["{{base_url}}"], "path": ["v1","reports","wallet"] }
      }
    },
    {
      "name": "Report :: Wallet (PDF)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"0x6c0bD2BB04Fda9CBfeBb8DC1208Db32a0F8a4Edd\",\n  \"chain\": \"ETH\",\n  \"format\": \"pdf\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/reports/wallet", "host": ["{{base_url}}"], "path": ["v1","reports","wallet"] }
      }
    },
    {
      "name": "Report :: Person (PDF)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Vladimir Putin\",\n  \"country\": \"RU\",\n  \"dob\": \"1952-10-07\",\n  \"gender\": \"male\",\n  \"format\": \"pdf\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/reports/person", "host": ["{{base_url}}"], "path": ["v1","reports","person"] }
      }
    },
    {
      "name": "Report :: Company (PDF)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Central Bank of Iran\",\n  \"country\": \"IR\",\n  \"format\": \"pdf\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/reports/company", "host": ["{{base_url}}"], "path": ["v1","reports","company"] }
      }
    },
    {
      "name": "Admin :: Credits balance",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/admin/credits", "host": ["{{base_url}}"], "path": ["v1","admin","credits"] }
      }
    },
    {
      "name": "Admin :: Usage (cursor)",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/v1/admin/usage?limit=50",
          "host": ["{{base_url}}"], "path": ["v1","admin","usage"],
          "query": [{ "key": "limit", "value": "50" }, { "key": "cursor", "value": "", "disabled": true }]
        }
      }
    },
    {
      "name": "Admin :: Searches (UI list)",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/admin/searches?limit=20", "host": ["{{base_url}}"], "path": ["v1","admin","searches"], "query": [{ "key": "limit", "value": "20" }] }
      }
    },
    {
      "name": "Admin :: Audit log",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/admin/audit?limit=50", "host": ["{{base_url}}"], "path": ["v1","admin","audit"], "query": [{ "key": "limit", "value": "50" }] }
      }
    },
    {
      "name": "Admin :: Create API key",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"label\": \"prod-server-01\",\n  \"env_mode\": \"live\",\n  \"rps_limit\": 50,\n  \"daily_call_cap\": 100000,\n  \"ip_allowlist\": [\"203.0.113.5\", \"198.51.100.0/24\"]\n}"
        },
        "url": { "raw": "{{base_url}}/v1/admin/api-keys", "host": ["{{base_url}}"], "path": ["v1","admin","api-keys"] }
      }
    },
    {
      "name": "Admin :: Create webhook endpoint",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"https://example.com/webhooks/legichain\",\n  \"events\": [\"screen.batch.completed\", \"report.generated\"],\n  \"description\": \"Primary delivery\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/admin/webhooks", "host": ["{{base_url}}"], "path": ["v1","admin","webhooks"] }
      }
    },
    {
      "name": "Admin :: Webhook test fire",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": { "mode": "raw", "raw": "{\n  \"endpoint_id\": \"{{endpoint_id}}\"\n}" },
        "url": { "raw": "{{base_url}}/v1/admin/webhooks/test", "host": ["{{base_url}}"], "path": ["v1","admin","webhooks","test"] }
      }
    },
    {
      "name": "Admin :: Private list — add",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"entity_type\": \"crypto\",\n  \"value\": \"0xdeadbeef0000000000000000000000000000dead\",\n  \"chain\": \"ETH\",\n  \"reason\": \"Customer chargeback fraud\"\n}"
        },
        "url": { "raw": "{{base_url}}/v1/admin/data/private-lists", "host": ["{{base_url}}"], "path": ["v1","admin","data","private-lists"] }
      }
    },
    {
      "name": "Admin :: GDPR export",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/admin/data/export", "host": ["{{base_url}}"], "path": ["v1","admin","data","export"] }
      }
    },
    {
      "name": "Admin :: Billing — invoice PDF",
      "request": {
        "method": "GET",
        "url": { "raw": "{{base_url}}/v1/admin/billing/invoice/2026-05", "host": ["{{base_url}}"], "path": ["v1","admin","billing","invoice","2026-05"] }
      }
    }
  ]
}