country

Overview

Returns the list of countries where active RAID dive centers are present. Useful for populating a country filter dropdown before performing a dive center search. Results are sorted alphabetically by country name.

Authentication

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

Request

Method: GET
Path: /api/v1/dive_center/country
Body: none
Query params: none

Response `200 OK`

{
  "AU": "Australia",
  "HR": "Croatia",
  "EG": "Egypt",
  "FR": "France",
  "DE": "Germany",
  "GR": "Greece",
  "IT": "Italy",
  "MT": "Malta",
  "MX": "Mexico",
  "ES": "Spain",
  "TH": "Thailand",
  "AE": "United Arab Emirates",
  "US": "United States"
}

Response structure

The response is a flat object (not an array) where:

Key: ISO 3166-1 alpha-2 country code (e.g. "IT")

Value: Full country name in English (e.g. "Italy")

Results are sorted alphabetically by country name (not by ISO code).

Response `401` - Missing or invalid API Key

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

Typical usage

This endpoint is called before POST /api/v1/dive_center to populate a country dropdown, so the user can filter dive centers by country without needing to know ISO codes.

1. GET /api/v1/dive_center/country   → populate "Select country" dropdown
2. POST /api/v1/dive_center          → { "country": "IT" } filters dive centers in Italy

Notes

Only includes countries with at least one active dive center (status = true).

Countries are derived directly from DiveCenter.country records - not from a separate table.

Sorted by country name (asort()), not by ISO code.

Does not include a per-country dive center count - use POST /api/v1/dive_center with a country filter for that.

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 by country

GET /api/v1/dive_center/country

Overview

Authentication

Request

Response `200 OK`

Response structure

Response `401` - Missing or invalid API Key

Typical usage

Notes

Request

Request Code Samples

Responses

Search dive centers by country

GET /api/v1/dive_center/country#

Overview#

Authentication#

Request#

Response 200 OK#

Response structure#

Response 401 - Missing or invalid API Key#

Typical usage#

Notes#

Request

Request Code Samples

Responses

GET /api/v1/dive_center/country

Overview

Authentication

Request

Response `200 OK`

Response structure

Response `401` - Missing or invalid API Key

Typical usage

Notes