Retrieve a guest data extension (legacy)

Important

A newer version of this REST API (v2.1) is available. If you're new to the Guest REST API, use the new version. Alternatively, if you're already using the old version, read about the differences between v2 and v2.1 so you can upgrade.

GET /v2/guests/guestRef/extext/<dataExtensionRef>

Retrieves an expanded guest data extension for a guest. To retrieve a list of all guest data extensions, retrieve the guest.

Attribute	Type	Description	Example
`guestRef`	string	The reference of the guest record. If you do not know the guest reference, first retrieve guests.	`f7aabbca-1c1b-4fc2-be72-3e16294a4f03`
`dataExtensionRef`	string	The reference of the data extension. If you do not know the data extension reference, first create a guest data extension.	`09bfc8cc-3815-5b77-b75a-d3cc6a867c1a`

Attribute

Type

Description

Example

guestRef

string

The reference of the guest record.

If you do not know the guest reference, first retrieve guests.

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

dataExtensionRef

string

The reference of the data extension.

If you do not know the data extension reference, first create a guest data extension.

09bfc8cc-3815-5b77-b75a-d3cc6a867c1a

curl -X GET '<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext/09bfc8cc-3815-5b77-b75a-d3cc6a867c1a' \
-u '<username>:<password>' \
-H 'Accept: application/json'

{
    "href": "<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext/09bfc8cc-3815-5b77-b75a-d3cc6a867c1a",
    "ref": "09bfc8cc-3815-5b77-b75a-d3cc6a867c1a",
    "key": "default",
    "createdAt": "2025-12-16T07:53:19.253Z",
    "modifiedAt": "2025-12-16T07:53:41.572Z",
    "vipMember": true,
    "loyaltyTier": "level2",
    "rewardBalance": 5012.25,
    "loyaltyNumber": 3452,
    "guest": {
        "href": "<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
    }
}

If you have suggestions for improving this article, let us know!