Skip to content

feat: v2 validate parity (verify_plus, activity_data, batch timeout) - #38

Open
franciscbalint wants to merge 5 commits into
mainfrom
feature/api-parity-p1-validate
Open

franciscbalint wants to merge 5 commits into
mainfrom
feature/api-parity-p1-validate

Conversation

@franciscbalint

@franciscbalint franciscbalint commented Oct 17, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Adds optional activityData / verifyPlus on validateEmail (GET /v2/validate) and validateBatch (POST /v2/validatebatch).
  • Adds batch timeout (10–120s) on validateBatch.
  • Documents active_in_days and active_first_seen on validation result types.

Priority 2 — real-time AI scoring

Priority 3 — bulk finder, list evaluator, filters, S3

  • Bulk email finder: sendEmailFinderFile / sendEmailFinderFileStream, getEmailFinderFileStatus, getEmailFinderFile, deleteEmailFinderFile → bulkapi.zerobounce.net/email-finder/*
  • Bulk domain search: sendDomainSearchFile / sendDomainSearchFileStream, status/get/delete → bulkapi…/domain-search/*
  • List evaluator: sendListEvaluatorFile / sendListEvaluatorFileStream, getListEvaluatorResult, sendEvaluatedFile → bulkapi…/v2/listevaluator/ (+ /v2/send-evaluated-file/)
  • Custom filters: addFilter, listFilters (GET or method: "POST"), deleteFilter → /v2/filters/* on main API
  • S3 helpers: validateS3file, scoreS3file, exportS3file on bulkapi root (per Postman; remove_duplicates / optional column fields documented in types)

Gaps / notes

  • Domain search bulk docs page is sparse; paths match Postman + Spanish docs mirror.
  • S3 listS3files not added (out of P3 scope); validate/score field names follow Postman (remove_duplicates).

Docs

Test plan

  • npm run test:unit (94 tests) — includes Priority 3 URL/body mocks
  • Docker sdk-docs compose javascript image

Deferred

  • POST /v2/validate method parity

Made with Cursor

franciscbalint and others added 5 commits October 18, 2026 00:50
Expose optional verify_plus, activity_data, and batch timeout per v2 docs; extend validation result types with activity fields.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Add bulk email finder and domain search file jobs, list evaluator,
allow/block filters, and S3 validate/score/export helpers aligned with
bulkapi and v2 docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add form-encoded POST option on single validate (alongside GET) and GET
listS3files on bulkapi root, with unit tests and API parity doc updates.
HTML, empty, and account-level failures now reject with a short message, required column 0 and an explicit false header row are sent, and the default test run checks every public method without the network.

Co-authored-by: Cursor <cursoragent@cursor.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant