/1/transfer/request

Headers

Key	Value	Description
Authorization (Required)	Bearer <token>	Your reseller API token
Content-Type (Required)	application/json	Request content type

Key

Value

Description

Authorization

(Required)

Bearer <token>

Your reseller API token

Content-Type

(Required)

application/json

Request content type

Request Body

Field	Type	Description
email (Required)	string	Email address of the existing VBMapp user to transfer

Field

Type

Description

(Required)

string

Email address of the existing VBMapp user to transfer

Code Example

curl -X POST "https://api.vbmappapp.com/1/transfer/request" \
    -H "Authorization: Bearer YOUR_RESELLER_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
        "email": "[email protected]"
    }'

Success Response (200)

{
    "success": true,
    "message": "Transfer request sent to [email protected]",
    "expires_at": "2025-08-15T17:44:07+00:00"
}

Error Responses

User Not Found (404)

{
    "success": false,
    "error": "User not found with this email address"
}

User Already Managed (422)

{
    "success": false,
    "error": "User is already managed by another reseller"
}

Pending Request Exists (422)

{
    "success": false,
    "error": "A transfer request is already pending for this user",
    "expires_at": "2025-08-15T17:44:07+00:00"
}

Rate Limit Exceeded (429)

{
    "success": false,
    "error": "Too many transfer requests for this email. Please try again later."
}

Email Send Failure (500)

{
    "success": false,
    "error": "Failed to send transfer request email. Please contact support to resolve this issue."
}

Notes

Maximum 3 transfer requests per email address per 24 hours
Transfer request expires after 1 hour
User must be sole administrator of their organizations to complete transfer
User receives email with 6-digit verification code and secure link