---
title: "Send canonical machine-customer commerce events"
method: POST
path: "/v1/events"
---

# Send canonical machine-customer commerce events

`POST /v1/events`

## Request

- Base URL: `https://analytics.davisvillelabs.com`
- URL: `https://analytics.davisvillelabs.com/v1/events`
- Auth: HTTP bearer

## Request body

- object
  - `events` AnalyticsEvent[], required
    - `schema_version` 'davisville-agent-analytics.event.v0', required
    - `event_id` string, required
    - `occurred_at` string, date-time, required
    - `property_id` string, required
    - `stage` 'discovery' | 'evaluation' | 'eligibility_preflight' | 'invocation' | 'payment_challenge' | 'payment_attempt' | 'settlement' | 'delivery' | 'outcome' | 'return_reuse', required
    - `traffic_class` 'confirmed_external' | 'probable_external' | 'unknown_external' | 'customer_test' | 'davisville_test' | 'ci' | 'benchmark' | 'scheduled_monitor' | 'registry_crawler' | 'directory_crawler' | 'health_check' | 'known_bot' | 'other_synthetic'

## Response `200`

Events accepted

## Other responses

- `400`: Validation failed
- `401`: Missing or invalid property credential

---

[API](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface.md) · [All operations](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface/llms.txt) · [OpenAPI document](https://skmtc.dev/davisvillelabs/apis/ai-agent-analytics-agent-interface/revisions/d7f39c451615?raw)