> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stealthera.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first Stealthera API call in under five minutes

This guide walks you from an API key to live device data in three steps.

<Steps>
  <Step title="Get your credentials">
    Request access from [support@stealthera.in](mailto:support@stealthera.in). You will receive the base URL `https://api.stealthera.in` and an API key. All calls authenticate with the `X-API-Key` header — see [Authentication](/authentication).
  </Step>

  <Step title="List your devices">
    Fetch the live list of devices assigned to you, with the latest snapshot and status for each.

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.stealthera.in/api/health-data \
        -H "X-API-Key: YOUR_API_KEY"
      ```

      ```python Python theme={null}
      import requests

      resp = requests.get(
          "https://api.stealthera.in/api/health-data",
          headers={"X-API-Key": "YOUR_API_KEY"},
      )
      devices = resp.json()
      print(devices)
      ```
    </CodeGroup>

    ```json Response theme={null}
    [
      {
        "id": "863758060992848",
        "nickname": "Ward A - Bed 12",
        "model": "H102CSH",
        "deviceId": "863758060992848",
        "status": "Online",
        "steps": 5240,
        "heartRate": 74,
        "bloodOxygen": 97,
        "bodyTemp": 36.6,
        "phone": "+919812345678",
        "updateTime": "2026-06-11 09:42:18"
      }
    ]
    ```

    Each row carries a `deviceId` (the watch IMEI), which you use to address that device in every other endpoint.
  </Step>

  <Step title="Pull a device's vitals">
    Use the `deviceId` to retrieve heart rate, blood pressure, blood oxygen, and body temperature together in one call.

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.stealthera.in/api/device/863758060992848/vitals \
        -H "X-API-Key: YOUR_API_KEY"
      ```

      ```python Python theme={null}
      import requests

      device_id = "863758060992848"
      resp = requests.get(
          f"https://api.stealthera.in/api/device/{device_id}/vitals",
          headers={"X-API-Key": "YOUR_API_KEY"},
      )
      print(resp.json())
      ```
    </CodeGroup>
  </Step>
</Steps>

## Where to next

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, schema, and example with an interactive playground.
  </Card>

  <Card title="Hospital Integration" icon="hospital" href="/guides/hospital-integration">
    Polling cadence, device-to-patient mapping, and alert handling.
  </Card>
</CardGroup>
