Hosts

Get a host's current state

Current role, verdict, network attribution (IPs/PTR), TLS certificate and operating provider for a host. ?at= returns point-in-time state. profile carries the crawled software identity of the host's registrable domain when one is publishable (curated, or extraction confidence 0.8+ — then unverified).

get/v1/hosts/{hostname}

Request

  • Base URL: https://api.peppolstatus.com
  • URL: https://api.peppolstatus.com/v1/hosts/{hostname}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

hostnamestring required

The host's fully-qualified hostname.

Query parameters

atstring date-time

Point-in-time ISO 8601 instant; omitted returns current state.

Response

The host's state.

hostnamestring required
role'SMP' | 'AP' | 'null' nullable required
verdict'up' | 'degraded' | 'down' | 'unresolvable' | 'null' nullable required

Rolled-up host state (issue #310): a per-location Verdict (up/degraded/down) plus the derived unresolvable — a hostname that has NEVER resolved in DNS. unresolvable is neutral/informational, NOT an outage. null when unknown.

Changes

No recorded changes to this operation across all 1 revision of this API.