{
  "info": {
    "_postman_id": "11e33116-94c8-4d45-9633-756c9d0ff8da",
    "name": "Verifly Email Verification API",
    "description": "Production-ready requests for the Verifly REST API. Set the apiKey collection variable to a Verifly API key before running authenticated requests.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "version": {
      "major": 2,
      "minor": 1,
      "patch": 0
    }
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://verifly.email/api/v1",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "vf_your_api_key",
      "type": "string"
    },
    {
      "key": "fileId",
      "value": "file_123",
      "type": "string"
    },
    {
      "key": "apiKeyId",
      "value": "key_123",
      "type": "string"
    },
    {
      "key": "ticketId",
      "value": "ticket_123",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "verify",
      "item": [
        {
          "name": "Verify a single email address",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/verify?email=lead%40example.com",
            "description": "Verify a single email address\n\nCheck if an email address is valid and deliverable. Returns detailed information about syntax, domain, MX records, and SMTP validation."
          }
        },
        {
          "name": "Verify multiple emails at once",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/verify/batch",
            "description": "Verify multiple emails at once\n\nVerify up to 100 email addresses in a single request. More efficient than individual requests for bulk verification.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"emails\": [\n    \"lead@example.com\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "clean",
      "item": [
        {
          "name": "Clean and filter an email list",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/clean",
            "description": "Clean and filter an email list\n\nProcess an email list to remove duplicates, invalid formats, public domains, and role accounts. Does not verify emails, just cleans the list. Free endpoint.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"emails\": [\n    \"lead@example.com\"\n  ],\n  \"options\": {\n    \"exclude_public_domains\": false,\n    \"exclude_role_accounts\": false,\n    \"domain_blacklist\": [\n      \"string\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "extract",
      "item": [
        {
          "name": "Extract emails from text",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/extract",
            "description": "Extract emails from text\n\nParse raw text and extract all email addresses. Useful for processing documents, logs, or unstructured data. Free endpoint.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Please contact jane@example.com and sales@example.com.\",\n  \"options\": {\n    \"deduplicate\": true,\n    \"lowercase\": true\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "credits",
      "item": [
        {
          "name": "Check credit balance",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/credits",
            "description": "Check credit balance\n\nGet current credit balance and usage statistics."
          }
        }
      ]
    },
    {
      "name": "usage",
      "item": [
        {
          "name": "Get usage statistics",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/usage?period=month",
            "description": "Get usage statistics\n\nGet detailed usage statistics with daily breakdown."
          }
        }
      ]
    },
    {
      "name": "files",
      "item": [
        {
          "name": "List saved files",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/files",
            "description": "List saved files\n\nGet a list of all processed files saved to your account."
          }
        },
        {
          "name": "Process emails with cleaning and optional verification",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/files",
            "description": "Process emails with cleaning and optional verification\n\nClean, filter, optionally verify, and save email lists. Supports deduplication, public domain filtering, role account filtering, blacklists, and more.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"emails\": [\n    \"lead@example.com\"\n  ],\n  \"text\": \"Please contact jane@example.com and sales@example.com.\",\n  \"options\": {\n    \"deduplicate\": true,\n    \"exclude_public_domains\": false,\n    \"exclude_role_accounts\": false,\n    \"domain_blacklist\": [\n      \"string\"\n    ],\n    \"pattern_blacklist\": [\n      \"string\"\n    ],\n    \"verify\": false,\n    \"save\": false,\n    \"filename\": \"Verifly API key\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get file details",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/files/{{fileId}}",
            "description": "Get file details\n\nGet details of a saved file including a preview of the first 100 records."
          }
        },
        {
          "name": "Delete a saved file",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": "{{baseUrl}}/files/{{fileId}}",
            "description": "Delete a saved file\n\nPermanently delete a saved file from your account."
          }
        },
        {
          "name": "Download file as CSV",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/files/{{fileId}}/download",
            "description": "Download file as CSV\n\nDownload a saved file in CSV format."
          }
        }
      ]
    },
    {
      "name": "keys",
      "item": [
        {
          "name": "List API keys",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/keys",
            "description": "List API keys\n\nGet a list of all your API keys with usage statistics."
          }
        },
        {
          "name": "Create a new API key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/keys",
            "description": "Create a new API key\n\nCreate a new API key. The full key is only shown once in the response - save it securely.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Verifly API key\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete an API key",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": "{{baseUrl}}/keys/{{apiKeyId}}",
            "description": "Delete an API key\n\nRevoke an API key. You cannot delete the key you're currently using."
          }
        }
      ]
    },
    {
      "name": "account",
      "item": [
        {
          "name": "Get account information",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/account",
            "description": "Get account information\n\nGet your account details including credits, usage stats, and plan information."
          }
        },
        {
          "name": "Update account settings",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/account",
            "description": "Update account settings\n\nUpdate your account settings such as email address.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"lead@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "billing",
      "item": [
        {
          "name": "Get billing information",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/billing?action=packages",
            "description": "Get billing information\n\nGet credit packages (action=packages) or payment history (action=history)."
          }
        },
        {
          "name": "Create checkout session",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/billing",
            "description": "Create checkout session\n\nCreate a checkout session to purchase credits. Supports Stripe and cryptocurrency payments.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": \"starter\",\n  \"method\": \"stripe\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "support",
      "item": [
        {
          "name": "List support tickets",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/support",
            "description": "List support tickets\n\nGet a list of your support tickets."
          }
        },
        {
          "name": "Create support ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/support",
            "description": "Create support ticket\n\nCreate a new support ticket.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"subject\": \"string\",\n  \"message\": \"Please contact jane@example.com and sales@example.com.\",\n  \"priority\": \"normal\",\n  \"context\": {}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get ticket details",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{baseUrl}}/support/{{ticketId}}",
            "description": "Get ticket details\n\nGet full ticket details including all replies."
          }
        },
        {
          "name": "Reply to ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/support/{{ticketId}}",
            "description": "Reply to ticket\n\nAdd a reply to an existing support ticket.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Please contact jane@example.com and sales@example.com.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    }
  ]
}