Skip to main content

OpenAPI Specification

Use the OpenAPI spec when generating SDKs, configuring coding agents, or validating integrations against the current public API contract.

Download OpenAPI JSON

Machine-readable OpenAPI 3.1 reference for available-now Email Validation, Premium Catch-All Recovery, account credit balance, and health probes.

Scope

The spec documents the available-now public API surface:
  • POST https://api.gtmapis.com/v1/validate
  • POST https://api.gtmapis.com/v1/validate/bulk
  • POST https://api.gtmapis.com/v1/validate/batch
  • POST https://api.gtmapis.com/v1/csv/prepare-upload
  • POST https://api.gtmapis.com/v1/csv/start-processing
  • GET https://api.gtmapis.com/v1/csv/jobs
  • GET https://api.gtmapis.com/v1/csv/jobs/{id}
  • GET https://api.gtmapis.com/v1/csv/jobs/{id}/download
  • POST https://api.gtmapis.com/v1/csv/jobs/{id}/recover-catchalls
  • GET https://api.gtmapis.com/v1/csv/jobs/{id}/recovery
  • GET https://api.gtmapis.com/v1/credits
  • GET https://api.gtmapis.com/health
  • GET https://api.gtmapis.com/ready
  • GET https://api.gtmapis.com/live
Social Intelligence, Ad Intelligence, Company Intelligence, Email Finder, People Data, and Prospecting are future, gated, or dormant surfaces until they are promoted in the public product catalog and docs navigation.

Source of Truth

The canonical public API host is:
All public examples should combine that host with public paths such as /v1/validate, not website-internal Next.js route paths such as /api/v1/validate.