GET/health

Health check

Returns the availability of the Next.js API and its Reacher dependency. Use it for authenticated monitoring and external uptime checks.

Request

Authenticate with a bearer token and send the following request.

cURL

curl --request GET \
  --url https://api.mailverifio.com/v1/health \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example response

json

{
  "success": true,
  "data": {
    "status": "healthy",
    "timestamp": "2026-08-29T18:30:00.000Z",
    "services": {
      "api": "up",
      "reacher": "up"
    }
  },
  "meta": {
    "requestId": "req_example",
    "duration": 42,
    "version": "v1"
  }
}

Operational notes

The public v1 health endpoint requires the same bearer token as other endpoints.
Use /api/health for an internal container health check that does not require API authentication.
A degraded result means the web API responded but Reacher could not be reached.