メインコンテンツまでスキップ

GET /v1/customers/{id}

scope

read_customers

リクエストパラメーター

名前位置必須説明
idパスinteger任意

レスポンスの例

{
"data": {
"id": "42",
"line_uid": "string",
"name": "山田太郎",
"avatar_url": "string",
"is_blocked": true,
"profile": {
"last_name": "string",
"first_name": "string",
"zip": "string",
"pref": "string",
"city": "string",
"address_1": "string",
"address_2": "string",
"tel": "string",
"email": "string",
"gender": "male"
}
}
}

解説

顧客の詳細を取得します。read_customers_pii を持つ場合のみ profile(氏名・住所・電話・メール・性別)が含まれます。

エラーレスポンスの例

{
"error": {
"code": "insufficient_scope",
"message": "requires scope 'read_orders'",
"request_id": "req_01H..."
}
}

返しうるエラー: 401 / 403 / 404