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

# Data API

> Programmatic access to your conversation analytics

## Overview

The Moda Data API provides read access to your conversation analytics data. Use it to programmatically query conversations, monitor user frustration, investigate tool failures, and explore topic clusters.

## Access Methods

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal" href="/data-api/cli">
    Query your analytics directly from the terminal. Search conversations, investigate frustrations, debug tool failures.
  </Card>

  <Card title="REST API" icon="code">
    Direct HTTP access to all Data API endpoints. Authenticate with your Moda API key.
  </Card>
</CardGroup>

## Available Data

| Category          | Description                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------ |
| **Overview**      | Dashboard KPIs, top clusters, recent activity                                                                |
| **Conversations** | Search, filter, and retrieve conversation context                                                            |
| **World State**   | Search conversations by world-state/profile keywords; inspect a conversation's slots, threads, and event log |
| **Clusters**      | Browse topic cluster hierarchy                                                                               |
| **Frustrations**  | User frustration detections with evidence                                                                    |
| **Tool Failures** | Tool failure overview and per-tool detail                                                                    |

## Authentication

All Data API access requires a Moda API key. Get yours from [Settings](https://moda.dev/settings).

The API key is passed as an `x-api-key` header for REST requests, or as the `MODA_API_KEY` environment variable for the CLI.

<Info>
  The Data API is read-only. To send conversation data to Moda, see the [Ingestion](/ingestion/overview) docs.
</Info>