API & AI Integration Reference

⚡ Overview & Base URL

All SingaNow APIs are served over HTTPS, return UTF-8 JSON payloads with standard HTTP response status codes, and allow cross-origin requests (CORS). No API keys or registration tokens are required for public endpoints.

Copy-paste ready tool definitions compatible with OpenAI Function Calling, Anthropic Claude Tools, Google Gemini, LangChain, and MCP servers:

[
  {
    "type": "function",
    "function": {
      "name": "get_singapore_bus_arrivals",
      "description": "Fetch real-time bus arrivals, passenger crowding (SEA/SDA/LSD), and wheelchair accessibility for a specific 5-digit Singapore bus stop code.",
      "parameters": {
        "type": "object",
        "properties": {
          "bus_stop_code": {
            "type": "string",
            "description": "The 5-digit bus stop code in Singapore (e.g. '01012', '09048')."
          },
          "service_no": {
            "type": "string",
            "description": "Optional service number to filter (e.g. '190', '10', '65')."
          }
        },
        "required": ["bus_stop_code"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "find_nearby_singapore_bus_stops",
      "description": "Locate the nearest bus stops and walking distances in kilometers from GPS coordinates in Singapore.",
      "parameters": {
        "type": "object",
        "properties": {
          "latitude": { "type": "number", "description": "WGS84 Latitude (1.15 - 1.48)." },
          "longitude": { "type": "number", "description": "WGS84 Longitude (103.58 - 104.05)." },
          "radius_km": { "type": "number", "description": "Search radius in km (default: 1.2)." }
        },
        "required": ["latitude", "longitude"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "search_singapore_bus_stops",
      "description": "Search Singapore bus stops by road name, landmark name, or 5-digit stop code.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Search keyword (e.g. 'Orchard', 'Bedok', 'Victoria', '01012')." }
        },
        "required": ["query"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_carpark_availability",
      "description": "Check real-time parking lot vacancy, GPS distance, and available lots across 2,600+ HDB, URA, and LTA commercial shopping mall carparks in Singapore.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Carpark code, mall/development name (e.g. 'Suntec', 'Orchard'), or area." },
          "lat": { "type": "number", "description": "Optional user GPS latitude for distance sorting." },
          "lng": { "type": "number", "description": "Optional user GPS longitude for distance sorting." },
          "radius": { "type": "number", "description": "Search radius in km (default: 1.5)." }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_ev_charging_points",
      "description": "Search real-time EV charging stations and live plug availability across SP Mobility, CDG ENGIE, Charge+, Shell Recharge, Tesla Superchargers, and HDB hubs in Singapore.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Station name, shopping mall, operator, or 6-digit postal code (e.g. 'Orchard', 'Tesla', '529510')." },
          "operator": { "type": "string", "description": "Filter operator ('ALL', 'SP_MOBILITY', 'CDG_ENGIE', 'CHARGE_PLUS', 'SHELL', 'TESLA', 'KEPPEL_VOLT', 'TOTALENERGIES')." },
          "speed": { "type": "string", "description": "Filter speed ('ALL', 'ULTRA_FAST' >=120kW, 'FAST_DC' 50-100kW, 'AC_NORMAL' 7.4-22kW)." },
          "lat": { "type": "number", "description": "Optional GPS latitude for distance ranking." },
          "lng": { "type": "number", "description": "Optional GPS longitude for distance ranking." }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_weather",
      "description": "Retrieve live Singapore 2-hour regional area forecast (47 towns), 24-hour national forecast, 4-day outlook, and live climate station readings (temperature, rainfall, humidity).",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_environment_air_quality",
      "description": "Get real-time Singapore 24-hour PSI air quality, 1-hour PM2.5 readings, and hourly UV index by region.",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_traffic_cameras",
      "description": "Get live traffic camera image snapshot URLs for Singapore expressways (PIE, CTE, AYE, etc.) and Malaysia border checkpoints (Woodlands Causeway, Tuas).",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "search_singapore_acra_entity",
      "description": "Search Singapore registered corporate entities, companies, LLPs, and societies by company name or UEN.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Entity name or UEN (e.g. 'DBS Bank', 'Grab', '201812345A')." },
          "page": { "type": "integer", "description": "Page number (default: 1)." }
        },
        "required": ["query"]
      }
    }
  }
]

💻 Code Integration Examples

// Modern TypeScript / JavaScript Fetch Examples
const BASE_URL = "https://singanow.com/api";

// 1. Fetch Real-Time Bus Arrivals
async function getBusArrivals(busStopCode: string, serviceNo?: string) {
  const url = new URL(`${BASE_URL}/bus/arrival`);
  url.searchParams.set("stop", busStopCode);
  if (serviceNo) url.searchParams.set("service", serviceNo);
  const res = await fetch(url.toString());
  return res.json();
}

// 2. Fetch Live EV Charging Stations
async function getEVStations(query = "Orchard", operator = "ALL") {
  const url = new URL(`${BASE_URL}/ev`);
  if (query) url.searchParams.set("query", query);
  if (operator !== "ALL") url.searchParams.set("operator", operator);
  const res = await fetch(url.toString());
  return res.json();
}

// 3. Fetch Nearby Parking Vacancy
async function getCarparksNearGPS(lat: number, lng: number, radius = 1.5) {
  const url = new URL(`${BASE_URL}/carparks`);
  url.searchParams.set("lat", String(lat));
  url.searchParams.set("lng", String(lng));
  url.searchParams.set("radius", String(radius));
  const res = await fetch(url.toString());
  return res.json();
}

// Example usage:
const evData = await getEVStations("Orchard");
console.log(`Found ${evData.total} EV stations. Available plugs: ${evData.summary.totalAvailable}`);

import requests

BASE_URL = "https://singanow.com/api"

def get_bus_arrivals(stop_code: str, service_no: str = None):
    params = {"stop": stop_code}
    if service_no:
        params["service"] = service_no
    resp = requests.get(f"{BASE_URL}/bus/arrival", params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

def get_ev_stations(query: str = "Orchard", operator: str = "ALL"):
    params = {"query": query, "operator": operator}
    resp = requests.get(f"{BASE_URL}/ev", params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

def get_carparks(query: str = "Suntec"):
    resp = requests.get(f"{BASE_URL}/carparks", params={"query": query}, timeout=10)
    resp.raise_for_status()
    return resp.json()

def search_acra(query: str):
    resp = requests.get(f"{BASE_URL}/acra", params={"q": query}, timeout=10)
    resp.raise_for_status()
    return resp.json()

# Test
if __name__ == "__main__":
    ev = get_ev_stations("Orchard")
    print(f"Found {ev['total']} EV stations ({ev['summary']['totalAvailable']} plugs available)")
    for st in ev["stations"]:
        print(f" - {st['name']} ({st['operator_name']}): {st['available']}/{st['total_plugs']} plugs [{st['status']}]")

# 1. EV Charging Stations & Live Plug Availability
curl -s "https://singanow.com/api/ev?query=Orchard" | jq .

# 2. Carpark Lot Availability & Vacancy
curl -s "https://singanow.com/api/carparks?query=Orchard" | jq .

# 3. Live Bus Arrivals at Hotel Grand Pacific
curl -s "https://singanow.com/api/bus/arrival?stop=01012" | jq .

# 4. ACRA Corporate UEN Search
curl -s "https://singanow.com/api/acra?q=Singtel" | jq .

# 5. Live Weather & Regional Forecasts
curl -s "https://singanow.com/api/weather" | jq .

# 6. Air Quality PSI & PM2.5
curl -s "https://singanow.com/api/environment" | jq .

# 7. Nearby Bus Stops from GPS coordinates
curl -s "https://singanow.com/api/bus/nearby?lat=1.2968&lng=103.8525" | jq .