Cano Analytics REST API: Reference and Quick Start

The Cano Analytics REST API gives you programmatic access to everything the platform can do — track events, identify users, query dashboard data, and automate workspace workflows. Any HTTP client can integrate with it, and all endpoints share the same conventions so you can move quickly from your first request to a production-grade integration.

Base URL

All API requests are made to the following base URL:

https://api.canoanalytics.io/v1

API Conventions

Before making your first request, familiarize yourself with the conventions used across every endpoint. Requests and responses All request bodies must be sent as JSON, and all responses are returned as JSON. Include the Content-Type: application/json header on every request that sends a body. Timestamps All timestamps are formatted as ISO 8601 strings in UTC (e.g., 2024-11-01T14:32:00Z). Resource IDs Every resource has a prefixed string ID that indicates its type at a glance:

Prefix	Resource
`evt_`	Events
`usr_`	Users
`dash_`	Dashboards
`rpt_`	Reports

Errors Failed requests return a JSON body with a top-level error object containing a machine-readable code and a human-readable message. Use error.code in your error-handling logic and error.message for logging.

Quick Example

The following request tracks a page_viewed event for a user. Swap in your own API key, user ID, and properties to run it immediately.

curl -X POST https://api.canoanalytics.io/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "event": "page_viewed", "user_id": "usr_123", "properties": { "page": "/pricing" } }'

Response Format

Every API response follows one of two shapes depending on whether the request succeeded or failed.

Success
Error

A successful response returns a 2xx status code and a JSON body describing the created or queried resource.

Success Response

{
  "id": "evt_abc123",
  "status": "queued"
}

A failed response returns a 4xx or 5xx status code and a JSON body with an error object.

Error Response

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Next Steps

Before making API calls, set up authentication and review the rate limits so your integration stays healthy.

Authentication

Learn how to generate API keys and attach them to every request.

Rate Limits

Understand per-endpoint quotas and how to handle 429 responses gracefully.

Explore the API

Events

Track user actions and custom events from any source.

Users

Identify users and enrich their profiles with traits.

Dashboards

Query and manage your analytics dashboards programmatically.

Reports

Generate and export reports from your workspace data.

Overview

Endpoints

SDKs

Cano Analytics REST API: Reference and Quick Start

Base URL

API Conventions

Quick Example

Response Format

Next Steps

Authentication

Rate Limits

Explore the API

Events

Users

Dashboards

Reports

​Base URL

​API Conventions

​Quick Example

​Response Format

​Next Steps

Authentication

Rate Limits

​Explore the API

Events

Users

Dashboards

Reports

Base URL

API Conventions

Quick Example

Response Format

Next Steps

Explore the API