Quick Start
Overview
The Statement Agent API provides a simple way to interact with your organization's connected business data using natural language. Through a project-scoped API key, applications can query the Statement AI agent, retrieve usage metrics, and inspect connected data sources available within a project.
The API is designed to provide secure access to business insights without exposing underlying infrastructure, routing logic, database schemas, AI providers, or internal project configurations. All requests are scoped to the authenticated project, ensuring that responses only contain information accessible within that project's environment.
Whether you're building internal dashboards, AI-powered assistants, workflow automations, or custom analytics applications, the Agent API enables you to access Statement's intelligence layer through a straightforward REST interface.
Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/agent/query | Submit a natural language question and receive an AI-generated response based on your project's connected data sources. |
GET | /api/v1/agent/usage/tokens | Retrieve aggregate token usage statistics for the authenticated project. |
GET | /api/v1/agent/services | List all connected services and integrations available to the authenticated project. |
Authentication
All Agent API endpoints require authentication using a valid project API key. Include your API key in the request headers for every API call.
Requests made with an API key are automatically scoped to the associated project and can only access data, services, and resources available within that project.
Response Behavior
For security and privacy reasons, API responses are intentionally limited to business-facing information. The API does not expose:
- Internal routing decisions
- AI model or provider selection details
- Database schemas or connection information
- Project configuration settings
- Service credentials or authentication details
- System-level implementation information
This abstraction allows applications to consume insights and data confidently while maintaining the security of the underlying platform.