会員検索API

＜目次＞

APIの使用法

指定した会員情報の取得を行います。

処理件数

会員情報を最大100件まで一覧で取得できます。

制限事項

futureshop omni-channelご利用店舗様でもご利用いただけます。（他の会員に関する登録・編集・削除APIはご利用いただけません。）
既存会員のパスワードを取得・変更することはできません。新規パスワード登録のみ可能です。

【参考】関連API

最新の更新情報は表のとおりです。
更新履歴はAPI更新履歴一覧をご覧ください。

更新日/予定日	更新内容		更新理由
2025.05.08	レスポンス	「memberList」に以下を追加・LINE UserID：lineUserId ・LINE UserID初回連携日時：lineUserIdLinkFirstTime ・LINE UserID更新連携日時：lineUserIdLinkUpdateTime	外部サービス（CRMなど）と連携し、futureshop会員に対して、LINEメッセージの配信が可能となります。（LINE連携オプションご利用時のみ）	参照

※日付が「予定日」のものは、更新内容が変わる可能性がございます。

リクエストに関する制限

リクエストに関する制限については基本仕様をご覧ください。

認証

アクセストークンの取得については、認証APIをご覧ください。

アクセストークンを用いたAPI利用方法

認証（/oauth/token）以外のAPIでは認証キーとして、/oauth/tokenにて取得したワンタイムパスワードを用います。

エンドポイント

https://{APIドメイン}/admin-api/v1/member

HTTPメソッド

GET

リクエストヘッダー

アクセストークンを用います。
詳細は、アクセストークンによる認証を参照してください。

リクエストボディ

なし

リクエストパラメータ

key	項目名	内容
memberId	会員ID	カンマ区切りで複数指定可能
createDateStart	登録日時(start)	「yyyy-mm-ddThh:mm:ss」形式
createDateEnd	登録日時(end)	「yyyy-mm-ddThh:mm:ss」形式
updateDateStart	最終更新日時(start)	「yyyy-mm-ddThh:mm:ss」形式
updateDateEnd	最終更新日時(end)	「yyyy-mm-ddThh:mm:ss」形式

エラー発生時のHTTPコードとレスポンス

API呼び出し時に問題がある場合は、HTTPコード、またはレスポンスにエラー原因を返します。

詳しくは各API使用時におけるエラー発生時のHTTPコードとレスポンスをご覧ください。

レスポンス

※「文字数」について：ユーザー画面から入力される会員情報とデータをそろえるため、「byte」ではなく「文字数」としております。
※LINE ID連携以外の外部ID連携に関する情報は、2025.04現在検索できません。

key		項目名	必須	型	文字数（※）	内容
nextUrl		ネクストURL		String	-	100件を超過する結果の場合、次のデータ取得のURLを返却（※）
memberList		会員リスト	◯	Array	-	会員ごとに配列出力。最大100件
	memberId	会員ID		String	20
	companyName	会社名		String	100
	companyNameKana	会社名(フリガナ)		String	100
	departmentName	部署名		String	100
	departmentNameKana	部署名(フリガナ)		String	100
	companyTelNo	会社電話番号		String	13	-(半角)区切り
	companyFaxNo	会社ファックス番号		String	13	-(半角)区切り
	lastName	姓		String	200
	firstName	名		String	200
	lastNameKana	姓(フリガナ)		String	200
	firstNameKana	名(フリガナ)		String	200
	mail	Eメールアドレス		String	200
	mobileMail	携帯メールアドレス		String	200
	zipCode	郵便番号		String	7	3桁 -(半角) 4桁
	prefecture	都道府県区分		String	9	※prefecture出力内容
	address1	住所１(市区町村)		String	100
	address2	住所２(番地)		String	100
	address3	住所３(建物名)		String	100
	telNoMain	電話番号		String	13	-(半角)区切り
	telNoAlternate	昼間の連絡先番号		String	13	-(半角)区切り
	faxNo	ファックス番号		String	13	-(半角)区切り
	gender	性別区分		String	11	UNSPECIFIED：指定なし MALE：男性 FEMALE：女性
	birthday	生年月日		String	10	「yyyy-mm-dd」形式
	nickName	ニックネーム		String	50
	newsletter	メールマガジンの購読		String	3	YES：購読 NO：非購読
	mobileNewsletter	モバイルメルマガ受信可否		String	3	YES：可 NO：否
	storeCode	よく行くお店コード		String	10	設定＞実店舗＞店舗（よく行くお店）一覧＞店舗設定-店舗コード／【CC未利用・移行中】構築＞実店舗設定＞新規登録・編集-店舗コード ※会員情報「よく行くお店」を登録時の「店舗コード」が出力されます。
	directMail	郵便DM可否		String	3	YES：可 NO：否
	remarks	備考		Text	-
	memberStageName	会員ステージ		String	30
	memberStageAutoConfig	会員ステージ自動更新		String	3	ON:有効 OFF:無効
	additionalItem1	追加属性項目1		Text	-
	additionalItem2	追加属性項目2		Text	-
	additionalItem3	追加属性項目3		Text	-
	additionalItem4	追加属性項目4		Text	-
	additionalItem5	追加属性項目5		Text	-
	additionalItem6	追加属性項目6		Text	-
	additionalItem7	追加属性項目7		Text	-
	additionalItem8	追加属性項目8		Text	-
	additionalItem9	追加属性項目9		Text	-
	additionalItem10	追加属性項目10		Text	-
	additionalItem11	追加属性項目11		Text	-
	additionalItem12	追加属性項目12		Text	-
	additionalItem13	追加属性項目13		Text	-
	additionalItem14	追加属性項目14		Text	-
	additionalItem15	追加属性項目15		Text	-
	additionalItem16	追加属性項目16		Text	-
	additionalItem17	追加属性項目17		Text	-
	additionalItem18	追加属性項目18		Text	-
	additionalItem19	追加属性項目19		Text	-
	additionalItem20	追加属性項目20		Text	-
	registrationRoute	登録経路		String	6	PC：パソコン MOBILE：モバイル ADMIN：管理画面 SP：スマートフォン API：API
	dateRegistered	登録日時		String	19	「yyyy-mm-ddThh:mm:ss」形式
	dateLastLogin	最終ログイン日時		String	19	「yyyy-mm-ddThh:mm:ss」形式
	dateLastUpdated	最終更新日時		String	19	「yyyy-mm-ddThh:mm:ss」形式
	listUnsubscribeLinkMail	ListUnsubscribeLink（メイン）	◯	Text	-	＜Gmail メール送信者のガイドライン「ワンクリック登録解除」用＞「メールアドレス（メイン）」宛てにメールを送付する際に、出力内容をメールヘッダ（List-Unsubscribe）に記述してください。クリックされると、「メルマガ受信可否：否（02）」となります。
	listUnsubscribeLinkMobileMail	ListUnsubscribeLink（モバイル）	◯	Text	-	＜Gmail メール送信者のガイドライン「ワンクリック登録解除」用＞「メールアドレス（モバイル）」宛てにメールを送付する際に、出力内容をメールヘッダ（List-Unsubscribe）に記述してください。クリックされると、「モバイルメール受信可否：否（02）」となります。
	lineUserId	LINE UserID		String	33	LINE連携オプションご利用時のみ未利用の場合Key出力なし
	lineUserIdLinkFirstTime	LINE UserID初回連携日時		String	19	LINE連携オプションご利用時のみ未利用の場合Key出力なし
	lineUserIdLinkUpdateTime	LINE UserID更新連携日時		String	19	LINE連携オプションご利用時のみ未利用の場合Key出力なし

nextUrlに関する補足

「/v1/member」の後に次のデータを取得するためのパラメータが付与されたURLが返却されます。
（例）「/admin-api/v1/member?createDateStart=2019-10-11T00:00:00&cursor=121」
URLに替えて、nextUrlをGETしていただければ、次の100件のデータを取得できます。

prefecture出力内容

出力		出力		出力		出力
HOKKAIDO	北海道	AOMORI	青森県	AKITA	秋田県	IWATE	岩手県
MIYAGI	宮城県	YAMAGATA	山形県	FUKUSHIMA	福島県	IBARAKI	茨城県
TOCHIGI	栃木県	GUNMA	群馬県	SAITAMA	埼玉県	CHIBA	千葉県
KANAGAWA	神奈川県	TOKYO	東京都	YAMANASHI	山梨県	NIIGATA	新潟県
NAGANO	長野県	SHIZUOKA	静岡県	AICHI	愛知県	MIE	三重県
GIFU	岐阜県	TOYAMA	富山県	ISHIKAWA	石川県	FUKUI	福井県
OSAKA	大阪府	KYOTO	京都府	SHIGA	滋賀県	NARA	奈良県
WAKAYAMA	和歌山県	HYOGO	兵庫県	OKAYAMA	岡山県	HIROSHIMA	広島県
YAMAGUCHI	山口県	TOTTORI	鳥取県	SHIMANE	島根県	KAGAWA	香川県
TOKUSHIMA	徳島県	EHIME	愛媛県	KOCHI	高知県	FUKUOKA	福岡県
SAGA	佐賀県	NAGASAKI	長崎県	KUMAMOTO	熊本県	OITA	大分県
MIYAZAKI	宮崎県	KAGOSHIMA	鹿児島県	OKINAWA	沖縄県	OTHER	その他

エラーレスポンス

エラー発生時に以下のレスポンスが返却されます。

key		項目名	必須	型	byte	内容
status		ステータス	○	String	-	成功：success 失敗：failed ※一部更新失敗の場合、failedを出力
errors		エラーリスト	○	Array	-
	code	コード	○	String	-
	path	パス	○	String	-	エラーが発生したパラメータ名が出力されます
	message	メッセージ	○	String	-

エラーコード

No	code	path	message	項目名	チェック内容	チェック内容	HTTPコード
1	InvalidValue	memberId	memberIdの指定が不正です	会員ID	数値以外を指定した場合に返却されます。	半角数字チェック	422
2	TooLong	memberId	memberIdは20文字以内で指定してください	会員ID	１会員の会員IDが20文字を超過した場合に返却されます。	文字長チェック(20桁)	422
3	InvalidDateFormat	createDateStart	createDateStartの日付フォーマットを正しく指定してください	登録日時	「yyyy-mm-ddThh:mm:ss」形式ではない場合に返却されます。	形式チェック	422
4	InvalidDateFormat	createDateEnd	createDateEndの日付フォーマットを正しく指定してください	登録日時	「yyyy-mm-ddThh:mm:ss」形式ではない場合に返却されます。	形式チェック	422
5	InvalidDateRange	createDateStart	createDateStartはcreateDateEndより前の日時を指定してください	登録日時	会員登録日時の開始日時が終了日時よりも未来日付の場合に返却されます。	期間チェック	422
6	InvalidDateFormat	updateDateStart	updateDateStartの日付フォーマットを正しく指定してください	更新日時	「yyyy-mm-ddThh:mm:ss」形式ではない場合に返却されます。	形式チェック	422
7	InvalidDateFormat	updateDateEnd	updateDateEndの日付フォーマットを正しく指定してください	更新日時	「yyyy-mm-ddThh:mm:ss」形式ではない場合に返却されます。	形式チェック	422
8	InvalidDateRange	updateDateStart	updateDateStartはupdateDateEndより前の日時を指定してください	更新日時	会員更新日時の開始日時が終了日時よりも未来日付の場合に返却されます。	期間チェック	422
9	InvalidValue	cursor	cursorの指定が不正です	カーソル	パラメータが適切に設定されていない場合、返却されます。	数値チェック	422