Register User

curl --request POST \
  --url https://api.example.com/api/auth/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "password": "<string>",
  "full_name": "<string>",
  "phone": "<string>",
  "role": "<string>"
}
'

import requests

url = "https://api.example.com/api/auth/register"

payload = {
    "email": "<string>",
    "password": "<string>",
    "full_name": "<string>",
    "phone": "<string>",
    "role": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: '<string>',
    password: '<string>',
    full_name: '<string>',
    phone: '<string>',
    role: '<string>'
  })
};

fetch('https://api.example.com/api/auth/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/auth/register",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => '<string>',
    'password' => '<string>',
    'full_name' => '<string>',
    'phone' => '<string>',
    'role' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/auth/register"

	payload := strings.NewReader("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/auth/register")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/auth/register")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "400": {},
  "403": {},
  "409": {},
  "500": {},
  "success": true,
  "message": "<string>",
  "token": "<string>",
  "user": {
    "id": "<string>",
    "email": "<string>",
    "full_name": "<string>",
    "role": "<string>"
  }
}

POST

api

auth

curl --request POST \
  --url https://api.example.com/api/auth/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "password": "<string>",
  "full_name": "<string>",
  "phone": "<string>",
  "role": "<string>"
}
'

import requests

url = "https://api.example.com/api/auth/register"

payload = {
    "email": "<string>",
    "password": "<string>",
    "full_name": "<string>",
    "phone": "<string>",
    "role": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: '<string>',
    password: '<string>',
    full_name: '<string>',
    phone: '<string>',
    role: '<string>'
  })
};

fetch('https://api.example.com/api/auth/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/auth/register",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => '<string>',
    'password' => '<string>',
    'full_name' => '<string>',
    'phone' => '<string>',
    'role' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/auth/register"

	payload := strings.NewReader("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/auth/register")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/auth/register")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"full_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"role\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "400": {},
  "403": {},
  "409": {},
  "500": {},
  "success": true,
  "message": "<string>",
  "token": "<string>",
  "user": {
    "id": "<string>",
    "email": "<string>",
    "full_name": "<string>",
    "role": "<string>"
  }
}

Endpoint

POST /api/auth/register

Authentication

No authentication required.

Request Body

string

required

User’s email address. Must be a valid email format. Will be normalized and converted to lowercase.

string

required

User’s password. Must be at least 8 characters long.

string

required

User’s full name. Cannot be empty.

string

User’s phone number in international format (e.g., +5491112345678). Must match pattern: ^\+?[1-9][0-9]{7,14}$

string

User role. Only “seller” is allowed for public registration. Admin accounts cannot be created via this endpoint.

Response

boolean

Indicates whether the registration was successful.

string

Human-readable message describing the result.

string

JWT authentication token. Expires in 7 days by default.

object

Basic user information.

string

User’s unique identifier.

string

User’s email address.

string

User’s full name.

string

User’s role (always “seller” for public registration).

Example Request

curl -X POST https://api.horsetrust.com/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "seller@example.com",
    "password": "securePassword123",
    "full_name": "John Smith",
    "phone": "+5491112345678"
  }'

const response = await fetch('https://api.horsetrust.com/api/auth/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'seller@example.com',
    password: 'securePassword123',
    full_name: 'John Smith',
    phone: '+5491112345678'
  })
});

const data = await response.json();
console.log(data);

Example Response

201 Success

{
  "success": true,
  "message": "User registered successfully",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "507f1f77bcf86cd799439011",
    "email": "seller@example.com",
    "full_name": "John Smith",
    "role": "seller"
  }
}

Error Responses

error

Bad Request - Validation error.

{
  "success": false,
  "message": "Password must be at least 8 characters"
}

error

Forbidden - Attempted to register as admin.

{
  "success": false,
  "message": "Cannot register as admin"
}

error

Conflict - Email already registered.

{
  "success": false,
  "message": "Email already registered"
}

error

Server Error - Internal server error.

{
  "success": false,
  "message": "Server error"
}

Notes

Email addresses are automatically normalized and converted to lowercase
Passwords are securely hashed using bcrypt with 12 salt rounds
New users are created with is_email_verified: false and is_phone_verified: false
Seller profile is initialized with verification_status: "pending"
The JWT token should be stored securely and included in subsequent requests requiring authentication

⌘I

Authentication

Horses

Chat

Admin

Endpoint

Authentication

Request Body

Response

Example Request

Example Response

Error Responses

Notes

​Endpoint

​Authentication

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

​Notes

Endpoint

Authentication

Request Body

Response

Example Request

Example Response

Error Responses

Notes