curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/unblock" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234"
}'
{
"success": true,
"message": "Card unblocked successfully",
"card": {
"serial": "OLIV0001",
"status": "ACTIVE",
"unblocked_at": "2025-01-20T15:30:00Z",
"unblocked_by": "admin@olive.sl"
}
}
{
"error": "Card is not blocked",
"code": "NOT_BLOCKED"
}
Cards
Unblock Card
Restore a blocked NFC card
POST
/
cards
/
{serial}
/
unblock
curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/unblock" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234"
}'
{
"success": true,
"message": "Card unblocked successfully",
"card": {
"serial": "OLIV0001",
"status": "ACTIVE",
"unblocked_at": "2025-01-20T15:30:00Z",
"unblocked_by": "admin@olive.sl"
}
}
{
"error": "Card is not blocked",
"code": "NOT_BLOCKED"
}
Unblocking restores full transaction capability to a previously blocked card.
Request
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)Path Parameters
string
required
Card serial number (e.g.,
OLIV0001)Body Parameters
string
Subscriber’s PIN (required for self-service unblock)
Response
boolean
Whether unblock succeeded
string
Result message
Examples
curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/unblock" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234"
}'
{
"success": true,
"message": "Card unblocked successfully",
"card": {
"serial": "OLIV0001",
"status": "ACTIVE",
"unblocked_at": "2025-01-20T15:30:00Z",
"unblocked_by": "admin@olive.sl"
}
}
{
"error": "Card is not blocked",
"code": "NOT_BLOCKED"
}
What Gets Restored
1
Status Updated
Card status changes from BLOCKED to ACTIVE
2
Transactions Enabled
POS payments and NFC tap work again
3
PIN Active
Original PIN remains unchanged
Restrictions
Cards blocked as “Lost” or “Stolen” cannot be unblocked. Issue a new card instead.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PIN | PIN verification failed |
| 400 | PERMANENT_BLOCK | Card cannot be unblocked (lost/stolen) |
| 401 | UNAUTHORIZED | Invalid API key |
| 404 | CARD_NOT_FOUND | Card serial not found |
| 409 | NOT_BLOCKED | Card is not blocked |
| 500 | INTERNAL_ERROR | Server error |
Related
Block Card
Block a card from transactions
Authorizations
ApiKeyAuthBearerAuth
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Path Parameters
Card Serial Number
Body
application/json
PIN for non-admin users
Example:
"1234"
Response
Card unblocked
The response is of type object.
⌘I