dive_center

Overview

Searches active dive centers in the RAID network. Returns public profile data including collaborators, social media links, and manager. Only active dive centers with an expiry date no older than one year are returned.

Authentication

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

Request

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

Body parameters

Parameter	Type	Required	Description
`search`	`string`	No	Free text - searches across: `name`, `city`, `email`, `raid_id`
`country`	`string`	No	ISO 3166-1 alpha-2 country code (e.g. `IT`, `ES`)

Both parameters are optional. If neither is provided, all active dive centers are returned.

Response `200 OK` - Results found

{
  "data": [
    {
      "raid_id": "RAID-DC-00123",
      "name": "Blue Ocean Dive Center",
      "email": "info@blueocean.com",
      "country": "Italy",
      "city": "Palermo",
      "mobile": "+39 091 1234567",
      "manager": "Luca Marino",
      "distributor": "RAID Italy",
      "logo": "https://s3.amazonaws.com/diveraid/logos/7.jpg",
      "collaborators": {
        "Marco Rossi": "Open Water Instructor",
        "Sara Neri": "Rescue Instructor"
      },
      "socials": {
        "facebook": "https://facebook.com/blueocean",
        "instagram": "https://instagram.com/blueocean",
        "website": "https://www.blueocean.com"
      },
      "expire_date": "15/06/2025"
    }
  ],
  "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`	Dive center's unique RAID identifier
`name`	`string`	Dive center name
`email`	`string\|null`	Contact email
`country`	`string`	Full country name (e.g. `"Italy"`)
`city`	`string\|null`	City
`mobile`	`string\|null`	Phone number
`manager`	`string`	Name of the dive center manager
`distributor`	`string`	RAID distributor name
`logo`	`string\|null`	Logo URL
`collaborators`	`object`	Map `{name: qualification}` of collaborating instructors
`socials`	`object`	Map `{platform: url}` of social media profiles (e.g. `facebook`, `instagram`, `website`)
`expire_date`	`string`	RAID membership expiry date (locale format, e.g. `15/06/2025`)

Response `401` - Missing or invalid API Key

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

Automatic filters

Dive centers are pre-filtered before applying search parameters:

status = true - active dive centers only

expire_date >= now() - 1 year - excludes dive centers expired more than one year ago

Search examples

All active dive centers (no filter):

{}

Search by name:

{ "search": "Blue Ocean" }

Filter by country:

{ "country": "IT" }

Combined search:

{ "search": "diving", "country": "ES" }

Notes

Search is case-insensitive using LIKE %search%.

Results are ordered by name ASC.

collaborators is an object (not an array) - keys are instructor names.

socials is an object - keys are the configured social platform names.

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

Responses

🟢200

application/json

Search results

Bodyapplication/json

Example

{
    "success": true,
    "message": "string",
    "total": 0,
    "data": [
        {
            "raid_id": "string",
            "name": "string",
            "email": "string",
            "country": "string",
            "city": "string",
            "mobile": "string",
            "manager": "string",
            "distributor": "string",
            "logo": "string",
            "collaborators": {
                "property1": "string",
                "property2": "string"
            },
            "socials": {
                "property1": "string",
                "property2": "string"
            },
            "expire_date": "2019-08-24"
        }
    ]
}

🟠401

Search dive centers

POST /api/v1/dive_center

Overview

Authentication

Request

Body parameters

Response `200 OK` - Results found

Response `200 OK` - No results

`data[]` fields

Response `401` - Missing or invalid API Key

Automatic filters

Search examples

Notes

Request

Request Code Samples

Responses

Search dive centers

POST /api/v1/dive_center#

Overview#

Authentication#

Request#

Body parameters#

Response 200 OK - Results found#

Response 200 OK - No results#

data[] fields#

Response 401 - Missing or invalid API Key#

Automatic filters#

Search examples#

Notes#

Request

Request Code Samples

Responses

POST /api/v1/dive_center

Overview

Authentication

Request

Body parameters

Response `200 OK` - Results found

Response `200 OK` - No results

`data[]` fields

Response `401` - Missing or invalid API Key

Automatic filters

Search examples

Notes