Search API - API Key Authentication

Overview

The Search API exposes public search endpoints for instructors, divers, and dive centers in the RAID network. It is designed for integration into third-party websites (e.g. dive center sites, distributor sites) that want to display the public RAID directory.

Base path: /api/v1/
Authentication: API Key via token header
Middleware: api_key

Authentication

All endpoints require the token header with the API key provided by RAID HQ.

token: {your-api-key}

Authentication errors

Missing token header:

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

Invalid API Key:

{
  "error": "Access Denied!",
  "message": "Invalid Api Key provided: xxx",
  "statusCode": 401
}

Available endpoints

Method	Path	Description
`POST`	`/api/v1/instructor`	Search RAID instructors
`POST`	`/api/v1/diver`	Search RAID divers
`POST`	`/api/v1/dive_center`	Search RAID dive centers
`GET`	`/api/v1/dive_center/country`	List countries with active dive centers

Diver data privacy

For divers under 16 years of age, the email and mobile fields are automatically masked (e.g. jo**@**ail.com) to protect the personal data of minors.

DiveRAID frontend public API

Search API - API Key Authentication#

Overview#

Authentication#

Authentication errors#