Skip to main content
POST
/
subscribers
/
{id}
/
block
curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/block" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Suspicious activity detected - multiple failed PIN attempts"
  }'

{
  "success": true,
  "message": "Subscriber blocked successfully",
  "blocked_at": "2025-01-20T14:45:00Z",
  "blocked_by": "admin@olive.sl"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt

Use this file to discover all available pages before exploring further.

Blocking a subscriber prevents all transactions on their account and any 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)

​
Body Parameters

​
reason
string
required
Reason for blocking the account. This is logged for audit.

​
Response

​
success
boolean
Whether block succeeded
​
message
string
Result message

​
Examples

curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/block" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Suspicious activity detected - multiple failed PIN attempts"
  }'

{
  "success": true,
  "message": "Subscriber blocked successfully",
  "blocked_at": "2025-01-20T14:45:00Z",
  "blocked_by": "admin@olive.sl"
}

​
What Gets Blocked

Account Actions

  • All wallet transactions
  • P2P transfers
  • Cash-in/cash-out
  • PIN changes

Card Actions

  • All linked cards blocked
  • POS payments rejected
  • NFC tap disabled

​
Common Reasons

Reason TypeExample
Security”Multiple failed PIN attempts”
Fraud”Suspected fraudulent activity”
KYC”KYC documents not verified”
Compliance”AML screening flag”
Request”Customer requested block”

​
Errors

StatusCodeDescription
400MISSING_REASONReason is required
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENInsufficient permissions
404NOT_FOUNDSubscriber not found
409ALREADY_BLOCKEDSubscriber already blocked
500INTERNAL_ERRORServer error

Unblock Subscriber

Restore access to a blocked subscriber account

Authorizations

​
Authorization
string
header
required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Path Parameters

​
id
string
required

Subscriber ID

Body

application/json

Block reason

​
reason
string
required
Example:

"Suspicious activity detected"

Response

Block successful

The response is of type object.