---
title: "ゲストの取得(レガシー)"
slug: "retrieve-a-guest--legacy-"
abstract: "Sitecore CDPゲストのREST APIを使ってゲストを呼び戻す方法を説明しています。"
---
# ゲストの取得(レガシー)

> !重要[このREST APIの新しいバージョン(v2.1)が利用可能です](https://api-docs.sitecore.com/cdp/guest-rest-api)。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、[v2とv2.1の違いについて読](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/differences-between-v2-and-v2-1-of-the-guest-and-guest-data-extension-rest-apis.html "Differences between v2 and v2.1 of the Guest and Guest data extension REST APIs") んでアップグレードしましょう。

GET /v2/guests/<guestRef>

ゲストの完全なゲスト記録を取得し、ゲスト [データ拡張](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-data-extension-rest-api-v2--legacy-.html "Guest data extension REST API v2 (legacy)")も含めて取得します。

属性

種類

概要

例

guestRef

ストリング

ゲストレコードの参照。  
  
ゲストの紹介がわからない場合は、まず [ゲストを回収](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/retrieve-guests--legacy-.html)しましょう。

f7aabbca-1c1b-4fc2-be72-3e16294a4f03

curl -X GET '<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03' \\
-u '<username>:<password>' \\
-H 'Accept: application/json'

{
 "href": "<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref": "f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt": "2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt": "2026-08-23T16:\`17:16\`.000Z",
 "firstSeen": "2026-03-07T16:\`15:11\`.000Z",
 "lastSeen": "2026-08-23T16:\`17:16\`.000Z",
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "passportExpiry": "2033-01-01T00:\`00:00\`.000Z",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "IE",
 "postCode": "D2",
 "state": "Dublin",
 "identifiers": 
 {
 "provider": "BXLP",
 "id": "123456",
 "expiryDate": "2016-08-23T16:\`17:16\`.000Z"
 }
 
}