メーカー・店舗向け

顧客・CRM API

顧客属性・購買傾向・LTVを取得し、セグメントマーケティングに活用できます。顧客プロフィールの管理と購買履歴の取得が可能です。

api/v1/store/customers View in API Reference

Endpoints

Method Path Description Response
GET /api/v1/store/customers/{id} 顧客プロフィールを取得
デモグラフィック情報、ロイヤルティ情報、購買統計を含む顧客プロフィールを取得します。
 200 404
GET /api/v1/store/customers 顧客を検索
デモグラフィック、ロイヤルティランク、行動属性でフィルタリングして検索します。
 200
POST /api/v1/store/customers 顧客を作成・更新（Upsert）
新しい顧客を作成するか、顧客IDに基づいて既存レコードを更新します。
 200
GET /api/v1/store/customers/{id}/purchases 顧客の購買履歴を取得
顧客に紐づく最近のレシート一覧を返します。
 200
DELETE /api/v1/store/customers/{id} 顧客プロフィールを削除
CRMシステムから顧客レコードを削除します。
 204 404

Endpoint details

デモグラフィック情報、ロイヤルティ情報、購買統計を含む顧客プロフィールを取得します。

Full path: GET /api/v1/store/customers/{id}
Response codes: 200 404

デモグラフィック、ロイヤルティランク、行動属性でフィルタリングして検索します。

Full path: GET /api/v1/store/customers
Response codes: 200

新しい顧客を作成するか、顧客IDに基づいて既存レコードを更新します。

Full path: POST /api/v1/store/customers
Response codes: 200

顧客に紐づく最近のレシート一覧を返します。

Full path: GET /api/v1/store/customers/{id}/purchases
Response codes: 200

CRMシステムから顧客レコードを削除します。

Full path: DELETE /api/v1/store/customers/{id}
Response codes: 204 404

Example request

Request 
GET /api/v1/store/customers/{id}
Authorization: Bearer {access_token}
Response 
{
  "id": "cust-001",
  "name": "田中 太郎",
  "email": "tanaka@example.com",
  "rank": "Gold",
  "totalSpend": 156000,
  "visitCount": 42,
  "lastVisit": "2025-03-15"
}
About authentication

To use this API, the Authorization: Bearer {access_token} header is required. See the authentication guide for how to obtain a token.

View the authentication & access API
To API Reference