Programmatic status

Query real-time service health for all Truthlocks services. No authentication required.

Returns the current health status of every Truthlocks service. Use this endpoint to integrate service availability into your own dashboards, alerting pipelines, or circuit breakers.

This endpoint is served from status.truthlocks.com, not the main API. No authentication is required.

GET https://status.truthlocks.com/api/health

Response

Response fields

Field	Type	Description
status	string	Overall system health: operational, degraded, or outage.
timestamp	string	ISO 8601 timestamp of the check.
services	array	Per-service health results.
services[].id	string	Machine-readable service identifier (e.g., api-gateway, signing-service).
services[].name	string	Human-readable service name.
services[].status	string	Service health: operational, degraded, or outage.
services[].responseTime	number or null	Response time in milliseconds, or null if unreachable.
services[].error	string	Present only when the service is not operational. Describes the failure reason.

Status logic

• operational — all services are healthy and responding normally.
• degraded — at least one service is slow or returning errors, but none are fully down.
• outage — at least one service is completely unreachable.

Monitored services

Service ID	Name	Description
api-gateway	API Gateway	Main API endpoint for all public requests
trust-registry	Trust Registry	Issuer management and governance
billing-service	Billing	Subscription and payment processing
signing-service	Signing	Cryptographic signing operations
attestation-service	Attestations	Attestation minting and management
audit-service	Audit Logs	Activity logging and compliance
transparency-log	Transparency Log	Cryptographic append-only log
verification-service	Verification	Proof bundle verification

Example: poll status from your application

async function checkTruthlockStatus() {
  const res = await fetch("https://status.truthlocks.com/api/health");
  const data = await res.json();

  if (data.status !== "operational") {
    console.warn(`Truthlocks is ${data.status}`);
    const issues = data.services.filter((s) => s.status !== "operational");
    issues.forEach((s) =>
      console.warn(`  ${s.name}: ${s.status} — ${s.error}`)
    );
  }

  return data;
}

Example: pre-flight check before minting

async function mintWithStatusCheck(attestation) {
  const status = await fetch("https://status.truthlocks.com/api/health");
  const health = await status.json();

  const signingService = health.services.find(
    (s) => s.id === "signing-service"
  );
  const attestationService = health.services.find(
    (s) => s.id === "attestation-service"
  );

  if (
    signingService?.status !== "operational" ||
    attestationService?.status !== "operational"
  ) {
    throw new Error("Required services are not operational — retry later");
  }

  return client.attestations.mint(attestation);
}

This endpoint is rate-limited to prevent abuse. For continuous monitoring, poll no more frequently than once every 30 seconds.