instructor

Overview

Searches instructors (professionals) in the RAID network. Returns public profile data including professional status, certifications earned as a diver, certifications issued as an instructor, and total dive experience.

Authentication

Type: API Key
Header: token: {your-api-key}

Request

Method: POST
Path: /api/v1/instructor
Content-Type: application/json or application/x-www-form-urlencoded

Body parameters

Parameter	Type	Required	Description
`search`	`string`	No	Free text - searches across: `first_name`, `last_name`, `full_name`, `city`, `email`, `raid_id` (LIKE `%search%`)
`country`	`string`	No	ISO 3166-1 alpha-2 country code (e.g. `IT`, `ES`, `US`) to filter by country

Both parameters are optional. If neither is provided, all instructors are returned.

Response `200 OK` - Results found

{
  "data": [
    {
      "raid_id": "RAID-IT-12345",
      "first_name": "Marco",
      "last_name": "Rossi",
      "age": 38,
      "avatar": "https://s3.amazonaws.com/diveraid/avatars/45.jpg",
      "email": "marco.rossi@example.com",
      "country": "Italy",
      "city": "Rome",
      "mobile": "+39 333 1234567",
      "expire_date": "15/04/2025",
      "pro_certifications": [
        "Open Water Instructor",
        "Advanced Instructor"
      ],
      "diver_certifications": [
        "Open Water Diver",
        "Advanced Open Water",
        "Rescue Diver"
      ],
      "certifications_issued": 142,
      "experience": "320 hours",
      "professional_status": "ACTIVE"
    }
  ],
  "success": true,
  "message": "success",
  "total": 1
}

Response `200 OK` - No results

{
  "data": [],
  "success": true,
  "message": "no results",
  "total": 0
}

`data[]` fields

Field	Type	Description
`raid_id`	`string`	Instructor's unique RAID identifier
`first_name`	`string`	First name
`last_name`	`string`	Last name
`age`	`integer\|null`	Age calculated from date of birth (`null` if not available)
`avatar`	`string\|null`	Profile photo URL
`email`	`string`	Instructor's email address
`country`	`string`	Full country name (e.g. `"Italy"`, not ISO code)
`city`	`string\|null`	City
`mobile`	`string\|null`	Phone number
`expire_date`	`string`	Professional qualification expiry date (locale format, e.g. `15/04/2025`)
`pro_certifications`	`array`	Instructor's RAID professional qualifications, sorted by name
`diver_certifications`	`array`	RAID certifications earned as a diver, sorted by name
`certifications_issued`	`integer`	Total certifications issued as instructor
`experience`	`string`	Total dive experience (formatted time string)
`professional_status`	`string`	Professional status (see values below)

`professional_status` values

Value	Description
`ACTIVE`	Professional qualification active and not expired
`EXPIRED`	Qualification expired - not currently operational
`EMERITUS`	Emeritus status - honorary qualification
Others	Special statuses such as `SUSPENDED`, `EXPELLED`, etc.

Response `401` - Missing or invalid API Key

{
  "error": "Access Denied!",
  "message": "No API Key provided.",
  "statusCode": 401
}

Search examples

Search by name:

{ "search": "Marco" }

Filter by country:

{ "country": "IT" }

Combined search:

{ "search": "Rossi", "country": "IT" }

Notes

Search is case-insensitive using LIKE %search% - substring matching included.

Results are ordered by full_name ASC.

The country field in the response is the full country name, not the ISO code.

Instructors with expelled status may appear with a professional_status value different from ACTIVE or EXPIRED.

Responses

🟢200

application/json

Search results

Bodyapplication/json

Example

{
    "success": true,
    "message": "string",
    "total": 0,
    "data": [
        {
            "raid_id": "string",
            "first_name": "string",
            "last_name": "string",
            "age": 0,
            "avatar": "string",
            "email": "string",
            "country": "string",
            "city": "string",
            "mobile": "string",
            "expire_date": "2019-08-24",
            "pro_certifications": [
                "string"
            ],
            "diver_certifications": [
                "string"
            ],
            "certifications_issued": 0,
            "experience": "string",
            "professional_status": "string"
        }
    ]
}

🟠401

Search instructors

POST /api/v1/instructor

Overview

Authentication

Request

Body parameters

Response `200 OK` - Results found

Response `200 OK` - No results

`data[]` fields

`professional_status` values

Response `401` - Missing or invalid API Key

Search examples

Notes

Request

Request Code Samples

Responses

Search instructors

POST /api/v1/instructor#

Overview#

Authentication#

Request#

Body parameters#

Response 200 OK - Results found#

Response 200 OK - No results#

data[] fields#

professional_status values#

Response 401 - Missing or invalid API Key#

Search examples#

Notes#

Request

Request Code Samples

Responses

POST /api/v1/instructor

Overview

Authentication

Request

Body parameters

Response `200 OK` - Results found

Response `200 OK` - No results

`data[]` fields

`professional_status` values

Response `401` - Missing or invalid API Key

Search examples

Notes