# SingaNow API & Data Specification

> Real-Time Singapore Live Intelligence Dashboard, Public Transit, Weather, Environment, Traffic Cameras, Carpark Availability, and ACRA Corporate Registry API.

SingaNow provides high-speed, CORS-friendly, unauthenticated REST JSON APIs providing real-time data across Singapore government and municipal datasets. All endpoints return standard JSON encoded in UTF-8.

- API Base URL: `https://singanow.com/api`
- Extended Technical Documentation & Tool Calling Schemas: [https://singanow.com/llms-full.txt](https://singanow.com/llms-full.txt)
- Interactive Web Documentation: [https://singanow.com/docs](https://singanow.com/docs)
- Protocol: HTTPS GET
- Authentication: None required for public endpoints
- Default Response Format: JSON (`Content-Type: application/json; charset=UTF-8`)
- Timezone: `Asia/Singapore` (SGT / UTC+8)
- Geographic Bounding Box: Latitude `1.15` to `1.48` °N, Longitude `103.58` to `104.05` °E

---

## AI Agent Integration Guidelines

When building LLM agents, OpenAI GPT actions, Claude Tools, Gemini Function Calling, or MCP (Model Context Protocol) servers:
1. **Coordinate Queries**: Coordinates must be within Singapore bounds (approx. `1.15`–`1.48` lat, `103.58`–`104.05` lng). For users outside Singapore, the nearby bus stop API will automatically provide central Singapore reference data.
2. **Bus Stop Codes**: Always 5-digit zero-padded strings (e.g., `'01012'`, `'09048'`, `'67009'`). Do not convert to integers.
3. **Bus Service Numbers**: Alphanumeric strings (e.g., `'10'`, `'65'`, `'190'`, `'960e'`, `'NR1'`).
4. **UEN (Unique Entity Number)**: 9 or 10-character identifiers for Singapore registered entities (e.g. `'201812345A'`, `'53123456B'`, `'T08LL0001B'`).
5. **Bus Crowd Load Codes**:
   - `SEA` = Seats Available (Green / Low crowding)
   - `SDA` = Standing Available (Orange / Moderate crowding)
   - `LSD` = Limited Standing (Red / High crowding)
6. **Bus Type Codes**:
   - `SD` = Single Deck Bus
   - `DD` = Double Deck Bus
   - `BD` = Bendy / Articulated Bus
7. **Accessibility**:
   - `is_wab: true` or `Feature: "WAB"` indicates Wheelchair Accessible Bus.

---

## API Endpoints Summary

### 1. Public Bus Transport

- [Bus Arrival API](https://singanow.com/api/bus/arrival): Real-time live arrival countdowns, passenger capacity loads, wheelchair accessibility, and next 3 arriving buses for any bus stop.
  - Endpoint: `GET /api/bus/arrival?stop={bus_stop_code}&service={service_no}`
  - Parameters:
    - `stop` (string, required): 5-digit bus stop code (e.g. `01012` for Victoria St - Hotel Grand Pacific).
    - `service` (string, optional): Specific bus service number to filter (e.g. `190`, `10`, `65`).
    - `refresh` (boolean, optional): Set to `1` or `true` to bypass cache and fetch latest LTA DataMall feed.
  - Example: `https://singanow.com/api/bus/arrival?stop=01012`

- [Bus Services API](https://singanow.com/api/bus/services): All registered public bus services in Singapore, operators, origin, destination, operating hours, and frequencies.
  - Endpoint: `GET /api/bus/services?service={service_no}&operator={operator}&category={category}&q={query}`
  - Parameters:
    - `service` (string, optional): Look up a single service and return full route stops for Direction 1 and 2 (e.g. `190`).
    - `operator` (string, optional): Filter by operator: `SBST` (SBS Transit), `SMRT` (SMRT Buses), `TTS` (Tower Transit), `GAS` (Go-Ahead Singapore).
    - `category` (string, optional): `TRUNK`, `FEEDER`, `EXPRESS`, `INDUSTRIAL`, `NIGHT SERVICE`.
    - `q` (string, optional): Search service number or terminal/interchange name.
  - Example: `https://singanow.com/api/bus/services?service=190`

- [Bus Stops API](https://singanow.com/api/bus/stops): Search or retrieve metadata for over 5,200 Singapore bus stops.
  - Endpoint: `GET /api/bus/stops?code={stop_code}&q={query}&limit={limit}`
  - Parameters:
    - `code` (string, optional): Direct 5-digit bus stop code lookup (returns single stop with full calling bus services).
    - `q` (string, optional): Search keyword matching bus stop code, description, or road name (e.g. `Orchard`, `Bedok`, `Victoria`).
    - `limit` (integer, optional, default: 30, max: 100): Result limit.
  - Example: `https://singanow.com/api/bus/stops?q=Orchard`

- [Bus Routes API](https://singanow.com/api/bus/routes): Sequential list of stops, distance in kilometers, operating hours, and scheduled intervals for a given bus service and direction.
  - Endpoint: `GET /api/bus/routes?service={service_no}&dir={direction}`
  - Parameters:
    - `service` (string, required): Bus service number (e.g. `14`, `190`, `960`).
    - `dir` (integer, optional, default: 1): Direction `1` (outbound) or `2` (inbound / return).
  - Example: `https://singanow.com/api/bus/routes?service=190&dir=1`

- [Nearby Bus Stops API](https://singanow.com/api/bus/nearby): Find nearest bus stops from any GPS coordinate within walking distance.
  - Endpoint: `GET /api/bus/nearby?lat={latitude}&lng={longitude}&radius={radius_km}&limit={limit}`
  - Parameters:
    - `lat` (float, required): WGS84 Latitude in Singapore (e.g. `1.2968`).
    - `lng` (float, required): WGS84 Longitude in Singapore (e.g. `103.8525`).
    - `radius` (float, optional, default: 1.2, max: 10.0): Search radius in kilometers.
    - `limit` (integer, optional, default: 20, max: 50): Max bus stops to return.
  - Example: `https://singanow.com/api/bus/nearby?lat=1.2968&lng=103.8525`

- [Planned Bus Changes API](https://singanow.com/api/bus/planned): Scheduled upcoming bus route diversions, additions, and network adjustments.
  - Endpoint: `GET /api/bus/planned`
  - Example: `https://singanow.com/api/bus/planned`

---

### 2. Weather & Environment

- [Live Weather API](https://singanow.com/api/weather): Real-time 2-hour regional area forecast (47 town locations), 24-hour national forecast, 4-day outlook, and live climate station readings (temperature, humidity, wind, rainfall).
  - Endpoint: `GET /api/weather`
  - Response Data:
    - `forecast_2h.regions`: Array of area nowcasts with standardized icon tags (`sunny`, `cloudy`, `rain`, `showers`, `thunderstorm`, etc.).
    - `forecast_24h`: Overall 24-hour forecast, temperature range (°C), humidity (%), wind speed (km/h) and direction, plus 3 sub-day periods.
    - `outlook_4d`: 4-day daily weather projections with temperature and humidity ranges.
    - `stations`: Real-time weather stations reporting live temperature (°C), relative humidity (%), wind speed (knots), and rainfall (mm).
  - Example: `https://singanow.com/api/weather`

- [Air Quality & UV Index API](https://singanow.com/api/environment): 24-hour Pollutant Standards Index (PSI), 1-hour PM2.5 concentrations across 5 Singapore regions (North, South, East, West, Central), and hourly UV index readings.
  - Endpoint: `GET /api/environment`
  - Response Data:
    - `psi.regions`: Regional 24-hour PSI values, category rating (`Good`, `Moderate`, `Unhealthy`, `Very Unhealthy`, `Hazardous`), and color code.
    - `pm25.regions`: 1-hour PM2.5 readings (µg/m³) across North, South, East, West, Central.
    - `uv`: Current UV index value, category rating (`Low`, `Moderate`, `High`, `Very High`, `Extreme`), and hourly trend history.
  - Example: `https://singanow.com/api/environment`

---

### 3. Traffic Cameras & Carpark Availability

- [Live Traffic Cameras API](https://singanow.com/api/traffic): High-definition live LTA traffic camera feeds across major expressways (PIE, CTE, AYE, BKE, ECP, SLE, KJE, TPE, MCE) and Malaysia border crossings (Woodlands Causeway, Tuas Second Link).
  - Endpoint: `GET /api/traffic`
  - Response Data:
    - `categories`: Grouped camera objects containing `id`, `label`, `description`, `imageUrl` (live high-res camera snapshot JPEG), `timestamp`, `lat`, and `lon`.
  - Example: `https://singanow.com/api/traffic`

- [Carpark Availability & Nearby API](https://singanow.com/api/carparks): Real-time lot availability, GPS distance calculations, and parking vacancy across 2,600+ HDB, LTA (shopping malls & commercial hubs), and URA carparks in Singapore.
  - Endpoint: `GET /api/carparks?lat={lat}&lng={lng}&radius={radius}&query={query}&agency={agency}&lot_type={lot_type}&page={page}`
  - Parameters:
    - `lat` (float, optional): User GPS latitude for distance sorting.
    - `lng` (float, optional): User GPS longitude for distance sorting.
    - `radius` (float, optional, default: 1.5): Search radius in km (0.1 to 15.0 km).
    - `query` (string, optional): Filter carpark by code (e.g. `ACB`, `BA12`), development name (e.g. `Suntec`, `Orchard`), or area.
    - `agency` (string, optional, default: `ALL`): Filter by agency (`ALL`, `HDB`, `LTA`, `URA`).
    - `lot_type` (string, optional, default: `ALL`): Filter by vehicle type (`ALL`, `C` for cars, `Y` for motorcycles, `H` for heavy).
    - `page` (integer, optional, default: 1): Pagination page number.
  - Response Data:
    - `summary`: Total monitored lots, total available lots, and nationwide vacancy percentage.
    - `carparks`: List of carparks with `id`, `name` (development/address), `area`, `agency`, `lat`, `lng`, `distance_km`, `distance_m`, `lots`, `available`, `pct` (occupancy percentage), `status` (`Available`, `Limited`, `Full`), `color`, and `lot_types` breakdown.
  - Example: `https://singanow.com/api/carparks?lat=1.2938&lng=103.8532&radius=1.5`

- [EV Charging Points & Availability API](https://singanow.com/api/ev): Real-time EV charger directory and live plug availability across SP Mobility, CDG ENGIE, Charge+, Shell Recharge, Tesla Superchargers, and HDB hubs in Singapore.
  - Endpoint: `GET /api/ev?lat={lat}&lng={lng}&radius={radius}&query={query}&operator={operator}&speed={speed}&connector={connector}&page={page}`
  - Parameters:
    - `lat` (float, optional): User GPS latitude for distance sorting.
    - `lng` (float, optional): User GPS longitude for distance sorting.
    - `radius` (float, optional, default: 2.5): Search radius in km (0.1 to 25.0 km).
    - `query` (string, optional): Search station name, mall, estate, operator, or postal code.
    - `operator` (string, optional, default: `ALL`): `ALL`, `SP_MOBILITY`, `CDG_ENGIE`, `CHARGE_PLUS`, `SHELL`, `TESLA`, `KEPPEL_VOLT`, `TOTALENERGIES`.
    - `speed` (string, optional, default: `ALL`): `ALL`, `ULTRA_FAST` (≥120kW), `FAST_DC` (50-100kW), `AC_NORMAL` (7.4-22kW).
    - `connector` (string, optional, default: `ALL`): `ALL`, `CCS2`, `TYPE2`, `TESLA`.
    - `page` (integer, optional, default: 1): Pagination page number.
  - Response Data:
    - `summary`: Total stations, total plugs, available plugs count, overall occupancy percentage, fast DC & ultra-fast count.
    - `stations`: List of EV stations with `id`, `name`, `address`, `area`, `operator`, `lat`, `lng`, `distance_km`, `distance_m`, `total_plugs`, `available`, `status`, `color`, `pct`, `max_speed_kw`, `has_ultra_fast`, `plugs`, `pricing_ac`, `pricing_dc`, and `parking_info`.
  - Example: `https://singanow.com/api/ev?query=Orchard`

---

### 4. ACRA Corporate Registry & UEN Search

- [ACRA Search API](https://singanow.com/api/acra): Instant UEN lookup and corporate entity validation across 2.1+ million registered Singapore companies, businesses, LLPs, societies, and healthcare institutions.
  - Endpoint: `GET /api/acra?q={query}&page={page}`
  - Parameters:
    - `q` or `query` (string, required): Company/Entity name or UEN (e.g. `DBS`, `Singtel`, `201400001A`, `Grab`). Multi-word searches automatically supported with intelligent relevance ranking.
    - `page` (integer, optional, default: 1): Page number (24 entities per page).
  - Response Data:
    - `entities`: Array of corporate entities containing `uen`, `name`, `type`, `status` (`Live`, `Struck Off`, etc.), `agency` (`ACRA`, `ROS`, `MOH`, `MAS`), `issue_date`, `full_address`, `ssic_primary` (`code`, `description`, `user_desc`), `ssic_secondary`, `constitution`, `filing` dates, `former_names`, and `audit_firms`.
  - Example: `https://singanow.com/api/acra?q=Singtel`

---

## Web Pages & User Interfaces

- [SingaNow Live Dashboard](https://singanow.com/): Real-time unified Singapore dashboard with weather, air quality, traffic cameras, and carparks.
- [EV Charging Points Portal](https://singanow.com/ev): Real-time EV charging station directory and live plug availability across Singapore.
- [EV Charging Nearby GPS Finder](https://singanow.com/ev/nearby): Find nearest available EV chargers from current location.
- [Parking Availability Portal](https://singanow.com/carparks): Real-time parking lot availability across 2,600+ HDB, commercial, and URA carparks.
- [Bus Commuter Portal](https://singanow.com/bus): Live bus arrival countdowns, bus stop search, and route sequence timetables.
- [Bus Nearby GPS Finder](https://singanow.com/bus/nearby): Find nearest bus stops from current location.
- [Bus Route Explorer](https://singanow.com/bus/routes): Complete ordered stop sequences and route maps for all Singapore bus lines.
- [ACRA Singapore UEN Directory](https://singanow.com/acra): Web search interface for registered Singapore corporate entities.
- [API Documentation & Playground](https://singanow.com/docs): Interactive developer documentation, playground console, and code snippets.
- [About SingaNow](https://singanow.com/about): System architecture, mission, open data attribution, and engineering values.
- [Legal & Open Data Attribution](https://singanow.com/legal): Terms of service, statutory board attribution, and Singapore Open Data Licence info.

---

## Optional & Crawler Resources

- [Comprehensive LLM & MCP Specification (llms-full.txt)](https://singanow.com/llms-full.txt): Complete tool definitions, JSON schemas, cURL examples, and field enums.
- [XML Sitemap](https://singanow.com/sitemap.xml): Machine-readable sitemap of all public routes.
- [Robots.txt](https://singanow.com/robots.txt): Crawler permissions and guidelines.