Customers

List customers

get

Header parameters

X-Joy-Loyalty-App-Keystringoptional

App ID of your shop which retrieved from the Settings page

Example: {{appKey}}

X-Joy-Loyalty-Secret-Keystringoptional

Secret Key of your shop which retrieved from the Settings page

Example: {{secretKey}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.joy.so/rest_api/v1/customers'

200

200

{
  "data": [
    {
      "id": "o9AQeUCXYDjbeFm7vAKy",
      "shopifyCustomerId": 7603687882987,
      "email": "[e-mail]",
      "point": 999600,
      "createdAt": "2024-08-26T10:28:33.862Z",
      "updatedAt": "2024-09-26T07:53:28.014Z",
      "totalSpent": 0,
      "orderCount": 0,
      "acceptsMarketing": false,
      "name": "anh anh",
      "state": "enabled",
      "tierId": "dvlOpwxsdATG5RYgr0gz",
      "tierPoint": 0,
      "type": "member",
      "shopId": "umN0f3GKyQC3XS1AwVWg",
      "hasPoint": true,
      "urlReferral": "https://inviteee.to/i/g5ND",
      "latestActivity": "2024-08-27T08:24:07.578Z",
      "phone": null,
      "hasTier": false,
      "pointsRemain": 500
    }
  ],
  "pageInfo": {
    "hasPre": false,
    "hasNext": false
  },
  "count": 1
}

OK

Get a customer

get

Path parameters

customerIdstringrequired

Header parameters

X-Joy-Loyalty-App-Keystringoptional

App ID of your shop which retrieved from the Settings page

Example: {{appKey}}

X-Joy-Loyalty-Secret-Keystringoptional

Secret of your shop which retrieved from /settings/managingKey

Example: {{secretKey}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.joy.so/rest_api/v1/customers/{customerId}'

200

200

{
  "data": {
    "id": "o9AQeUCXYDjbeFm7vAKy",
    "shopifyCustomerId": 7603687882987,
    "totalSpent": 0,
    "orderCount": 0,
    "name": "anh anh",
    "state": "enabled",
    "shopId": "umN0f3GKyQC3XS1AwVWg",
    "type": "member",
    "acceptsMarketing": false,
    "email": "[e-mail]",
    "createdAt": "2024-08-26T10:28:33.862Z",
    "hasPoint": true,
    "urlReferral": "https://inviteee.to/i/g5ND",
    "latestActivity": "2024-08-27T08:24:07.578Z",
    "point": 999600,
    "updatedAt": "2024-09-26T07:53:28.014Z",
    "phone": null,
    "tierId": "dvlOpwxsdATG5RYgr0gz",
    "hasTier": false,
    "tierPoint": 0,
    "tierName": "Silver",
    "pointsRemain": 500
  }
}

OK

Get customer by Shopify ID

get

Retrieve customer information using Shopify customer ID

Path parameters

idintegerrequired

Shopify customer ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.joy.so/customers/shopify-id/{id}'

200

200

{
  "data": {
    "email": "text",
    "name": "text",
    "type": "text",
    "state": "text",
    "orderCount": 1,
    "totalSpent": 1,
    "shopifyCustomerId": 1,
    "acceptsMarketing": true,
    "phone": "text",
    "shopId": "text",
    "insertedBigquery": true,
    "earnSignUp": true,
    "hasPoint": true,
    "like_facebook": true,
    "usedMilestoneEarnPoint": [
      1
    ],
    "latestActivity": "2025-04-02T11:58:23.358Z",
    "point": 1,
    "hasTier": true,
    "tierUpdatedAt": "2025-04-02T11:58:23.358Z",
    "tierId": "text",
    "tierPoint": 1,
    "createdAt": "2025-04-02T11:58:23.358Z",
    "updatedAt": "2025-04-02T11:58:23.358Z",
    "id": "text",
    "pointsRemain": 1,
    "tierName": "text"
  }
}

OK