GET /api/v1/user/history/purchases
Names the authenticated user has purchased, ordered by most recent.
Authentication: Required
Cache: None
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 1 | Page number |
limit | number | 20 | Results per page (1-100) |
Extra Fields
| Field | Type | Description |
|---|---|---|
purchase.id | number | Sale record ID |
purchase.price_wei | string | Purchase price in wei |
purchase.currency_address | string | Payment token address |
purchase.sale_date | string | When the purchase occurred |
purchase.transaction_hash | string | On-chain transaction hash |
Sample Request
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.grails.app/api/v1/user/history/purchases?limit=10"Response
// 200 OK
{
"success": true,
"data": {
"names": [
{
// ... standard SearchResult fields (id, name, token_id, owner, etc.)
"purchase": {
"id": 99,
"price_wei": "250000000000000000",
"currency_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"sale_date": "2026-03-20T14:00:00.000Z",
"transaction_hash": "0xabc123..."
}
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 3,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
},
"meta": {
"timestamp": "2026-04-07T12:00:00.000Z",
"version": "1.0.0"
}
}Error Responses
| Status | Code | Description |
|---|---|---|
| 404 | USER_NOT_FOUND | User account not found |
Last updated on