> ## Documentation Index > Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details. # Create Timeseries > Query analytics timeseries data with metrics, aggregations, and filters ## OpenAPI ````yaml POST /api/v1/analytics/timeseries openapi: 3.1.0 info: title: LangWatch API description: LangWatch openapi spec version: 1.0.0 servers: - url: https://app.langwatch.ai security: - project_api_key: [] paths: /api/v1/analytics/timeseries: post: tags: - Analytics description: Query analytics timeseries data with metrics, aggregations, and filters operationId: postApiAnalyticsTimeseries requestBody: required: true content: application/json: schema: type: object properties: startDate: type: - number - string endDate: type: - number - string query: type: string filters: default: {} type: object propertyNames: type: string enum: - topics.topics - topics.subtopics - metadata.user_id - metadata.thread_id - metadata.customer_id - metadata.labels - metadata.key - metadata.value - metadata.prompt_ids - traces.origin - traces.error - traces.name - spans.type - spans.model - evaluations.evaluator_id - evaluations.evaluator_id.guardrails_only - evaluations.evaluator_id.has_passed - evaluations.evaluator_id.has_score - evaluations.evaluator_id.has_label - evaluations.passed - evaluations.score - evaluations.state - evaluations.label - events.event_type - events.metrics.key - events.metrics.value - events.event_details.key - annotations.hasAnnotation additionalProperties: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string properties: topics.topics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string topics.subtopics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.user_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.thread_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.customer_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.labels: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.prompt_ids: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.origin: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.error: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.name: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.model: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.guardrails_only: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.state: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_details.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string annotations.hasAnnotation: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traceIds: type: array items: type: string negateFilters: type: boolean excludeOrigins: type: array items: type: string series: type: array items: type: object properties: metric: type: string minLength: 1 key: type: string subkey: type: string aggregation: type: string enum: - terms - cardinality - avg - sum - min - max - median - p99 - p95 - p90 pipeline: type: object properties: field: type: string enum: - trace_id - user_id - thread_id - customer_id aggregation: type: string enum: - sum - avg - min - max required: - field - aggregation filters: type: object propertyNames: type: string enum: - topics.topics - topics.subtopics - metadata.user_id - metadata.thread_id - metadata.customer_id - metadata.labels - metadata.key - metadata.value - metadata.prompt_ids - traces.origin - traces.error - traces.name - spans.type - spans.model - evaluations.evaluator_id - evaluations.evaluator_id.guardrails_only - evaluations.evaluator_id.has_passed - evaluations.evaluator_id.has_score - evaluations.evaluator_id.has_label - evaluations.passed - evaluations.score - evaluations.state - evaluations.label - events.event_type - events.metrics.key - events.metrics.value - events.event_details.key - annotations.hasAnnotation additionalProperties: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string properties: topics.topics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string topics.subtopics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.user_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.thread_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.customer_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.labels: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.prompt_ids: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.origin: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.error: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.name: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.model: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.guardrails_only: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.state: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_details.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string annotations.hasAnnotation: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string asPercent: type: boolean required: - metric - aggregation groupBy: type: string minLength: 1 groupByKey: type: string timeScale: anyOf: - type: string const: full - type: integer minimum: -9007199254740991 maximum: 9007199254740991 timeZone: type: string shouldSkipPreviousPeriod: type: boolean required: - startDate - endDate - series - timeZone responses: '200': description: Success content: application/json: schema: type: object properties: currentPeriod: type: array items: type: object propertyNames: type: string additionalProperties: {} previousPeriod: type: array items: type: object propertyNames: type: string additionalProperties: {} required: - currentPeriod - previousPeriod additionalProperties: false '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error security: - project_api_key: [] components: securitySchemes: project_api_key: type: apiKey in: header name: X-Auth-Token description: >- Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.