Skip to main content
POST
/
v1
/
signup
curl -X POST https://api.vouchmark.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Okeke",
    "email": "ada@example.com",
    "password": "L0ng-Random-Pass!",
    "confirmPassword": "L0ng-Random-Pass!",
    "phone_no": "+2348012345678",
    "company_name": "Okeke Logistics"
  }'

{
  "success": true,
  "message": "Verification code has been sent to your email",
  "data": {
    "userId": "usr_aBcD...",
    "requiresVerification": true
  }
}
Creates a new user account and emails a verification code. No tokens are issued at this step — the account must verify its email before it can log in. Public endpoint, rate-limited to 50 requests per 15 minutes per IP.

​
Body

​
name
string
required
Account holder’s full name.
​
email
string
required
A valid, unused email address.
​
password
string
required
At least 8 characters and must contain a lowercase letter, an uppercase letter, a digit, and a special character.
​
confirmPassword
string
required
Must exactly match password.
​
phone_no
string
Optional phone number.
​
company_name
string
Optional company name.
curl -X POST https://api.vouchmark.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Okeke",
    "email": "ada@example.com",
    "password": "L0ng-Random-Pass!",
    "confirmPassword": "L0ng-Random-Pass!",
    "phone_no": "+2348012345678",
    "company_name": "Okeke Logistics"
  }'

{
  "success": true,
  "message": "Verification code has been sent to your email",
  "data": {
    "userId": "usr_aBcD...",
    "requiresVerification": true
  }
}
A six-digit verification code is sent to the supplied email. The account stays unverified until that code is confirmed, and login is blocked until then.