DKBSignDocs

API reference

POSTPublic

Register

/api/v1/register

Create an account. Password must be at least 8 characters with mixed case, a number, and a symbol. Phone must be unique and start with +. Returns 201 and the user resource. No access token is issued — the user must log in. A verification email is sent.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
first_name
Required
stringFirst name (max 255).
e.g. "Jane"
last_name
Required
stringLast name (max 255).
e.g. "Doe"
email
Required
stringUnique account email.
e.g. "jane@acme.test"
card_id_number
Required
stringNational ID card number.
e.g. "CI123456789"
phone_number
Required
stringUnique phone in E.164 (+…).
e.g. "+2250700000001"
address
Required
stringStreet address.
e.g. "12 Rue de la Paix"
city
Required
stringCity.
e.g. "Abidjan"
country
Required
stringCountry.
e.g. "Côte d'Ivoire"
password
Required
stringStrong password (min 8, mixed case, number, symbol).
e.g. "P@ssw0rd!"

Responses

StatusMeaning
201See the example response.
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v1/register' \
  -H 'Content-Type: application/json' \
  -d '{"first_name":"Jane","last_name":"Doe","email":"jane@acme.test","card_id_number":"CI123456789","phone_number":"+2250700000001","address":"12 Rue de la Paix","city":"Abidjan","country":"Côte d'Ivoire","password":"P@ssw0rd!"}'

Response 201

json
{
  "status": "success",
  "message": "Registered successfully",
  "data": {
    "id": 12,
    "email": "jane@acme.test"
  }
}