Skip to main content

​
API Reference

The Cortana AI Public API provides programmatic access to contacts, conversations, messages, agents, appointments, conversions, tracking sessions, tags, custom fields, financial data (Stripe, Shopify, Whop), and voice call logs/transcripts.

​
Base URL

https://app.usecortana.ai/api/v1/businesses/{businessId}
All endpoints are scoped to a business and require Bearer token authentication.

​
Authentication

Authorization: Bearer sk-ak-your-api-key
See Authentication for creating and managing API keys.

​
Response Format

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

​
Endpoint Groups

Contacts

CRUD + tag management for CRM contacts

Conversations

List, read, and update conversation threads

Stripe

Payments, subscriptions, customers, metrics, products

Shopify

Orders, customers, products, analytics, abandoned carts

Whop

Payments, connections, customers, memberships

Attribution

Full attribution table, UTMs, presets, LTV analysis

Voice Calls

Call logs, metadata, and full transcripts
The endpoint pages below are auto-generated from the OpenAPI specification. You can import the spec into Postman or any API client.