Skip to main content
POST
/
api
/
Auth
/
register
Register your company
curl --request POST \
  --url https://dev-api-partner.onecluster.co/api/Auth/register \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "companyName": "TechFin Solutions Ltd",
  "email": "cto@techfin.ng",
  "password": "SecurePass123!",
  "confirmPassword": "SecurePass123!",
  "phoneNumber": "+2348012345678",
  "ubnAccountNumber": "0123456789",
  "ndprConsent": true,
  "termsAccepted": true,
  "captchaToken": "03AGdBq24PBauq..."
}
'
{
  "success": true,
  "responseCode": "00",
  "message": "Verification email sent. Check your inbox.",
  "data": {
    "partnerId": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "email": "cto@techfin.ng",
    "ndprConsentAt": "2026-03-25T10:00:00+01:00",
    "status": "PENDING_EMAIL_VERIFICATION"
  }
}

Authorizations

​
Authorization
string
header
required

Headers

​
X-Idempotency-Key
string<uuid>
required

A unique UUID you generate. If you accidentally submit twice, this prevents creating a duplicate account.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
X-Correlation-ID
string<uuid>

Body

application/json
​
companyName
string
required

Your company's registered name (must match your CAC certificate exactly)

Example:

"TechFin Solutions Ltd"

​
email
string<email>
required

Corporate email only. Gmail, Yahoo, Hotmail and other free providers are not accepted.

Example:

"cto@techfin.ng"

​
password
string
required

Your password (minimum 8 characters)

Minimum string length: 8
​
confirmPassword
string
required

Repeat your password to confirm

​
phoneNumber
string
required

Nigerian phone number in international format

Example:

"+2348012345678"

​
ubnAccountNumber
string
required

Your existing Union Bank account number

Example:

"0123456789"

​
ndprConsent
boolean
required

Must be true. By setting this, you agree that we may process your personal data under the Nigeria Data Protection Regulation (NDPR).

​
termsAccepted
boolean
required

Must be true. Confirms you have read and accepted our Terms & Conditions.

​
captchaToken
string
required

CAPTCHA token from the registration form (prevents automated spam)

Response

Registration successful — check your email for a verification code

Standard response wrapper for all successful API calls

​
success
boolean
required

Always true for successful responses

Example:

true

​
responseCode
string
required

00 means success

Example:

"00"

​
message
string
required

Human-readable description of the result

Example:

"Request processed successfully"

​
data
object
required

The actual response data (varies by endpoint)