Skip to main content

Modash API Health Endpoint

API Health Endpoint Definition

Niklas Hisinger avatar
Written by Niklas Hisinger
Updated over 10 months 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?