RAID API
  1. Public
  • DiveRAID frontend public API
    • Search divers
      POST
    • Search instructors
      POST
    • Search dive centers
      POST
    • Search dive centers by country
      GET
  • DiveRAID rest API V1
    • Auth
      • Register a new user
      • Login and get a Sanctum token
      • Send password reset email
      • Reset password using token
      • Logout and revoke the current token
      • Resend email verification
    • Profile
      • Get authenticated user profile
      • Update profile
      • Delete account
      • Update password
      • Update dive center association
    • Diver
      • Courses
        • List active courses
        • List expired courses
        • Get course detail
        • Submit module quiz
        • Get quiz result
        • Submit course exam
        • Get exam result
        • Get skills progress
        • Sign skills (diver)
      • Free Learnings
        • List enrolled free learnings
        • List available free learning courses
        • Enroll in a free learning course
        • Get free learning detail
        • Submit free learning module quiz
        • Get free learning quiz result
      • Certifications
        • Get certification history
        • Get certification quiz result
        • Get certification exam result
        • Get certification skills
        • List diver certifications
      • Dive Logs
        • List dive logs (paginated)
        • Create dive log
        • Get dive log
        • Update dive log
      • Awards
        • List award cards
      • Documents
        • List diver documents
      • Forms
        • List diver forms
      • Medical
        • Get medical questionnaire structure
        • Submit medical questionnaire
      • Store
        • List courses available for purchase
        • Get order status
    • Professional
      • Students
        • List students
        • Get student progress
        • Get student quiz result
        • Get student exam result
        • Get student skills progress
        • Sign student skills
      • Certifications
        • List all professional certifications
        • List diver-level certifications
        • List specialty certifications
        • List professional certifications
        • List trainer certifications
        • List examiner certifications
        • Get certification history
        • Get certification quiz result
        • Get certification exam result
        • Get certification skills
      • Classroom
        • List classrooms
        • Get classroom progress (all students)
        • Get classroom student progress
        • Get classroom student quiz result
        • Get classroom student exam result
        • Get classroom student skills
        • Sign classroom student skills
      • Renewals
        • List renewal courses
        • Get renewal progress
        • Submit renewal module quiz
        • Get renewal quiz result
        • Submit renewal exam
        • Get renewal exam result
        • Get renewal skills progress
        • Sign renewal skills
      • Recognitions
        • List recognition courses
      • Dive Logs
        • List student dive logs for a course
        • Get student dive log
        • Sign student dive log
      • Store
    • Sync
      • Get sync status
      • Download full course data for offline use
      • Upload offline operations
    • Dive Center
    • Public
      • List all countries
        GET
      • Get country data
        GET
      • Get country divisions (states/provinces)
        GET
      • List time zone identifiers, optionally narrowed to one country
        GET
      • List, search, and radius-search publicly visible dive centres
        GET
      • Every publicly visible, geolocated dive centre as a map marker
        GET
      • Countries with at least one publicly visible dive centre
        GET
      • Full detail of one publicly visible dive centre
        GET
  • Schemas
    • Frontend API Schema
      • DiverSearch
    • SuccessResponse
    • ValidationErrorResponse
    • TokenResponse
    • ErrorResponse
    • UserProfile
    • CourseLog
    • CourseLogDetail
    • QuizResult
    • ExamResult
    • SkillProgress
    • DiveLog
    • Certification
    • PaginatedDiveLogs
    • StoreItem
    • PaymentIntentResponse
    • OrderConfirmResponse
    • OrderStatusResponse
    • InstructorSearch
    • DiveCenterSearch
  1. Public

Countries with at least one publicly visible dive centre

GET
https://test.diveraid.com/api/v1/public/dive-centers/countries
Public
Maintainer:Not configured

Overview#

The distinct countries that have at least one publicly visible dive centre, sorted by display label. Meant for a "browse by country" filter on top of the map or the list. New endpoint; utility had no equivalent.
Controller: App\Http\Controllers\Api\V1\Public\DiveCenterController::countries()
Route name: api.v1.public.dive-centers.countries

Authentication#

Type: None (public endpoint)
Additional middleware: throttle:public. See docs/api/README.md ยง14.

Request#

Method: GET
Path: /api/v1/public/dive-centers/countries
No parameters and no body.

Example request#


Response 200 OK#

data is an array, sorted by label. 54 entries at capture time (truncated to the first 3 below).
{
  "success": true,
  "status": "success",
  "message": "OK",
  "data": [
    { "value": "AG", "label": "Antigua and Barbuda" },
    { "value": "AR", "label": "Argentina" },
    { "value": "AU", "label": "Australia" }
  ]
}

Response fields#

FieldTypeNullableAlways presentDescription
data[].valuestringNoYesISO 3166-1 alpha-2 code. Send this as country to GET .../dive-centers
data[].labelstringNoYesEnglish country name

Errors#

429 Too Many Requests#

Behind the dedicated public limiter (300 requests per minute, keyed by IP). No errors key.
{
  "success": false,
  "status": "error",
  "message": "Too many requests"
}

Notes#

Independent of coordinate validity: a country counts here as soon as it has one publicly visible centre, whether or not that centre has usable coordinates for the map.
Applies the same DiveCenter::scopePubliclyVisible() scope every other public endpoint uses - a country whose only centres are hidden (inactive or expired over a year) does not appear.

Request

None

Responses

๐ŸŸข200
application/json
Success
Bodyapplication/json

๐ŸŸ 429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://test.diveraid.com/api/v1/public/dive-centers/countries'
Response Response Example
200 - Example 1
{
    "status": "success",
    "message": "string",
    "data": [
        {
            "value": "IT",
            "label": "Italy"
        }
    ]
}
Modified atย 2026-09-25 16:28:07
Previous
Every publicly visible, geolocated dive centre as a map marker
Next
Full detail of one publicly visible dive centre
Built with