Skip to content

GET /health

Returns the current service status along with lists of all available fonts, formats, and templates. Useful for validating your integration and discovering available options programmatically.

GET https://og-engine.com/health

Authentication: Not required Rate limiting: Not applied

Terminal window
curl https://og-engine.com/health
{
"status": "ok",
"version": "0.1.0",
"fonts": [
"Outfit",
"Inter",
"Playfair Display",
"Sora",
"Space Grotesk",
"JetBrains Mono",
"Noto Sans JP",
"Noto Sans AR"
],
"formats": [
"og",
"twitter",
"square",
"linkedin",
"story"
],
"templates": [
"default",
"social-card",
"blog-hero",
"email-banner"
]
}
FieldTypeDescription
statusstring"ok" when the service is healthy
versionstringCurrent API version
fontsstring[]All available font family names (use these exact strings in style.font)
formatsstring[]All available format presets (use these in format)
templatesstring[]All available template names (use these in template)
StatusMeaning
"ok"All systems operational
"degraded"Service is operational but some functions may be slower than usual
"maintenance"Planned maintenance in progress; renders may be temporarily unavailable

In normal operation you will always see "ok". Subscribe to status.og-engine.com for real-time uptime notifications.

The fonts array in the response is the authoritative list of valid values for style.font. You can fetch it at startup to populate a font selector in your UI:

const { fonts } = await fetch('https://og-engine.com/health').then(r => r.json())
// ['Outfit', 'Inter', 'Playfair Display', ...]