{
  "info": {
    "name": "Verify by Zecible - KYC / KYB",
    "description": "Postman collection for the Verify API (French identity verification). Set the `base_url` and `api_key` variables (collection Variables tab). The calling IP must be in the account's allowlist.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "X-API-Key", "type": "string" },
      { "key": "value", "value": "{{api_key}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "variable": [
    { "key": "base_url", "value": "https://verify.zecible.fr", "type": "string" },
    { "key": "api_key", "value": "vkey_live_...", "type": "string" }
  ],
  "item": [
    {
      "name": "POST /api/person (KYC)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/person",
          "host": ["{{base_url}}"],
          "path": ["api", "person"]
        },
        "body": {
          "mode": "raw",
          "options": { "raw": { "language": "json" } },
          "raw": "{\n  \"reference\": \"tx-001\",\n  \"person\": {\n    \"first_name\": \"Jean\",\n    \"last_name\": \"Dupont\",\n    \"birth_date\": \"1980-05-15\",\n    \"address\": {\n      \"street\": \"12 rue de la Paix\",\n      \"city\": \"PARIS\",\n      \"postal_code\": \"75001\"\n    },\n    \"email\": \"jean.dupont@example.com\",\n    \"mobile\": \"0612345678\"\n  }\n}"
        },
        "description": "Verifies an individual. first_name + last_name required, plus at least one discriminating criterion (birth_date, full address, email, mobile, landline or phone)."
      }
    },
    {
      "name": "POST /api/business (KYB)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/business",
          "host": ["{{base_url}}"],
          "path": ["api", "business"]
        },
        "body": {
          "mode": "raw",
          "options": { "raw": { "language": "json" } },
          "raw": "{\n  \"reference\": \"tx-biz-001\",\n  \"business\": {\n    \"siret\": \"00000000000000\",\n    \"name\": \"ACME SAS\",\n    \"legal_form\": \"SAS\",\n    \"naf\": \"7311Z\",\n    \"address\": {\n      \"street\": \"12 rue de la Paix\",\n      \"city\": \"PARIS\",\n      \"postal_code\": \"75001\"\n    },\n    \"website\": \"https://acme.example.com\"\n  },\n  \"executives\": [\n    { \"first_name\": \"Jean\", \"last_name\": \"Dupont\", \"role\": \"président\" }\n  ]\n}"
        },
        "description": "Verifies a company + executives. At least siret OR siren OR (name + city/postal_code). Up to 10 executives per request."
      }
    },
    {
      "name": "GET /api/usage",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/usage?start=2026-06-01&stop=2026-06-30",
          "host": ["{{base_url}}"],
          "path": ["api", "usage"],
          "query": [
            { "key": "start", "value": "2026-06-01" },
            { "key": "stop", "value": "2026-06-30" }
          ]
        },
        "description": "Billed consumption (pretax EUR) for the calling account. Default period = current month if start/stop omitted."
      }
    }
  ]
}