Retrieving Personalization Details & Production Files

Last updated: July 30, 2026

This guide explains how to retrieve the personalization details for an order item using the personalizationGUID you stored at cart time.

When You Need This

If you stored the full postMessage payload (including options, previewUrl, and exportedFiles) when the shopper added the item to the cart, you already have everything you need—no API call is required.

Tip

Storing the complete postMessage payload when the item is added to the cart is the recommended approach, as it eliminates the need to retrieve the personalization details later.

However, if you only stored the personalizationGUID, you can retrieve the full personalization details at any time via the Customily API.

Even if you didn't store the personalization data at cart time, you can still retrieve it by order ID—as long as you included your e-commerce platform's order ID in the /standalone/cart call when creating the cart record.

Retrieving Personalization Details

By Personalization GUID

Retrieve the personalization details for a single item using its personalizationGUID.

GET https://sh.customily.com/api/standalone/item/{personalizationGUID}
Authorization: Bearer <JWT_TOKEN>

Example request:

curl -X GET "https://sh.customily.com/api/standalone/item/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer eyJhbGciOi..."

Response:

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "quantity": 1,
    "productId": "0313370a-e3d1-4b88-8640-f1027a78235d",
    "previewUrl": "https://cdn.customily.com/shopify/assetFiles/previews/yourstandalonestore.com/c611faa2-....jpeg",
    "productionUrl": "https://cdn.customily.com/ExportFile/...",
    "optionsJson": "[{\"name\":\"Name\",\"value\":\"John\",\"type\":\"Text Input\"},{\"name\":\"Date\",\"value\":\"June 15, 2025\",\"type\":\"Text Input\"}]",
    "exportedFiles": [
        { "url": "https://cdn.customily.com/ExportFile/..." }
    ],
    "createdDate": "2025-06-15T14:30:00.000Z",
    "generated": false
}

The response includes the following fields:

Field	Type	Description
`id`	string	The personalization GUID
`quantity`	number	Number of items
`productId`	string	The Customily template ID
`previewUrl`	string	CDN URL of the personalized preview image
`productionUrl`	string	Production file URL (available after calling item/generate)
`optionsJson`	string	JSON string with the shopper's selections
`exportedFiles`	array	Array of production file URLs (one per template side)
`createdDate`	string	When the cart record was created
`generated`	boolean	Whether the production file has been generated

By Order ID

If you stored your platform's orderId when creating the cart record, you can retrieve all personalization items associated with that order.

GET https://sh.customily.com/api/standalone/item?orderId={orderId}
Authorization: Bearer <JWT_TOKEN>

Example request:

curl -X GET "https://sh.customily.com/api/standalone/item?orderId=12345" \
  -H "Authorization: Bearer eyJhbGciOi..."

Response: An array of personalization items in the same format as the response above.

Authentication

All endpoints in this article require a JWT token in the Authorization header. To obtain a JWT token, see the Authentication endpoint in the Swagger documentation.