Skip to main content

Modash API Health Endpoint

API Health Endpoint Definition

Niklas Hisinger avatar
Written by Niklas Hisinger
Updated over a week ago

What is the Health Endpoint?

The Health Endpoint provides real-time status updates on Modash API's monitored services. Each service can have one of three statuses:

  • Healthy

  • Degraded

  • Unhealthy

How is Health Status Determined?

We evaluate the most recent 50 requests made within the past 5 minutes for the following endpoints/groups:

  • email-search

  • search

  • reports

  • reports-audience-overlap

  • performance-data

  • Discovery endpoints starting with Instagram, TikTok, or YouTube

A request is marked as failed if:

  • It returns an HTTP status code of 500 or higher.

  • It takes longer than 20 seconds to complete.

Status Definitions:

  • Healthy: Less than 20% of requests failed, or no requests in the past 5 minutes.

  • Degraded: Between 20% and 40% of requests failed.

  • Unhealthy: More than 40% of requests failed.

Important Notes:

  • The overall health status reflects the worst-performing endpoint.

  • RAW API endpoints are excluded from health calculations.

  • For detailed per-endpoint statistics, refer to your service logs.

API Documentation

Detailed public documentation for the Health Endpoint is available here.

Did this answer your question?