User Sessions API
A user (customer) session links a logged-in shopper to their account. Given a session token, you can retrieve the session along with the customer it belongs to. Requests are authenticated with your secret API key, sent as the HTTP Basic username with an empty password. With curl: -u {API_KEY}:. See Authentication for details.
GET /usersessions/{token}
Returns the session information along with the customer's details.
Resource URL
GET https://app.snipcart.com/api/usersessions/{token}Headers
| Name | Value | Required | Description |
|---|---|---|---|
Accept |
application/json |
Yes | The API only returns application/json. |
Path Parameters
| Name | Required | Type | Description |
|---|---|---|---|
token |
Yes | guid |
The session token, passed in the URL. |
Example request
curl -H "Accept: application/json" \
https://app.snipcart.com/api/usersessions/c83945cd-1802-4861-b1b9-4e98eed8939d \
-u {API_KEY}:Example response
{
"token": "c83945cd-1802-4861-b1b9-4e98eed8939d",
"expires": "2026-04-03T01:09:10.207Z",
"customer": {
"id": "c25f6054-3fc9-4792-b2d2-3e10eed55708",
"email": "geeks@snipcart.com",
"status": "Confirmed",
"creationDate": "2026-03-23T20:06:28.577Z",
"statistics": {
"ordersCount": 1,
"ordersAmount": 320.00
},
"billingAddressName": "Charles Ouellet",
"billingAddressCompanyName": "Snipcart",
"billingAddressAddress1": "226 rue St-Joseph Est",
"billingAddressAddress2": null,
"billingAddressCity": "Québec",
"billingAddressCountry": "CA",
"billingAddressProvince": "QC",
"billingAddressPostalCode": "G1K3A8",
"billingAddressPhone": "555 555 5555",
"shippingAddressName": "Charles Ouellet",
"shippingAddressCompanyName": "Snipcart",
"shippingAddressAddress1": "226 rue St-Joseph Est",
"shippingAddressAddress2": null,
"shippingAddressCity": "Québec",
"shippingAddressCountry": "CA",
"shippingAddressProvince": "QC",
"shippingAddressPostalCode": "G1K3A8",
"shippingAddressPhone": "555 555 5555",
"shippingAddressSameAsBilling": true,
"gravatarUrl": "https://www.gravatar.com/avatar/43c0d10549c1cafa66c416c7e7a59698?s=70&d=https%3a%2f%2fapp.snipcart.com%2fcontent%2fimages%2favatar.jpg"
}
}