Register

Create a new client account to start using the Daakey car sharing platform. Registration is the first step for new users who want to book vehicles through a specific agency's mobile app.

The registration process creates an account tied to a specific agency (determined by the X-Agency-Signature header). After registration, users must verify their email and phone number before gaining full access to all features. While some basic functionality is available immediately, booking vehicles typically requires verified contact information and uploaded driver documents.

Upon successful registration, the API returns an access token so the user can immediately start using the app without requiring a separate login step.

Complete Your Profile

After registering, you should:

1. Verify your email via the link sent to your inbox
2. Verify your phone number via SMS code
3. Upload required documents (driver's license)
4. Add a payment method

This ensures you can book vehicles without delays.

Endpoint

INFO

POST /api/v1/client/auth/register

Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
X-Agency-Signature	{signature}	Yes

Request Body

Parameter	Type	Required	Description
name	string	Yes	Full name (min: 2 chars)
email	string	Yes	Valid email address
phone	string	Yes	Phone number with country code
password	string	Yes	Password (min: 8 chars)
password_confirmation	string	Yes	Password confirmation

Example Request

curl -X POST https://api.daakey.com/api/v1/client/auth/register \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Agency-Signature: {signature}" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "password": "securePassword123",
    "password_confirmation": "securePassword123"
  }'

Response

Success (201)

{
  "success": true,
  "message": "Registration successful",
  "data": {
    "user": {
      "id": 1,
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "+1234567890",
      "phone_verified_at": null,
      "email_verified_at": null,
      "created_at": "2024-01-01T00:00:00Z"
    },
    "token": "1|abc123def456..."
  },
  "meta": {
    "agency_id": 123,
    "agency_code": "AGENCY123"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (422) - Validation

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "email": ["The email has already been taken."],
    "password": ["The password must be at least 8 characters."]
  },
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Notes

• A verification email will be sent after successful registration
• A verification SMS will be sent to the phone number
• The user can use the app immediately but some features may require verification