BODY='{"phone_number":"0771234567"}'
TIMESTAMP='2026-03-10T12:00:00Z'
SIGNATURE=$(printf 'POST\n/api/v1/partner/account-status\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //')
curl -X POST "https://demo.api.vultlocal.com/api/v1/partner/account-status" \
-H "X-API-Key-ID: $OLIVE_API_KEY_ID" \
-H "X-Partner-ID: $OLIVE_PARTNER_ID" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
-H "Content-Type: application/json" \
-d "$BODY"
{}Partner API
Account Status
Check if subscriber account exists
POST
/
partner
/
account-status
BODY='{"phone_number":"0771234567"}'
TIMESTAMP='2026-03-10T12:00:00Z'
SIGNATURE=$(printf 'POST\n/api/v1/partner/account-status\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //')
curl -X POST "https://demo.api.vultlocal.com/api/v1/partner/account-status" \
-H "X-API-Key-ID: $OLIVE_API_KEY_ID" \
-H "X-Partner-ID: $OLIVE_PARTNER_ID" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
-H "Content-Type: application/json" \
-d "$BODY"
{}Check if a subscriber account exists by phone number or card serial. Partner routes use HMAC headers, so this page provides a copyable request instead of the interactive playground.
The canonical string must match exactly, including newlines and the raw JSON body:
Authentication
string
required
API key ID issued for the partner integration
string
required
Partner identifier such as
VULTstring
required
RFC3339 timestamp used when generating the signature
string
required
Hex-encoded HMAC-SHA256 of
METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + BODYRequest Body
string
Phone number (e.g.,
0771234567)string
Card serial number (e.g.,
OLIV0001)Provide eitherphone_numberorcard_serial
Example
BODY='{"phone_number":"0771234567"}'
TIMESTAMP='2026-03-10T12:00:00Z'
SIGNATURE=$(printf 'POST\n/api/v1/partner/account-status\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //')
curl -X POST "https://demo.api.vultlocal.com/api/v1/partner/account-status" \
-H "X-API-Key-ID: $OLIVE_API_KEY_ID" \
-H "X-Partner-ID: $OLIVE_PARTNER_ID" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
-H "Content-Type: application/json" \
-d "$BODY"
Response
{
"success": true,
"exists": true,
"status": "active"
}
POST
/api/v1/partner/account-status
2026-03-10T12:00:00Z
{"phone_number":"0771234567"}
Errors
| Status | Description |
|---|---|
| 400 | Invalid request body |
| 401 | Missing or invalid HMAC headers/signature |
| 404 | User not found |
Authorizations
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Headers
Response
200 - application/json
Success
The response is of type object.
⌘I