Unblock Subscriber

POST/subscribers/{id}/unblockOpen in the API playground →

Info

Unblocking restores full access to the subscriber's account and all linked cards.

Request

Authorizationstringheaderrequired

Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

idstringpathrequired

Subscriber UUID (e.g., sub_abc123)

---

Response

successboolean

Whether unblock succeeded

messagestring

Result message

---

Examples

Request

cURL

curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/unblock" \
  -H "Authorization: Bearer olive_live_xxx"

Response

200 OK

{
  "success": true,
  "message": "Subscriber unblocked successfully",
  "unblocked_at": "2025-01-20T15:30:00Z",
  "unblocked_by": "admin@smartpay.sl"
}

404 Not Found

{
  "error": "Subscriber not found",
  "code": "NOT_FOUND"
}

409 Conflict

{
  "error": "Subscriber is not blocked",
  "code": "NOT_BLOCKED"
}

---

What Gets Restored

Account Activated

Subscriber status changes to ACTIVE

Cards Unblocked

All linked cards become active again

Transactions Enabled

All transaction types are enabled

PIN Attempts Reset

Failed PIN attempt counter is reset to 0

---

Permissions

Warning

Only users with system_admin or compliance_user roles can unblock subscribers.

---

Errors

Status	Code	Description
401	UNAUTHORIZED	Invalid or missing API key
403	FORBIDDEN	Insufficient permissions
404	NOT_FOUND	Subscriber not found
409	NOT_BLOCKED	Subscriber is not blocked
500	INTERNAL_ERROR	Server error

---

Related

Block Subscriber

Block a subscriber account with a reason