Register a user

POSThttps://api.testingapis.com/api/validation/registerSign in to see this endpoint's URL

Rules: <list type="bullet"><item><description>username: 3-20 letters, digits or underscores; admin, root, apibee and test_user are taken</description></item><item><description>email: must be a valid address</description></item><item><description>password: 8+ characters with an uppercase letter, a lowercase letter, a digit and a special character</description></item><item><description>confirmPassword: if present, must match password</description></item><item><description>age: integer, 18-120</description></item><item><description>country: one of US, GB, IN, DE, FR, JP, CA, AU, BR</description></item><item><description>phone: optional, E.164 format</description></item><item><description>acceptTerms: must be true</description></item></list> Errors come back as RFC 7807 application/problem+json, with an errors map of field to messages. Nothing is stored, so the same payload always gets the same answer.

Request body

Optional. application/json, text/json, application/*+json, application/xml, text/xml, application/*+xml. JSON object with username, email, password, optional confirmPassword, age, country, optional phone and acceptTerms.

Example body

{
  "username": "ava_t",
  "email": "ava@example.com",
  "password": "Str0ng!Pass",
  "confirmPassword": "Str0ng!Pass",
  "age": 29,
  "country": "us",
  "phone": "+15550101",
  "acceptTerms": true
}

Responses

200: OK
201: User registered (the password is never echoed back).
400: Body is not a JSON object.
422: One or more fields failed validation.

Example

Request

curl -X POST "https://api.testingapis.com/api/validation/register" \
  -H "Content-Type: application/json" \
  -d '{"username": "ava_t", "email": "ava@example.com", "password": "Str0ng!Pass", "confirmPassword": "Str0ng!Pass", "age": 29, "country": "us", "phone": "+15550101", "acceptTerms": true}' \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response201 Created

{
  "message": "User registered successfully",
  "data": {
    "id": 1001,
    "username": "ava_t",
    "email": "ava@example.com",
    "age": 29,
    "country": "US",
    "createdAt": "2026-09-30T18:26:45Z"
  }
}

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.

Try itSign-in requiredUses your key

api.testingapis.com

curl -X POST 'https://api.testingapis.com/api/validation/register' \
  -H 'Content-Type: application/json' \
  -H 'X-TestingApis-Key: YOUR_API_KEY' \
  -d '{"username": "ava_t", "email": "ava@example.com", "password": "Str0ng!Pass", "confirmPassword": "Str0ng!Pass", "age": 29, "country": "us", "phone": "+15550101", "acceptTerms": true}'

const res = await fetch("https://api.testingapis.com/api/validation/register", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}",
});
console.log(res.status, await res.text());

// The shape of the example response in the docs.
type ApiResponse = {
  message: string;
  data: {
    id: number;
    username: string;
    email: string;
    age: number;
    country: string;
    createdAt: string;
  };
};

const res = await fetch("https://api.testingapis.com/api/validation/register", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}",
});
const body = (await res.json()) as ApiResponse;
console.log(res.status, body);

import requests

res = requests.post(
    "https://api.testingapis.com/api/validation/register",
    headers={
        "Content-Type": "application/json",
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
    data="{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}",
)
print(res.status_code, res.text)

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.testingapis.com/api/validation/register");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
request.Content = new StringContent("{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}");
request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/validation/register"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .method("POST", HttpRequest.BodyPublishers.ofString("{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}"))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

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

func main() {
	body := strings.NewReader("{\"username\": \"ava_t\", \"email\": \"ava@example.com\", \"password\": \"Str0ng!Pass\", \"confirmPassword\": \"Str0ng!Pass\", \"age\": 29, \"country\": \"us\", \"phone\": \"+15550101\", \"acceptTerms\": true}")
	req, err := http.NewRequest("POST", "https://api.testingapis.com/api/validation/register", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

POSThttps://api.testingapis.com/api/validation/register

Register a user

Request body

Responses

Example

Related