stringstechMALDIVES
Strings App is coming soon. Pre-register your business →
← Maldives Open Data

Maldives Open Data API examples

Choose a module and open a data type to see its list and detail requests. These proposed endpoints use fictional responses. Public API access is coming soon.

Islands & atolls

Explore islands by atoll, then find places to visit and things to do.

Atolls

List records

GET /v1/atolls 
{
  "data": [
    {
      "id": "atoll-01",
      "name": "Example Atoll"
    }
  ]
}

Get one record

GET /v1/atolls/atoll-01 
{
  "data": {
    "id": "atoll-01",
    "name": "Example Atoll"
  }
}
Islands

List records

GET /v1/atolls/atoll-01/islands 
{
  "data": [
    {
      "id": "island-01",
      "name": "Example Island",
      "atollId": "atoll-01"
    }
  ]
}

Get one record

GET /v1/atolls/atoll-01/islands/island-01 
{
  "data": {
    "id": "island-01",
    "name": "Example Island",
    "atollId": "atoll-01"
  }
}
Island businesses

List records

GET /v1/islands/island-01/businesses 
{
  "data": [
    {
      "id": "business-01",
      "name": "Example Store",
      "category": "Retail"
    }
  ]
}

Get one record

GET /v1/islands/island-01/businesses/business-01 
{
  "data": {
    "id": "business-01",
    "name": "Example Store",
    "category": "Retail"
  }
}
Places

List records

GET /v1/islands/island-01/places 
{
  "data": [
    {
      "id": "place-01",
      "name": "Harbour",
      "category": "Transport"
    }
  ]
}

Get one record

GET /v1/islands/island-01/places/place-01 
{
  "data": {
    "id": "place-01",
    "name": "Harbour",
    "category": "Transport"
  }
}
Things to do

List records

GET /v1/islands/island-01/activities 
{
  "data": [
    {
      "id": "activity-01",
      "name": "Reef snorkelling",
      "category": "Water activities"
    }
  ]
}

Get one record

GET /v1/islands/island-01/activities/activity-01 
{
  "data": {
    "id": "activity-01",
    "name": "Reef snorkelling",
    "category": "Water activities"
  }
}

Business directory

Find public business profiles, categories and branches on an island.

Businesses

List records

GET /v1/businesses 
{
  "data": [
    {
      "id": "business-01",
      "name": "Example Store",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/businesses/business-01 
{
  "data": {
    "id": "business-01",
    "name": "Example Store",
    "islandId": "island-01"
  }
}
Business categories

List records

GET /v1/business-categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Retail"
    }
  ]
}

Get one record

GET /v1/business-categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Retail"
  }
}
Branches

List records

GET /v1/businesses/business-01/locations 
{
  "data": [
    {
      "id": "branch-01",
      "name": "Harbour branch",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/businesses/business-01/locations/branch-01 
{
  "data": {
    "id": "branch-01",
    "name": "Harbour branch",
    "islandId": "island-01"
  }
}

MarketPlace

Browse product categories, listings and variants from local shops.

Product categories

List records

GET /v1/market/categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Homeware"
    }
  ]
}

Get one record

GET /v1/market/categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Homeware"
  }
}
Products

List records

GET /v1/market/products 
{
  "data": [
    {
      "id": "product-01",
      "name": "Woven basket",
      "price": 150,
      "currency": "MVR"
    }
  ]
}

Get one record

GET /v1/market/products/product-01 
{
  "data": {
    "id": "product-01",
    "name": "Woven basket",
    "price": 150,
    "currency": "MVR"
  }
}
Variants

List records

GET /v1/market/products/product-01/variants 
{
  "data": [
    {
      "id": "variant-01",
      "size": "Small",
      "colour": "Natural"
    }
  ]
}

Get one record

GET /v1/market/products/product-01/variants/variant-01 
{
  "data": {
    "id": "variant-01",
    "size": "Small",
    "colour": "Natural"
  }
}

Service Providers

Find providers and the services they offer by category.

Providers

List records

GET /v1/services/providers 
{
  "data": [
    {
      "id": "provider-01",
      "name": "Example Repairs",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/services/providers/provider-01 
{
  "data": {
    "id": "provider-01",
    "name": "Example Repairs",
    "islandId": "island-01"
  }
}
Service categories

List records

GET /v1/services/categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Appliance repair"
    }
  ]
}

Get one record

GET /v1/services/categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Appliance repair"
  }
}
Service listings

List records

GET /v1/services/providers/provider-01/listings 
{
  "data": [
    {
      "id": "service-01",
      "name": "Air conditioner servicing",
      "categoryId": "category-01"
    }
  ]
}

Get one record

GET /v1/services/providers/provider-01/listings/service-01 
{
  "data": {
    "id": "service-01",
    "name": "Air conditioner servicing",
    "categoryId": "category-01"
  }
}

Jobs

Explore employers, job categories and published vacancies.

Employers

List records

GET /v1/jobs/employers 
{
  "data": [
    {
      "id": "employer-01",
      "name": "Example Guesthouse"
    }
  ]
}

Get one record

GET /v1/jobs/employers/employer-01 
{
  "data": {
    "id": "employer-01",
    "name": "Example Guesthouse"
  }
}
Job categories

List records

GET /v1/jobs/categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Hospitality"
    }
  ]
}

Get one record

GET /v1/jobs/categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Hospitality"
  }
}
Vacancies

List records

GET /v1/jobs/employers/employer-01/vacancies 
{
  "data": [
    {
      "id": "job-01",
      "title": "Guest relations assistant",
      "employmentType": "Full-time"
    }
  ]
}

Get one record

GET /v1/jobs/employers/employer-01/vacancies/job-01 
{
  "data": {
    "id": "job-01",
    "title": "Guest relations assistant",
    "employmentType": "Full-time"
  }
}

Property Rentals

Find advertised rental units by property type, island and amenities.

Property types

List records

GET /v1/rentals/types 
{
  "data": [
    {
      "id": "type-01",
      "name": "Apartment"
    }
  ]
}

Get one record

GET /v1/rentals/types/type-01 
{
  "data": {
    "id": "type-01",
    "name": "Apartment"
  }
}
Rental listings

List records

GET /v1/rentals/listings 
{
  "data": [
    {
      "id": "rental-01",
      "title": "Two-bedroom apartment",
      "bedrooms": 2,
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/rentals/listings/rental-01 
{
  "data": {
    "id": "rental-01",
    "title": "Two-bedroom apartment",
    "bedrooms": 2,
    "islandId": "island-01"
  }
}
Amenities

List records

GET /v1/rentals/listings/rental-01/amenities 
{
  "data": [
    {
      "id": "amenity-01",
      "name": "Balcony"
    }
  ]
}

Get one record

GET /v1/rentals/listings/rental-01/amenities/amenity-01 
{
  "data": {
    "id": "amenity-01",
    "name": "Balcony"
  }
}

Hotels

Explore guesthouses, room types, stay packages and activities.

Hotels & guesthouses

List records

GET /v1/hotels 
{
  "data": [
    {
      "id": "hotel-01",
      "name": "Example Guesthouse",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01 
{
  "data": {
    "id": "hotel-01",
    "name": "Example Guesthouse",
    "islandId": "island-01"
  }
}
Room types

List records

GET /v1/hotels/hotel-01/rooms 
{
  "data": [
    {
      "id": "room-01",
      "name": "Garden double",
      "guests": 2
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01/rooms/room-01 
{
  "data": {
    "id": "room-01",
    "name": "Garden double",
    "guests": 2
  }
}
Stay packages

List records

GET /v1/hotels/hotel-01/packages 
{
  "data": [
    {
      "id": "package-01",
      "name": "Island weekend",
      "nights": 2
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01/packages/package-01 
{
  "data": {
    "id": "package-01",
    "name": "Island weekend",
    "nights": 2
  }
}
Meal plans

List records

GET /v1/hotels/hotel-01/meal-plans 
{
  "data": [
    {
      "id": "meal-01",
      "name": "Breakfast included"
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01/meal-plans/meal-01 
{
  "data": {
    "id": "meal-01",
    "name": "Breakfast included"
  }
}
Transfers

List records

GET /v1/hotels/hotel-01/transfers 
{
  "data": [
    {
      "id": "transfer-01",
      "name": "Harbour pickup"
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01/transfers/transfer-01 
{
  "data": {
    "id": "transfer-01",
    "name": "Harbour pickup"
  }
}
Activities

List records

GET /v1/hotels/hotel-01/activities 
{
  "data": [
    {
      "id": "activity-01",
      "name": "Guided island walk"
    }
  ]
}

Get one record

GET /v1/hotels/hotel-01/activities/activity-01 
{
  "data": {
    "id": "activity-01",
    "name": "Guided island walk"
  }
}

Ferries

Connect operators and vessels with terminals, routes and scheduled departures.

Operators

List records

GET /v1/ferries/operators 
{
  "data": [
    {
      "id": "operator-01",
      "name": "Example Island Ferries"
    }
  ]
}

Get one record

GET /v1/ferries/operators/operator-01 
{
  "data": {
    "id": "operator-01",
    "name": "Example Island Ferries"
  }
}
Vessels

List records

GET /v1/ferries/operators/operator-01/vessels 
{
  "data": [
    {
      "id": "vessel-01",
      "name": "Example Express",
      "type": "Speedboat"
    }
  ]
}

Get one record

GET /v1/ferries/operators/operator-01/vessels/vessel-01 
{
  "data": {
    "id": "vessel-01",
    "name": "Example Express",
    "type": "Speedboat"
  }
}
Terminals

List records

GET /v1/ferries/terminals 
{
  "data": [
    {
      "id": "terminal-01",
      "name": "Island harbour",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/ferries/terminals/terminal-01 
{
  "data": {
    "id": "terminal-01",
    "name": "Island harbour",
    "islandId": "island-01"
  }
}
Routes

List records

GET /v1/ferries/routes 
{
  "data": [
    {
      "id": "route-01",
      "from": "Example Harbour",
      "to": "Example Jetty"
    }
  ]
}

Get one record

GET /v1/ferries/routes/route-01 
{
  "data": {
    "id": "route-01",
    "from": "Example Harbour",
    "to": "Example Jetty"
  }
}
Fares

List records

GET /v1/ferries/routes/route-01/fares 
{
  "data": [
    {
      "id": "fare-01",
      "name": "One way",
      "amount": 120,
      "currency": "MVR"
    }
  ]
}

Get one record

GET /v1/ferries/routes/route-01/fares/fare-01 
{
  "data": {
    "id": "fare-01",
    "name": "One way",
    "amount": 120,
    "currency": "MVR"
  }
}
Departures

List records

GET /v1/ferries/routes/route-01/departures 
{
  "data": [
    {
      "id": "trip-01",
      "localTime": "08:30",
      "timeZone": "Indian/Maldives"
    }
  ]
}

Get one record

GET /v1/ferries/routes/route-01/departures/trip-01 
{
  "data": {
    "id": "trip-01",
    "localTime": "08:30",
    "timeZone": "Indian/Maldives"
  }
}

Food

Browse restaurants, menu categories, dishes and item options.

Restaurants

List records

GET /v1/food/restaurants 
{
  "data": [
    {
      "id": "restaurant-01",
      "name": "Example Café",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/food/restaurants/restaurant-01 
{
  "data": {
    "id": "restaurant-01",
    "name": "Example Café",
    "islandId": "island-01"
  }
}
Menu categories

List records

GET /v1/food/restaurants/restaurant-01/categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Breakfast"
    }
  ]
}

Get one record

GET /v1/food/restaurants/restaurant-01/categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Breakfast"
  }
}
Menu items

List records

GET /v1/food/restaurants/restaurant-01/menu 
{
  "data": [
    {
      "id": "item-01",
      "name": "Mas huni",
      "price": 45,
      "currency": "MVR"
    }
  ]
}

Get one record

GET /v1/food/restaurants/restaurant-01/menu/item-01 
{
  "data": {
    "id": "item-01",
    "name": "Mas huni",
    "price": 45,
    "currency": "MVR"
  }
}
Fulfilment options

List records

GET /v1/food/restaurants/restaurant-01/fulfilment-options 
{
  "data": [
    {
      "id": "pickup",
      "name": "Pickup"
    }
  ]
}

Get one record

GET /v1/food/restaurants/restaurant-01/fulfilment-options/pickup 
{
  "data": {
    "id": "pickup",
    "name": "Pickup"
  }
}
Item options

List records

GET /v1/food/menu-items/item-01/options 
{
  "data": [
    {
      "id": "option-01",
      "name": "Extra roshi"
    }
  ]
}

Get one record

GET /v1/food/menu-items/item-01/options/option-01 
{
  "data": {
    "id": "option-01",
    "name": "Extra roshi"
  }
}

Rides

Coming soon

Explore examples of vehicle classes and island service areas.

Vehicle classes

List records

GET /v1/rides/vehicle-classes 
{
  "data": [
    {
      "id": "class-01",
      "name": "Car",
      "seats": 4
    }
  ]
}

Get one record

GET /v1/rides/vehicle-classes/class-01 
{
  "data": {
    "id": "class-01",
    "name": "Car",
    "seats": 4
  }
}
Service areas

List records

GET /v1/rides/service-areas 
{
  "data": [
    {
      "id": "area-01",
      "name": "Example island zone",
      "islandId": "island-01"
    }
  ]
}

Get one record

GET /v1/rides/service-areas/area-01 
{
  "data": {
    "id": "area-01",
    "name": "Example island zone",
    "islandId": "island-01"
  }
}

Bill Payments

Coming soon

Explore a sample directory of billers and bill categories.

Biller categories

List records

GET /v1/bill-payments/categories 
{
  "data": [
    {
      "id": "category-01",
      "name": "Utilities"
    }
  ]
}

Get one record

GET /v1/bill-payments/categories/category-01 
{
  "data": {
    "id": "category-01",
    "name": "Utilities"
  }
}
Billers

List records

GET /v1/bill-payments/billers 
{
  "data": [
    {
      "id": "biller-01",
      "name": "Example Utility",
      "categoryId": "category-01"
    }
  ]
}

Get one record

GET /v1/bill-payments/billers/biller-01 
{
  "data": {
    "id": "biller-01",
    "name": "Example Utility",
    "categoryId": "category-01"
  }
}

Wallet

Coming soon

Look up sample currency codes and transaction type definitions.

Currencies

List records

GET /v1/wallet/currencies 
{
  "data": [
    {
      "id": "MVR",
      "name": "Maldivian rufiyaa"
    }
  ]
}

Get one record

GET /v1/wallet/currencies/MVR 
{
  "data": {
    "id": "MVR",
    "name": "Maldivian rufiyaa"
  }
}
Transaction types

List records

GET /v1/wallet/transaction-types 
{
  "data": [
    {
      "id": "type-01",
      "name": "Top-up"
    }
  ]
}

Get one record

GET /v1/wallet/transaction-types/type-01 
{
  "data": {
    "id": "type-01",
    "name": "Top-up"
  }
}
Register API interest →

What could your
business do better?

Tell us how you work. We’ll help you find the right digital setup.

Discuss your business