openapi: 3.1.0
info:
title: Meilisearch Documents Health API
description: 'Meilisearch is an open-source, lightning-fast search engine API. This specification
documents the core REST endpoints for managing indexes, documents, search, settings,
API keys, and tasks. All protected routes require Bearer token authentication using
a master key or regular API key.
'
version: '1.0'
contact:
name: Meilisearch
url: https://www.meilisearch.com/docs
servers:
- url: http://localhost:7700
description: Default local Meilisearch instance
- url: https://{cluster}.meilisearch.io
description: Meilisearch Cloud instance
variables:
cluster:
default: edge
security:
- bearerAuth: []
tags:
- name: Health
paths:
/health:
get:
tags:
- Health
summary: Health check
description: Returns the health status of the Meilisearch instance.
security: []
responses:
'200':
description: Instance is healthy
/version:
get:
tags:
- Health
summary: Get version
description: Returns the version of the running Meilisearch instance.
responses:
'200':
description: Version information
/stats:
get:
tags:
- Health
summary: Get global stats
description: Returns aggregate statistics across all indexes.
responses:
'200':
description: Stats payload
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: token
description: 'Authorization header using "Authorization: Bearer {API_KEY}".
The master key authorizes /keys management; regular API keys
should be used for all other routes.
'