---
title: "Diagnostics"
method: GET
path: "/v1/doctor"
tags: ["System"]
---

# Diagnostics

`GET /v1/doctor`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/doctor`
- Auth: none required

Public diagnostics — basic shape always; `version`, `uptime_seconds`, and provider health only when called with an admin-scoped API key. If a valid key is supplied, also returns key_info (tier, scopes, daily quota state).

## Response `200`

Diagnostic snapshot

- object
  - `api` 'ok', required
  - `timestamp` string, date-time, required
  - `version` string: Semantic version (admin scope only)
  - `uptime_seconds` number: Process uptime in seconds (admin scope only)
  - `db` object: Database health (admin scope only)
    - `status` string
    - `latency_ms` number
  - `providers` object: Per-provider circuit-breaker state (admin scope only)
  - `key_info` object: Present when caller supplied a valid X-API-Key
    - `tier` 'free' | 'builder' | 'pro' | 'enterprise'
    - `scopes` string[]
    - `daily_remaining` integer
    - `daily_limit` integer

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)