Skip to Content

GET /api/v1/cart

Get the authenticated user’s cart items, enriched with full ENS name data (listings, votes, watchers, offers). Optionally filter by cart type.

Authentication: Required

Cache: None

Query Parameters

ParameterTypeDefaultDescription
typestringFilter by cart type name (e.g. buy, register)

Sample Request

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.grails.app/api/v1/cart?type=buy"

Response

// 200 OK { "success": true, "data": { "items": [ { // Cart-specific fields "cartItemId": 1, "cartType": "buy", "addedAt": "2026-04-07T12:00:00.000Z", // Enriched ENS name fields (from buildSearchResults) "id": 42, "name": "example.eth", "token_id": "12345...", "owner": "0xabcd...", "expiry_date": "2027-04-07T00:00:00.000Z", "registration_date": "2022-01-15T00:00:00.000Z", "creation_date": "2022-01-15T00:00:00.000Z", "last_sale_date": "2025-06-01T00:00:00.000Z", "metadata": { "avatar": "https://...", "url": "https://..." }, "metadata_updated_at": "2026-04-01T00:00:00.000Z", "clubs": ["999"], "club_ranks": [{ "club": "999", "rank": 5 }], "has_numbers": true, "has_emoji": false, "last_sale_price": "50000000000000000", "last_sale_currency": "ETH", "last_sale_price_usd": 125.50, "listings": [], "upvotes": 10, "downvotes": 2, "net_score": 8, "user_vote": 1, "watchers_count": 5, "is_user_watching": true, "watchlist_record_id": 77, "highest_offer_wei": "50000000000000000", "highest_offer_currency": "WETH", "highest_offer_id": 12, "view_count": 230 } ] }, "meta": { "timestamp": "2026-04-08T00:00:00.000Z", "version": "1.0.0" } }

Error Responses

StatusCodeDescription
400VALIDATION_ERRORInvalid query parameters
401UNAUTHORIZEDMissing or invalid token
500INTERNAL_ERRORFailed to fetch cart
Last updated on