# Nefesh Human State API

**Canonical:** https://apis.io/apis/nefesh-ai/nefesh-human-state-api/  
**Provider:** Nefesh AI — https://apis.io/providers/nefesh-ai/  
**Base URL:** https://api.nefesh.ai  
**Documentation:** https://nefesh.ai/docs/api

Nefesh Human State API is one of 4 APIs that [Nefesh AI](https://apis.io/providers/nefesh-ai/) publishes on the [APIs.io](https://apis.io/) network. This API exposes 1 JSON Schema definition. Tagged areas include Biometrics, Stress Detection, Human State, Webhook, and Device Registry. The published artifact set on APIs.io includes an API reference, API documentation, a getting-started guide, authentication docs, and 1 JSON Schema.

REST API on api.nefesh.ai (FastAPI): POST /v1/ingest takes a session_id, an ISO 8601 timestamp and at least one of 35+ signal fields and returns the fused state, stress_score, confidence, suggested_action and (from the second call) adaptation_effectiveness; GET /v1/state, GET /v1/history (1-60 minute lookback), GET /v1/triggers (per-subject trigger memory), POST/GET/DELETE /v1/devices (device registry), DELETE /v1/subjects/{subject_id} (GDPR cascading deletion), POST /webhooks/register and /webhooks/retries. Device-optimised ingest routes at /ingest/rppg, /ingest/polar, /ingest/garmin. Authenticated with the X-Nefesh-Key header (keys prefixed nfsh_). Response format is the open Human State Protocol. No OpenAPI is published; api.nefesh.ai/openapi.json and /docs are 404 and a custom HTML page respectively.

## Machine-readable artifacts (14)

- **APIReference** — https://nefesh.ai/docs/api
- **Documentation** — https://nefesh.ai/docs
- **GettingStarted** — https://nefesh.ai/docs/quickstart
- **Documentation** — https://nefesh.ai/docs/v1-ingest
- **Documentation** — https://nefesh.ai/docs/states
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/json-schema/nefesh-ai-hsp-1.0.schema.json
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/asyncapi/nefesh-ai-webhooks.yml
- **Webhooks** — https://nefesh.ai/docs/webhooks
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/authentication/nefesh-ai-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/errors/nefesh-ai-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/data-model/nefesh-ai-data-model.yml
- **SourceCode** — https://github.com/nefesh-ai/nefesh-examples
- **X-Health** — https://api.nefesh.ai/health
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/nefesh-ai/refs/heads/main/apis.yml

## Other Nefesh AI APIs (3)

- [Nefesh Cognitive Compute Router](https://apis.io/apis/nefesh-ai/nefesh-cognitive-compute-router/)
- [Nefesh MCP Server](https://apis.io/apis/nefesh-ai/nefesh-mcp-server/)
- [Nefesh Human State Agent (A2A)](https://apis.io/apis/nefesh-ai/nefesh-human-state-agent-a2a/)

## Tags

Biometrics, Stress Detection, Human State, Webhook, Device Registry

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nefesh-ai/nefesh-human-state-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nefesh-ai/.