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
| Parameter | Type | Default | Description |
|---|---|---|---|
type | string | — | Filter 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
| Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Invalid query parameters |
| 401 | UNAUTHORIZED | Missing or invalid token |
| 500 | INTERNAL_ERROR | Failed to fetch cart |
Last updated on