{
  "info": {
    "_postman_id": "pvs-phonevalidation-api-2026",
    "name": "PhoneValidation API",
    "description": "Honest phone number validation API — format, country, line type, carrier, disposable detection. Set the {{apiKey}} variable in the collection (Variables tab) to authorize all requests at once.\n\nDocs: https://phonevalidationapi.com/docs",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://phonevalidationapi.com/api/v1", "type": "string" },
    { "key": "apiKey",  "value": "pvs_live_REPLACE_ME",                    "type": "string" }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{apiKey}}", "type": "string" }]
  },
  "item": [
    {
      "name": "Validate (single)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": {
          "raw": "{{baseUrl}}/validate",
          "host": ["{{baseUrl}}"],
          "path": ["validate"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"phone\": \"+33612345678\"\n}"
        }
      },
      "response": []
    },
    {
      "name": "Validate (national format with country)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": {
          "raw": "{{baseUrl}}/validate",
          "host": ["{{baseUrl}}"],
          "path": ["validate"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"phone\": \"0612345678\",\n  \"country\": \"FR\"\n}"
        }
      }
    },
    {
      "name": "Validate async (bulk batch)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": {
          "raw": "{{baseUrl}}/validate-async",
          "host": ["{{baseUrl}}"],
          "path": ["validate-async"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"phones\": [\n    \"+33612345678\",\n    \"+14155552671\",\n    \"+447700900100\"\n  ],\n  \"country\": \"FR\",\n  \"webhook_url\": \"https://your-app.com/webhooks/batch\",\n  \"webhook_secret\": \"shared-secret-for-hmac\"\n}"
        }
      }
    },
    {
      "name": "Get batch status",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/batch/bat_REPLACE_ME",
          "host": ["{{baseUrl}}"],
          "path": ["batch", "bat_REPLACE_ME"]
        }
      }
    },
    {
      "name": "Get quota / plan status",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/credits",
          "host": ["{{baseUrl}}"],
          "path": ["credits"]
        }
      }
    },
    {
      "name": "Public demo (no auth, 3/IP/24h)",
      "request": {
        "auth": { "type": "noauth" },
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": {
          "raw": "{{baseUrl}}/demo",
          "host": ["{{baseUrl}}"],
          "path": ["demo"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"phone\": \"+33612345678\"\n}"
        }
      }
    }
  ]
}