PingFlow REST API

Overview

The PingFlow API is organized around REST. Our API has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

The base URL for all v1 endpoints is:

Authentication

The PingFlow API uses API keys to authenticate requests. You can view and manage your API keys in the PingFlow Dashboard.

Authentication to the API is performed via HTTP Bearer Auth. Provide your API key as the bearer token value in the Authorization header.

curl -X GET "https://pingflow.online/api/check?url=netflix.com" \
  -H "Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxx"

Rate Limits

API requests are rate-limited to ensure system stability. Rate limits are evaluated on a per-minute basis based on your subscription tier.

GET /api/check

Performs a standard infrastructure health check against a target URL. Returns server status, ICMP ping latency, HTTP status code, and basic IP details.

Parameters

• url Required string

  The target domain to check (e.g., netflix.com).

Response Example

{
  "online": true,
  "ping": 45,
  "httpCode": 200,
  "ssl": "Valid",
  "ip": "54.239.28.85",
  "location": "Seattle, US",
  "asn": "Amazon.com Inc."
}

GET /api/dns

Perform an authoritative DNS lookup against a domain to retrieve A, AAAA, MX, TXT, NS, and CNAME records, completely bypassing local browser cache.

Parameters

• domain Required

  The domain to query (e.g., pingflow.online).

• type Optional

  Specific record type to fetch (e.g., A, MX, TXT). Defaults to A.

Response Example

{
  "success": true,
  "domain": "pingflow.online",
  "latency": 12,
  "provider": "Cloudflare",
  "records": [
    "188.114.96.0",
    "188.114.97.0"
  ]
}

GET /api/ssl

Perform a deep-packet inspection of the target's TLS/SSL handshake. Extracts issuer, validity dates, vulnerability scores, and cipher suites.

Parameters

• domain Required

Response Example

{
  "domain": "stripe.com",
  "valid": true,
  "issuer": "DigiCert Inc",
  "daysRemaining": 241,
  "grade": "A+",
  "tls": "TLSv1.3"
}

GET /api/port-scan

Probes common TCP/IP ports on the target host to identify open services, firewall filtering, and database exposures.

Parameters

• host Required
• ports Optional

  Comma-separated list of ports (e.g., 80,443,22,3306). Max 50 ports per request.