" }
**Example — single recipient:**
POST https://app.nautilus.co/api/v1/email
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"to": "customer@example.com",
"subject": "Your monthly wash summary",
"html": "Hi!
You washed 12 times this month.
"
}
**Example — custom sender with reply-to:**
POST https://app.nautilus.co/api/v1/email
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"to": ["customer@example.com", "other@example.com"],
"subject": "Welcome to Squeaky Clean",
"html": "Thanks for joining!
",
"from": "Squeaky Clean ",
"replyTo": "support@squeakyclean.com"
}
**Responses:**
- 200: All emails sent. Body: { "success": true, "results": [{ "to": "...", "success": true, "id": "abc123" }] }
- 207: Partial success. Body: { "success": false, "results": [{ "to": "...", "success": true, "id": "abc123" }, { "to": "...", "success": false, "error": "..." }] }
- 400: Invalid request body (includes `from` that doesn't match the rules for your key type). Body: { "error": "Invalid request format", "details": [...] }
- 401: Bad or missing token. Body: { "error": "Unauthorized" }
- 422: Tenant-scoped key whose tenant has no slug configured. Body: { "error": "Email sending is not configured for this tenant..." }
- 500: Server error. Body: { "error": "..." }
When sending to multiple recipients, each is processed independently. A failure for one does not block others.
### Export members — GET /v1/members
Export membership rows for signup-date, churn, package, site, trial, amount, and raw POS tag analysis.
Requires a tenant-scoped key and an eligible tenant.
**Query parameters:**
| Field | Type | Required | Description |
|-------------|---------------------------|----------|-------------|
| status | all, active, or churned | No | Defaults to all. Invalid values are treated as all. |
| signupStart | date string | No | Inclusive signup lower bound. |
| signupEnd | date string | No | Inclusive signup upper bound. |
| limit | integer | No | Defaults to 500. Maximum 1000. |
| offset | integer | No | Defaults to 0. |
**Example:**
GET https://app.nautilus.co/api/v1/members?status=active&signupStart=2026-01-01&signupEnd=2026-01-31&limit=100
Authorization: Bearer YOUR_API_KEY
**Response shape:**
{ organizationId, filters, pagination, members: [{ membershipId, customerId, signupDate, status, churnType, cancelDate, tenureDays, planName, billingAmount, billingSiteCode, billingSiteName, creationSiteCode, creationSiteName, isOnTrial, trialAmount, tags }] }
### Signup cohorts — GET /v1/cohorts
Aggregate signup-month cohorts overall, by current plan, or by current billing site.
Requires a tenant-scoped key and an eligible tenant.
**Query parameters:**
| Field | Type | Required | Description |
|-----------|-------------------------|----------|-------------|
| start | date string | No | Inclusive lower bound on cohort month. |
| end | date string | No | Inclusive upper bound on cohort month. |
| dimension | none, plan, or site | No | Defaults to none. Invalid values return 400. |
**Example:**
GET https://app.nautilus.co/api/v1/cohorts?dimension=plan&start=2026-01-01&end=2026-06-30
Authorization: Bearer YOUR_API_KEY
**Response shape:**
{ organizationId, dateRange, source: "membership_signup", available: true, dimension, signupDateCoverage, dimensionValues, cohorts: [{ cohortMonth, dimensionValue, cohortSize, stillActive, churned, voluntary, involuntary, churnRatePct, churnWithin }] }
### Retention offers — GET /v1/retention-offers
Return retention offer views, accepts, declines, acceptance rates, and accepted-vs-declined LTV where supported.
Requires a tenant-scoped key and the retention-offer analytics capability.
**Query parameters:**
| Field | Type | Required | Description |
|-------|-------------|----------|-------------|
| start | date string | No | Inclusive lower bound on offer events. |
| end | date string | No | Inclusive upper bound on offer events. |
**Example:**
GET https://app.nautilus.co/api/v1/retention-offers?start=2026-01-01&end=2026-06-30
Authorization: Bearer YOUR_API_KEY
**Response shape:**
{ organizationId, dateRange, totals: { viewed, accepted, declined, acceptanceRatePct }, offers: [{ offerId, offerName, targetPlanName, targetPlanPrice, viewed, accepted, declined, acceptanceRatePct }], ltv }
If revenue LTV is unsupported or unavailable, ltv contains acceptedMembers: null, declinedMembers: null, coverage: null, and unavailableReason.
### Cancellations — GET /v1/cancellations
Return POS-derived cancellation analytics: voluntary versus involuntary churn, terminal-status reasons, and tenure-at-cancellation statistics.
Requires a tenant-scoped key and an eligible tenant.
**Query parameters:**
| Field | Type | Required | Description |
|-------|-------------|----------|-------------|
| start | date string | No | Inclusive lower bound on cancellation date. |
| end | date string | No | Inclusive upper bound on cancellation date. |
**Example:**
GET https://app.nautilus.co/api/v1/cancellations?start=2026-01-01&end=2026-06-30
Authorization: Bearer YOUR_API_KEY
**Response shape:**
{ organizationId, dateRange, source: "membership_status", available: true, totals, reasons, tenure }
### Cancellation survey — GET /v1/cancellation-survey
Return member-stated cancellation reasons selected in the portal cancellation flow.
Requires a tenant-scoped key. This is separate from POS-derived churn in /v1/cancellations.
**Query parameters:**
| Field | Type | Required | Description |
|-------|-------------|----------|-------------|
| start | date string | No | Inclusive lower bound on survey event timestamp. |
| end | date string | No | Inclusive upper bound on survey event timestamp. |
**Example:**
GET https://app.nautilus.co/api/v1/cancellation-survey?start=2026-01-01&end=2026-06-30
Authorization: Bearer YOUR_API_KEY
**Response shape:**
{ organizationId, dateRange, source: "exit_survey", available, totals: { selections }, reasons: [{ reason, rawCodes, count, pct }], other }
If the analytics source cannot be queried after retries, the endpoint can return 200 with available: false, totals.selections: 0, reasons: [], and other: null.
```