# Smile.io

**Canonical:** https://apis.io/providers/smile-io/  
**Website:** https://smile.io  
**APIs profiled:** 9

Smile.io is a loyalty, rewards, and referrals platform for e-commerce brands (widely used on Shopify). Merchants run points programs, referral programs, and VIP tiers, and integrate them programmatically through the Smile.io REST API (base https://api.smile.io/v1). The REST API exposes customers and customer identities, points transactions and settings, points products and purchases, earning rules, rewards and reward fulfillments, VIP tiers, and custom activities. It uses resource-oriented URLs, returns JSON, and is authenticated with an HTTP Bearer token (a merchant API key or an app OAuth access token). REST API access is gated to the Plus and Enterprise plans.

## Kin Score — 37.5 / 100 (thin)

Scored 2026-08-25 under rubric 0.14.0. Trend: flat (+0.0 from 37.5).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 55.2 |
| Governance | 0.0 |
| Contract Governance | 0.0 |
| Operational Transparency | 31.6 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 39.5 |
| Access Clarity | 39.5 |

## Agent readiness — 22.3 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | partial |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (9)

- **Smile.io Activities API** — Record custom customer activities that can earn points.
- **Smile.io Customer Identities API** — Create or update a customer from an external system identity.
- **Smile.io Customers API** — Loyalty program members and their point balances and state.
- **Smile.io Earning Rules API** — Rules that define how customers earn points.
- **Smile.io Points Products API** — Redeemable products a customer can purchase with points.
- **Smile.io Points Settings API** — Program-level points configuration (currency name, ratios).
- **Smile.io Points Transactions API** — Point balance changes - earn, redeem, adjust - for a customer.
- **Smile.io Reward Fulfillments API** — Fulfillment records for rewards a customer has redeemed.
- **Smile.io VIP Tiers API** — VIP program tiers and their thresholds and perks.

## Agentic access (1)

- **Smile Io Agentic Access** — 14 operations · 4 acting

## Security (2)

- **Smile Io Authentication** — http · 1 scheme
- **Smile Io Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Smile Io Plans Pricing**

## Tags

Loyalty, Rewards, Referrals, E-Commerce, Points, Customer Retention, Shopify

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/smile-io/). Scores are computed from the provider's own public artifacts under a published rubric.
