Developer tools

Postman collection

Import the collection and hit every endpoint with your API key. Variables are pre-templated for quick testing.

Download

Coming with GA — direct download link + Postman marketplace listing.

Do it now (paste this into Postman → Import → Raw text)

Postman collection · JSON

{
  "info": {
    "name": "ZI² Verify",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{apiKey}}", "type": "string" }]
  },
  "item": [
    {
      "name": "Validate single",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Idempotency-Key", "value": "{{$guid}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": "{{baseUrl}}/v1/validate",
        "body": { "mode": "raw", "raw": "{\"email\":\"[email protected]\"}" }
      }
    },
    {
      "name": "Batch enqueue",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": "{{baseUrl}}/v1/batch",
        "body": { "mode": "raw", "raw": "{\"emails\":[\"[email protected]\",\"[email protected]\"]}" }
      }
    },
    {
      "name": "Job status",
      "request": { "method": "GET", "url": "{{baseUrl}}/v1/jobs/{{jobId}}" }
    },
    {
      "name": "Balance",
      "request": { "method": "GET", "url": "{{baseUrl}}/v1/balance" }
    },
    {
      "name": "JWKS",
      "request": { "method": "GET", "url": "{{baseUrl}}/.well-known/zi2cert.jwks", "auth": { "type": "noauth" } }
    }
  ],
  "variable": [
    { "key": "baseUrl", "value": "https://verify.zi2.app" },
    { "key": "apiKey", "value": "zi2v_live_YOUR_PREFIX_YOUR_SECRET" }
  ]
}

Variables

baseUrl — https://verify.zi2.app (or your staging domain).
apiKey — paste from Dashboard → API keys.
jobId — populate after a batch request.