ZeroBounce · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for ZeroBounce Validate Email plugin Validation API

3 actions 3 updates phrasing extends openapi/zerobounce-validation-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for ZeroBounce's API. It is a proposal applied on top of the contract, not a document ZeroBounce publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 3

$.info
$.paths['/api/validation/chatgpt-single-email-validation/'].post
$.paths['/api/validation/chatgpt-batch-validation/'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ZeroBounce Validate Email plugin Validation API
  version: 1.0.0
extends: openapi/zerobounce-validation-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/api/validation/chatgpt-single-email-validation/'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a single email address is valid
      effect: read
      questions:
      - How do I check if one email address is real before I send to it?
      - Can I validate a single email with ZeroBounce without an API key?
      - What is the daily limit on single-address checks if I don't supply a key?
      instructions:
      - text: Validate the email address {email}.
        slots:
          email: requestBody.email
      - text: Check whether {email} is deliverable using my API key {api_key}.
        slots:
          email: requestBody.email
          api_key: requestBody.api_key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/validation/chatgpt-batch-validation/'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a list of email addresses in one request
      effect: read
      questions:
      - Is there a way to verify a whole list of email addresses at once?
      - Which emails in my comma-separated mailing list are invalid?
      - Does checking many addresses in bulk require an API key?
      instructions:
      - text: 'Validate this batch of emails: {emails}, using API key {api_key}.'
        slots:
          emails: requestBody.emails
          api_key: requestBody.api_key
      - text: Run a bulk check on the addresses {emails} with my key {api_key} and tell me which are bad.
        slots:
          emails: requestBody.emails
          api_key: requestBody.api_key
      method: generated
      generated: '2026-10-01'