Skip to main content
GET
/
customers
/
{id}
Retrieve a customer
curl --request GET \
  --url https://api.smile.io/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "customer": {
    "id": 304169228,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@doe.com",
    "state": "member",
    "date_of_birth": "1004-05-27",
    "points_balance": 300,
    "referral_url": "http://i.refs.cc/9qr5Pw",
    "vip_tier_id": 426715794,
    "vip_status": {
      "vip_tier_id": 426715794,
      "vip_tier_expires_at": "2026-12-31T23:59:59.999Z",
      "progress_value": 300,
      "current_vip_period_end": "2025-12-31T23:59:59.999Z",
      "delta_to_retain_vip_tier": 123,
      "next_vip_tier_id": 426715799,
      "delta_to_next_vip_tier": 200
    },
    "created_at": "2024-04-04T15:10:42.030Z",
    "updated_at": "2025-04-04T15:10:42.030Z"
  }
}
This endpoint requires the scope.
To lookup customers by email, use the list customers endpoint instead.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
integer
required

ID of the customer (in Smile) to retrieve.

Query Parameters

​
include
enum<string>

A comma-separated list of related objects to include in the response.

Available options:
vip_status,
vip_status.vip_tier,
vip_status.next_vip_tier

Response

200 - application/json

The customer was successfully retrieved.

​
customer
object