register

Overview

Registers a new diver account. Automatically assigns the diver role, derives the distributor from the country, generates the RAID ID, and sets unit preferences based on location. Rate-limited to prevent abuse.

Authentication

None - public endpoint.

Request

Method: POST
Path: /api/v1/auth/register

Body `application/json`

{
    "email": "user@diveraid.com",
    "password": "Pa$$word123",
    "password_confirmation": "Pa$$word123",
    "first_name": "User",
    "last_name": "RaidTest",
    "dob": "2001-08-24",
    "country": "gb",
    "timezone": "Europe/London",
    "dive_center": null,
    "state_select": "LND@London, City of",
    "terms": true
}

Body fields

Field	Type	Required	Description
`first_name`	`string`	Yes	Min 1, max 100 characters
`last_name`	`string`	Yes	Min 1, max 100 characters
`email`	`string`	Yes	Valid RFC email - must be unique across users, dive centers, and distributors
`password`	`string`	Yes	Must meet strength requirements (see Notes)
`password_confirmation`	`string`	Yes	Must match `password`
`dob`	`date`	Yes	Date of birth (YYYY-MM-DD) - must be at least `minAgeRegistration` years before today
`country`	`string`	Yes	ISO 3166-1 alpha-2 country code
`state_select`	`string`	Conditional	Required when country has subdivisions. Format: `{code}@{name}` (e.g. `RM@Rome`)
`timezone`	`string`	Yes	Valid IANA timezone identifier (e.g. `Europe/Rome`)
`terms`	`boolean`	Yes	Must be `true` - acceptance of terms and conditions
`dive_center`	`integer`	No	Optional dive center ID to associate at registration

Response `201 Created`

{
  "status": "success",
  "message": "User successfully registered",
  "data": {
    "raid_id": "GB26-384-698",
        "email": "user@diveraid.com",
        "qrcode": "<svg></svg>",
        "qualification": "Diver",
        "qualification_cast": "Recreational",
        "category": "Recreational",
        "first_name": "User",
        "last_name": "RaidTest",
        "full_name": "User RaidTest",
        "nationality": "GB",
        "country": "GB",
        ...
  }
}

Response `422 Unprocessable Entity`

{
  "status": "unprocessable",
  "message": "The email has already been taken.",
  "errors": {
    "email": ["The email has already been taken."]
  }
}

Notes

Password strength is configurable per deployment (min length, letters, mixed case, numbers, symbols, uncompromised check).

distributor_id is automatically determined from the country via DistributorCountry table. Defaults to distributor 40 if no mapping found.

If dive_center is provided and valid, the user is immediately associated with that dive center and its distributor.

Names are automatically title-cased (ucname()).

raid_id is generated server-side based on country and date of birth.

default_language is set from the current app locale.

GDPR and terms timestamps are set automatically at registration time.

Request

Body Params application/jsonRequired

Example

{
    "email": "user@example.com",
    "password": "pa$$word",
    "password_confirmation": "pa$$word",
    "first_name": "string",
    "last_name": "string",
    "dob": "2019-08-24",
    "country": "st",
    "timezone": "string",
    "terms": true,
    "dive_center": 0,
    "state_select": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Registration Completed

application/json

### User registered

Bodyapplication/json

Examples

RegistrationRegistration with Dive Center

{
    "status": "success",
    "message": "User successfully registered",
    "data": {
        "raid_id": "GB26-295-995",
        "email": "user@diveraid.com",
        "qrcode": "<svg xmlns=\"http://www.w3.org/2000/svg\" version=\"1.1\" width=\"144\" height=\"144\" viewBox=\"0 0 144 144\"><rect x=\"0\" y=\"0\" width=\"144\" height=\"144\" fill=\"#ffffff\"/><g transform=\"scale(3.2)\"><g transform=\"translate(0,0)\"><path fill-rule=\"evenodd\" d=\"M9 0L9 1L8 1L8 2L9 2L9 3L8 3L8 4L9 4L9 5L8 5L8 7L9 7L9 8L6 8L6 9L5 9L5 8L0 8L0 10L1 10L1 11L0 11L0 13L1 13L1 11L7 11L7 10L6 10L6 9L9 9L9 12L8 12L8 13L9 13L9 15L10 15L10 18L12 18L12 17L15 17L15 18L13 18L13 22L15 22L15 23L16 23L16 21L19 21L19 22L17 22L17 23L19 23L19 22L20 22L20 24L18 24L18 25L17 25L17 24L16 24L16 25L15 25L15 26L16 26L16 25L17 25L17 26L18 26L18 27L17 27L17 28L16 28L16 29L14 29L14 28L15 28L15 27L13 27L13 29L12 29L12 27L11 27L11 29L10 29L10 28L9 28L9 26L12 26L12 25L13 25L13 26L14 26L14 25L13 25L13 24L14 24L14 23L13 23L13 24L12 24L12 23L10 23L10 21L11 21L11 22L12 22L12 19L10 19L10 20L9 20L9 16L8 16L8 17L7 17L7 16L6 16L6 17L7 17L7 18L5 18L5 15L8 15L8 14L6 14L6 13L7 13L7 12L6 12L6 13L5 13L5 15L4 15L4 12L3 12L3 14L1 14L1 15L0 15L0 16L1 16L1 15L2 15L2 17L3 17L3 16L4 16L4 18L2 18L2 19L3 19L3 20L1 20L1 22L3 22L3 20L4 20L4 25L3 25L3 24L2 24L2 23L1 23L1 24L2 24L2 25L1 25L1 26L0 26L0 27L1 27L1 29L0 29L0 33L4 33L4 32L5 32L5 34L4 34L4 35L1 35L1 36L0 36L0 37L1 37L1 36L3 36L3 37L5 37L5 34L6 34L6 35L7 35L7 36L6 36L6 37L7 37L7 36L8 36L8 35L10 35L10 34L11 34L11 35L12 35L12 36L13 36L13 37L11 37L11 36L9 36L9 37L8 37L8 39L9 39L9 40L8 40L8 45L9 45L9 44L10 44L10 45L11 45L11 44L12 44L12 43L11 43L11 42L12 42L12 41L13 41L13 45L14 45L14 44L16 44L16 45L17 45L17 44L18 44L18 45L19 45L19 44L21 44L21 43L20 43L20 42L19 42L19 43L17 43L17 42L16 42L16 41L19 41L19 40L20 40L20 41L21 41L21 42L22 42L22 44L24 44L24 45L27 45L27 44L29 44L29 45L30 45L30 44L31 44L31 45L32 45L32 44L34 44L34 45L37 45L37 44L38 44L38 45L39 45L39 44L38 44L38 42L33 42L33 43L32 43L32 40L33 40L33 41L39 41L39 42L41 42L41 39L42 39L42 40L43 40L43 41L42 41L42 42L44 42L44 43L45 43L45 42L44 42L44 40L43 40L43 39L44 39L44 38L45 38L45 37L43 37L43 39L42 39L42 36L44 36L44 34L45 34L45 33L44 33L44 30L45 30L45 28L44 28L44 29L43 29L43 31L42 31L42 32L43 32L43 33L44 33L44 34L42 34L42 36L39 36L39 35L41 35L41 34L39 34L39 35L37 35L37 34L38 34L38 33L37 33L37 31L38 31L38 32L39 32L39 33L41 33L41 32L39 32L39 31L40 31L40 30L39 30L39 29L42 29L42 28L43 28L43 27L44 27L44 26L45 26L45 25L42 25L42 24L43 24L43 23L44 23L44 24L45 24L45 23L44 23L44 22L45 22L45 21L44 21L44 20L43 20L43 19L44 19L44 18L45 18L45 17L44 17L44 15L43 15L43 14L45 14L45 13L44 13L44 12L43 12L43 11L44 11L44 10L45 10L45 9L44 9L44 8L43 8L43 10L42 10L42 8L41 8L41 9L40 9L40 8L39 8L39 10L38 10L38 8L37 8L37 6L36 6L36 7L35 7L35 6L34 6L34 7L35 7L35 8L37 8L37 9L35 9L35 10L34 10L34 11L35 11L35 12L37 12L37 10L38 10L38 11L39 11L39 12L38 12L38 13L35 13L35 14L34 14L34 12L33 12L33 10L32 10L32 9L30 9L30 8L31 8L31 6L32 6L32 8L33 8L33 6L32 6L32 5L33 5L33 4L34 4L34 5L37 5L37 3L36 3L36 1L37 1L37 0L36 0L36 1L35 1L35 4L34 4L34 0L33 0L33 1L32 1L32 0L27 0L27 1L26 1L26 0L25 0L25 1L24 1L24 0L23 0L23 1L24 1L24 3L20 3L20 2L22 2L22 0L21 0L21 1L20 1L20 0L19 0L19 1L20 1L20 2L18 2L18 1L17 1L17 0L16 0L16 1L15 1L15 2L16 2L16 4L14 4L14 3L13 3L13 0L12 0L12 1L11 1L11 0ZM9 1L9 2L10 2L10 3L9 3L9 4L10 4L10 3L11 3L11 1ZM25 1L25 5L27 5L27 7L26 7L26 6L25 6L25 7L26 7L26 8L25 8L25 9L24 9L24 10L23 10L23 9L20 9L20 3L19 3L19 4L18 4L18 3L17 3L17 4L16 4L16 5L17 5L17 4L18 4L18 5L19 5L19 9L18 9L18 8L17 8L17 7L18 7L18 6L17 6L17 7L16 7L16 6L15 6L15 5L14 5L14 4L13 4L13 3L12 3L12 4L11 4L11 5L10 5L10 6L9 6L9 7L10 7L10 6L11 6L11 8L9 8L9 9L11 9L11 10L10 10L10 11L11 11L11 10L12 10L12 6L13 6L13 7L14 7L14 8L13 8L13 9L14 9L14 11L12 11L12 12L11 12L11 13L12 13L12 16L14 16L14 15L13 15L13 13L16 13L16 15L17 15L17 16L19 16L19 17L16 17L16 16L15 16L15 17L16 17L16 19L15 19L15 20L14 20L14 21L16 21L16 20L17 20L17 18L19 18L19 17L20 17L20 18L22 18L22 19L19 19L19 20L23 20L23 18L25 18L25 19L24 19L24 20L26 20L26 21L25 21L25 22L27 22L27 24L26 24L26 25L25 25L25 26L24 26L24 25L23 25L23 26L21 26L21 25L20 25L20 26L19 26L19 25L18 25L18 26L19 26L19 27L18 27L18 28L19 28L19 29L16 29L16 30L15 30L15 31L16 31L16 32L17 32L17 31L16 31L16 30L19 30L19 31L18 31L18 32L19 32L19 33L13 33L13 35L14 35L14 37L13 37L13 38L10 38L10 37L9 37L9 39L12 39L12 40L11 40L11 41L10 41L10 42L11 42L11 41L12 41L12 40L13 40L13 41L14 41L14 43L16 43L16 44L17 44L17 43L16 43L16 42L15 42L15 41L16 41L16 40L18 40L18 39L16 39L16 38L17 38L17 37L18 37L18 38L20 38L20 37L18 37L18 36L24 36L24 35L25 35L25 34L27 34L27 33L25 33L25 32L22 32L22 33L25 33L25 34L24 34L24 35L23 35L23 34L21 34L21 33L20 33L20 30L19 30L19 29L21 29L21 30L22 30L22 31L25 31L25 30L28 30L28 31L26 31L26 32L28 32L28 33L29 33L29 34L28 34L28 35L26 35L26 36L28 36L28 37L25 37L25 38L28 38L28 39L30 39L30 41L31 41L31 39L33 39L33 40L36 40L36 38L35 38L35 37L36 37L36 36L37 36L37 35L36 35L36 34L37 34L37 33L36 33L36 32L35 32L35 33L34 33L34 30L35 30L35 31L37 31L37 30L38 30L38 31L39 31L39 30L38 30L38 29L39 29L39 28L42 28L42 27L39 27L39 25L38 25L38 27L37 27L37 29L36 29L36 28L35 28L35 27L36 27L36 26L37 26L37 25L36 25L36 22L35 22L35 19L36 19L36 20L37 20L37 18L35 18L35 17L34 17L34 16L35 16L35 15L36 15L36 14L35 14L35 15L34 15L34 14L33 14L33 12L31 12L31 13L32 13L32 14L30 14L30 11L32 11L32 10L27 10L27 9L29 9L29 8L30 8L30 6L31 6L31 5L30 5L30 4L31 4L31 3L32 3L32 4L33 4L33 3L32 3L32 2L31 2L31 1L28 1L28 2L27 2L27 3L26 3L26 1ZM28 2L28 3L27 3L27 5L28 5L28 3L29 3L29 4L30 4L30 3L31 3L31 2L30 2L30 3L29 3L29 2ZM12 4L12 5L11 5L11 6L12 6L12 5L13 5L13 4ZM21 5L21 8L24 8L24 5ZM29 5L29 6L28 6L28 7L27 7L27 8L29 8L29 6L30 6L30 5ZM14 6L14 7L15 7L15 10L16 10L16 11L17 11L17 12L16 12L16 13L17 13L17 14L18 14L18 15L21 15L21 16L20 16L20 17L21 17L21 16L22 16L22 17L24 17L24 16L25 16L25 15L27 15L27 16L26 16L26 17L27 17L27 18L26 18L26 20L29 20L29 19L30 19L30 22L29 22L29 21L27 21L27 22L29 22L29 23L28 23L28 24L27 24L27 26L25 26L25 27L24 27L24 28L23 28L23 27L21 27L21 29L22 29L22 30L23 30L23 29L24 29L24 30L25 30L25 29L26 29L26 28L27 28L27 29L28 29L28 30L31 30L31 28L34 28L34 29L33 29L33 30L34 30L34 29L35 29L35 28L34 28L34 27L35 27L35 26L36 26L36 25L35 25L35 26L34 26L34 24L33 24L33 23L32 23L32 20L34 20L34 19L35 19L35 18L34 18L34 19L32 19L32 18L33 18L33 17L32 17L32 16L34 16L34 15L30 15L30 14L29 14L29 13L28 13L28 12L29 12L29 11L28 11L28 12L27 12L27 14L24 14L24 13L26 13L26 12L22 12L22 11L23 11L23 10L20 10L20 9L19 9L19 10L18 10L18 9L17 9L17 10L16 10L16 7L15 7L15 6ZM22 6L22 7L23 7L23 6ZM2 9L2 10L4 10L4 9ZM17 10L17 11L18 11L18 10ZM24 10L24 11L27 11L27 10ZM35 10L35 11L36 11L36 10ZM39 10L39 11L41 11L41 12L39 12L39 13L38 13L38 14L37 14L37 15L38 15L38 18L41 18L41 20L42 20L42 21L41 21L41 22L42 22L42 23L41 23L41 24L42 24L42 23L43 23L43 22L44 22L44 21L43 21L43 20L42 20L42 19L43 19L43 18L41 18L41 16L40 16L40 15L38 15L38 14L41 14L41 15L42 15L42 13L43 13L43 12L42 12L42 11L41 11L41 10ZM14 11L14 12L15 12L15 11ZM19 11L19 13L18 13L18 12L17 12L17 13L18 13L18 14L19 14L19 13L20 13L20 14L23 14L23 15L22 15L22 16L23 16L23 15L24 15L24 14L23 14L23 13L22 13L22 12L21 12L21 11ZM9 12L9 13L10 13L10 12ZM12 12L12 13L13 13L13 12ZM41 12L41 13L42 13L42 12ZM10 14L10 15L11 15L11 14ZM27 14L27 15L29 15L29 16L27 16L27 17L29 17L29 16L30 16L30 15L29 15L29 14ZM36 16L36 17L37 17L37 16ZM42 16L42 17L43 17L43 16ZM31 17L31 18L30 18L30 19L31 19L31 20L32 20L32 19L31 19L31 18L32 18L32 17ZM0 18L0 19L1 19L1 18ZM28 18L28 19L29 19L29 18ZM4 19L4 20L7 20L7 19ZM38 19L38 20L40 20L40 19ZM5 21L5 24L8 24L8 21ZM21 21L21 24L24 24L24 21ZM33 21L33 22L34 22L34 23L35 23L35 22L34 22L34 21ZM37 21L37 24L40 24L40 21ZM42 21L42 22L43 22L43 21ZM6 22L6 23L7 23L7 22ZM22 22L22 23L23 23L23 22ZM30 22L30 23L29 23L29 24L28 24L28 25L31 25L31 24L32 24L32 26L28 26L28 27L27 27L27 28L28 28L28 29L30 29L30 28L31 28L31 27L32 27L32 26L33 26L33 24L32 24L32 23L31 23L31 22ZM38 22L38 23L39 23L39 22ZM30 23L30 24L31 24L31 23ZM11 24L11 25L12 25L12 24ZM4 25L4 26L3 26L3 27L2 27L2 26L1 26L1 27L2 27L2 29L3 29L3 28L4 28L4 30L2 30L2 31L1 31L1 32L2 32L2 31L4 31L4 30L7 30L7 29L5 29L5 28L4 28L4 27L6 27L6 28L8 28L8 30L9 30L9 31L11 31L11 32L12 32L12 31L11 31L11 30L9 30L9 28L8 28L8 26L9 26L9 25L8 25L8 26L7 26L7 25ZM40 25L40 26L42 26L42 25ZM6 26L6 27L7 27L7 26ZM19 27L19 28L20 28L20 27ZM25 27L25 28L26 28L26 27ZM28 27L28 28L29 28L29 27ZM38 27L38 28L39 28L39 27ZM22 28L22 29L23 29L23 28ZM13 29L13 30L14 30L14 29ZM5 31L5 32L7 32L7 33L6 33L6 34L7 34L7 35L8 35L8 34L10 34L10 32L7 32L7 31ZM13 31L13 32L14 32L14 31ZM28 31L28 32L30 32L30 34L31 34L31 33L32 33L32 34L33 34L33 33L32 33L32 32L33 32L33 31L32 31L32 32L31 32L31 31ZM11 33L11 34L12 34L12 33ZM19 33L19 34L18 34L18 35L19 35L19 34L20 34L20 35L21 35L21 34L20 34L20 33ZM35 33L35 34L34 34L34 35L28 35L28 36L30 36L30 37L28 37L28 38L31 38L31 36L34 36L34 35L35 35L35 36L36 36L36 35L35 35L35 34L36 34L36 33ZM14 34L14 35L15 35L15 36L16 36L16 37L14 37L14 38L16 38L16 37L17 37L17 36L16 36L16 35L17 35L17 34L16 34L16 35L15 35L15 34ZM21 37L21 40L24 40L24 37ZM32 37L32 38L34 38L34 39L35 39L35 38L34 38L34 37ZM37 37L37 40L40 40L40 37ZM22 38L22 39L23 39L23 38ZM38 38L38 39L39 39L39 38ZM13 39L13 40L14 40L14 39ZM26 39L26 40L25 40L25 41L22 41L22 42L25 42L25 43L24 43L24 44L25 44L25 43L26 43L26 44L27 44L27 43L26 43L26 42L28 42L28 43L29 43L29 44L30 44L30 43L31 43L31 44L32 44L32 43L31 43L31 42L29 42L29 40L27 40L27 39ZM26 40L26 41L25 41L25 42L26 42L26 41L27 41L27 40ZM10 43L10 44L11 44L11 43ZM34 43L34 44L37 44L37 43ZM40 43L40 45L41 45L41 44L43 44L43 45L44 45L44 44L43 44L43 43ZM0 0L0 7L7 7L7 0ZM1 1L1 6L6 6L6 1ZM2 2L2 5L5 5L5 2ZM45 0L38 0L38 7L45 7ZM44 1L39 1L39 6L44 6ZM43 2L40 2L40 5L43 5ZM0 45L7 45L7 38L0 38ZM1 44L6 44L6 39L1 39ZM2 43L5 43L5 40L2 40Z\" fill=\"#000000\"/></g></g></svg>",
        "qualification": "Diver",
        "qualification_cast": "Recreational",
        "category": "Recreational",
        "first_name": "User",
        "last_name": "RaidTest",
        "full_name": "User RaidTest",
        "nationality": "GB",
        "country": "GB",
        "state": "London, City of",
        "state_code": "LND",
        "city": null,
        "address": null,
        "timezone": "Europe/London",
        "postal_code": null,
        "phone": null,
        "mobile": null,
        "gender": null,
        "dob": "2001-08-24",
        "nok_first_name": null,
        "nok_last_name": null,
        "nok_phone": null,
        "nok_email": null,
        "nok_country": null,
        "avatar": "https://diveraid.test/build/img/avatars/user.png",
        "e_card": "https://diveraid.test/build/img/avatars/user.png",
        "guardian_first_name": null,
        "guardian_last_name": null,
        "guardian_email": null,
        "guardian_accepted": false,
        "default_language": "en",
        "currency": "GBP",
        "preferred_system": "Metric",
        "vat_rate": 20,
        "gdpr": "2026-04-14",
        "terms": "2026-04-14",
        "policy_accepted_at": "2026-04-14",
        "email_verified_at": null,
        "created_at": "2026-04-14T17:07:45.000000Z",
        "updated_at": "2026-04-14T17:07:46.000000Z",
        "dive_center": "Not assigned",
        "distributor": "RAID UK",
        "distributor_id": 33,
        "distributor_date": "2026-04-14",
        "status": "Account Active"
    }
}

Register a new user

POST /api/v1/auth/register#

Overview#

Authentication#

Request#

Body application/json#

Body fields#

Response 201 Created#

Response 422 Unprocessable Entity#

Notes#

Request

Request Code Samples

Responses

POST /api/v1/auth/register

Overview

Authentication

Request

Body `application/json`

Body fields

Response `201 Created`

Response `422 Unprocessable Entity`

Notes