GET /api/v1/users/:address/badges
Returns POAP badges for the given address, querying all configured POAP collections in parallel.
Authentication: None
Cache: None
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Ethereum address (0x + 40 hex chars) |
Sample Request
curl https://api.grails.app/api/v1/users/0x1234.../badgesResponse
// 200 OK
{
"success": true,
"data": {
"address": "0x1234567890abcdef1234567890abcdef12345678",
"badges": [
{
"event": { "id": 12345, "name": "Grails Early Adopter", ... },
"tokenId": "6789",
"owner": "0x1234...",
"created": "2025-06-15T00:00:00.000Z"
}
]
},
"meta": {
"timestamp": "2026-04-07T12:00:00.000Z",
"version": "1.0.0"
}
}Error Responses
| Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Invalid address format |
| 500 | INTERNAL_ERROR | Failed to fetch badges |
| 503 | SERVICE_UNAVAILABLE | POAP API key not configured |
Last updated on