Skip to main content
POST
/
api
/
v1
/
subscribers
/
{id}
/
unblock
curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123/unblock" \
  -H "Authorization: Bearer olive_live_xxx"

{
  "success": true,
  "message": "Subscriber unblocked successfully",
  "unblocked_at": "2025-01-20T15:30:00Z",
  "unblocked_by": "admin@olive.sl"
}
Unblocking restores full access to the subscriber’s account and all linked cards.

​
Request

​
Authorization
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

​
Path Parameters

​
id
string
required
Subscriber UUID (e.g., sub_abc123)

​
Response

​
success
boolean
Whether unblock succeeded
​
message
string
Result message

​
Examples

curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123/unblock" \
  -H "Authorization: Bearer olive_live_xxx"

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

​
What Gets Restored

1

Account Activated

Subscriber status changes to ACTIVE
2

Cards Unblocked

All linked cards become active again
3

Transactions Enabled

All transaction types are enabled
4

PIN Attempts Reset

Failed PIN attempt counter is reset to 0

​
Permissions

Only users with system_admin or compliance_user roles can unblock subscribers.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENInsufficient permissions
404NOT_FOUNDSubscriber not found
409NOT_BLOCKEDSubscriber is not blocked
500INTERNAL_ERRORServer error

Block Subscriber

Block a subscriber account with a reason